gabbe-kit 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +25 -0
- package/LICENSE-CODE +202 -0
- package/README.md +817 -0
- package/agents/AGENTS.md +542 -0
- package/agents/CONSTITUTION.md +188 -0
- package/agents/guides/00-index.md +142 -0
- package/agents/guides/ai/a2ui-protocols.md +71 -0
- package/agents/guides/ai/actor-agent-frameworks.md +82 -0
- package/agents/guides/ai/agent-communication.md +146 -0
- package/agents/guides/ai/agent-identity-trust.md +69 -0
- package/agents/guides/ai/agent-only-cognition.md +73 -0
- package/agents/guides/ai/agent-only-swarms.md +70 -0
- package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
- package/agents/guides/ai/agent-ui.md +106 -0
- package/agents/guides/ai/ai-agentic.md +309 -0
- package/agents/guides/ai/beyond-llms.md +60 -0
- package/agents/guides/ai/dynamic-capability-loading.md +121 -0
- package/agents/guides/ai/gabbe-innovations.md +111 -0
- package/agents/guides/ai/model-customization-decisions.md +78 -0
- package/agents/guides/ai/multi-agent-systems.md +85 -0
- package/agents/guides/ai/self-evolving-skills.md +137 -0
- package/agents/guides/ai/self-healing-summary.md +21 -0
- package/agents/guides/ai/visual-mcp-integration.md +106 -0
- package/agents/guides/architecture/api-standards.md +61 -0
- package/agents/guides/architecture/blockchain-dlt.md +36 -0
- package/agents/guides/architecture/critical-systems-arch.md +66 -0
- package/agents/guides/architecture/event-driven-architecture.md +39 -0
- package/agents/guides/architecture/microservices.md +292 -0
- package/agents/guides/architecture/monolith.md +303 -0
- package/agents/guides/architecture/orchestration.md +75 -0
- package/agents/guides/architecture/system-qualities.md +51 -0
- package/agents/guides/architecture/system-scalability.md +47 -0
- package/agents/guides/architecture/systems-architecture.md +506 -0
- package/agents/guides/data/semantic-web.md +23 -0
- package/agents/guides/data/sql-nosql.md +305 -0
- package/agents/guides/industry/engineering-standards.md +36 -0
- package/agents/guides/industry/global-standards.md +24 -0
- package/agents/guides/industry/healthcare-fhir.md +33 -0
- package/agents/guides/industry/industrial-iot.md +33 -0
- package/agents/guides/industry/telecom-networks.md +34 -0
- package/agents/guides/languages/c-sharp.md +66 -0
- package/agents/guides/languages/go-lang.md +251 -0
- package/agents/guides/languages/java.md +73 -0
- package/agents/guides/languages/js-ts-nodejs.md +361 -0
- package/agents/guides/languages/nodejs-advanced.md +56 -0
- package/agents/guides/languages/php-laravel.md +376 -0
- package/agents/guides/languages/python-fastapi-ai.md +257 -0
- package/agents/guides/languages/rust.md +73 -0
- package/agents/guides/ops/compliance-audit.md +177 -0
- package/agents/guides/ops/cost-optimization.md +57 -0
- package/agents/guides/ops/dev-environments.md +67 -0
- package/agents/guides/ops/dev-workflow.md +44 -0
- package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
- package/agents/guides/ops/production-health.md +62 -0
- package/agents/guides/ops/troubleshooting-guide.md +69 -0
- package/agents/guides/patterns/agentic-design-patterns.md +308 -0
- package/agents/guides/patterns/agentic-patterns.md +43 -0
- package/agents/guides/patterns/ai-native-scenarios.md +71 -0
- package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
- package/agents/guides/patterns/design-patterns.md +68 -0
- package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
- package/agents/guides/patterns/enterprise-patterns.md +56 -0
- package/agents/guides/patterns/software-design-patterns.md +106 -0
- package/agents/guides/patterns/time-complexity-analysis.md +116 -0
- package/agents/guides/planning/product-requirements.md +407 -0
- package/agents/guides/planning/strategic-analysis.md +98 -0
- package/agents/guides/planning/visual-product-specs.md +162 -0
- package/agents/guides/principles/clean-code-standards.md +51 -0
- package/agents/guides/principles/computing-foundations.md +87 -0
- package/agents/guides/principles/diagramming-standards.md +568 -0
- package/agents/guides/principles/evaluation-strategy.md +103 -0
- package/agents/guides/principles/future-tech.md +35 -0
- package/agents/guides/principles/human-agent-collaboration.md +54 -0
- package/agents/guides/principles/legacy-tech.md +61 -0
- package/agents/guides/principles/mathematical-foundations.md +103 -0
- package/agents/guides/principles/modeling-methods.md +97 -0
- package/agents/guides/principles/no-code-integration.md +84 -0
- package/agents/guides/principles/testing-strategy.md +97 -0
- package/agents/guides/principles/visual-design-system.md +44 -0
- package/agents/guides/processes/RARV_CYCLE.md +262 -0
- package/agents/guides/processes/extension-protocol.md +183 -0
- package/agents/guides/processes/full-system-lifecycle.md +47 -0
- package/agents/guides/processes/knowledge-integration.md +82 -0
- package/agents/guides/processes/loki-sdlc-phases.md +446 -0
- package/agents/guides/product/green-software.md +38 -0
- package/agents/guides/product/sustainability-checks.md +29 -0
- package/agents/guides/security/ai-risk-standards-map.md +98 -0
- package/agents/guides/security/api-security.md +51 -0
- package/agents/guides/security/cryptography-standards.md +38 -0
- package/agents/guides/security/privacy-data-protection.md +41 -0
- package/agents/guides/security/secure-architecture.md +43 -0
- package/agents/guides/security/threat-modeling.md +46 -0
- package/agents/memory/AUDIT_LOG.md +48 -0
- package/agents/memory/CONTINUITY.md +49 -0
- package/agents/memory/PROJECT_STATE.md +134 -0
- package/agents/memory/RESUME_POINTER.md +15 -0
- package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
- package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
- package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
- package/agents/personas/00-index.md +148 -0
- package/agents/personas/biz-compliance.md +112 -0
- package/agents/personas/biz-legal.md +131 -0
- package/agents/personas/eng-api.md +110 -0
- package/agents/personas/eng-backend.md +113 -0
- package/agents/personas/eng-data.md +50 -0
- package/agents/personas/eng-database.md +95 -0
- package/agents/personas/eng-frontend.md +75 -0
- package/agents/personas/eng-infra.md +105 -0
- package/agents/personas/eng-messaging.md +50 -0
- package/agents/personas/eng-ml.md +50 -0
- package/agents/personas/eng-mobile.md +75 -0
- package/agents/personas/eng-perf.md +90 -0
- package/agents/personas/eng-qa.md +125 -0
- package/agents/personas/eng-tooling.md +49 -0
- package/agents/personas/ops-compliance.md +109 -0
- package/agents/personas/ops-cost.md +92 -0
- package/agents/personas/ops-devops.md +85 -0
- package/agents/personas/ops-incident.md +123 -0
- package/agents/personas/ops-monitor.md +89 -0
- package/agents/personas/ops-release.md +91 -0
- package/agents/personas/ops-security.md +104 -0
- package/agents/personas/ops-sre.md +85 -0
- package/agents/personas/orch-coordinator.md +140 -0
- package/agents/personas/orch-judge.md +135 -0
- package/agents/personas/orch-planner.md +114 -0
- package/agents/personas/orch-researcher.md +165 -0
- package/agents/personas/prod-architect.md +110 -0
- package/agents/personas/prod-design.md +112 -0
- package/agents/personas/prod-ethicist.md +50 -0
- package/agents/personas/prod-integration.md +120 -0
- package/agents/personas/prod-pm.md +115 -0
- package/agents/personas/prod-product-ops.md +128 -0
- package/agents/personas/prod-research.md +49 -0
- package/agents/personas/prod-safety-engineer.md +28 -0
- package/agents/personas/prod-tech-lead.md +119 -0
- package/agents/personas/ui-design.md +81 -0
- package/agents/scripts/check_skills_docs.py +120 -0
- package/agents/scripts/compile_skills.py +284 -0
- package/agents/scripts/comprehensive_checker.py +187 -0
- package/agents/scripts/dump-context.sh +37 -0
- package/agents/scripts/eval_skills.py +268 -0
- package/agents/scripts/preflight_summary.sh +80 -0
- package/agents/scripts/report_duplicates.py +125 -0
- package/agents/scripts/setup-context.ps1 +250 -0
- package/agents/scripts/setup-context.sh +398 -0
- package/agents/scripts/state_export.sh +84 -0
- package/agents/scripts/state_import.sh +99 -0
- package/agents/scripts/validate_integrity.py +98 -0
- package/agents/scripts/validate_links.py +96 -0
- package/agents/scripts/validate_methodology_graph.py +194 -0
- package/agents/scripts/validate_skills.py +81 -0
- package/agents/scripts/verify_e2e_init_flows.py +246 -0
- package/agents/scripts/verify_setup_simulation.py +104 -0
- package/agents/scripts/verify_triggers_and_mcps.py +159 -0
- package/agents/scripts/verify_use_cases.py +498 -0
- package/agents/skills/00-index.md +322 -0
- package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
- package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
- package/agents/skills/ai/agent-communication.skill.md +36 -0
- package/agents/skills/ai/agent-ui.skill.md +31 -0
- package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
- package/agents/skills/ai/beyond-llms.skill.md +31 -0
- package/agents/skills/ai/context-engineering.skill.md +79 -0
- package/agents/skills/ai/llm-as-judge.skill.md +97 -0
- package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
- package/agents/skills/ai/rag-evaluation.skill.md +93 -0
- package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
- package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
- package/agents/skills/architecture/api-design.skill.md +92 -0
- package/agents/skills/architecture/api-standards.skill.md +31 -0
- package/agents/skills/architecture/arch-debt.skill.md +180 -0
- package/agents/skills/architecture/arch-design.skill.md +304 -0
- package/agents/skills/architecture/arch-patterns.skill.md +52 -0
- package/agents/skills/architecture/arch-review.skill.md +326 -0
- package/agents/skills/architecture/architecture-governance.skill.md +62 -0
- package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
- package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
- package/agents/skills/architecture/compatibility-design.skill.md +51 -0
- package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
- package/agents/skills/architecture/design-patterns.skill.md +59 -0
- package/agents/skills/architecture/diagramming.skill.md +380 -0
- package/agents/skills/architecture/domain-model.skill.md +294 -0
- package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
- package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
- package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
- package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
- package/agents/skills/architecture/event-governance.skill.md +55 -0
- package/agents/skills/architecture/fitness-functions.skill.md +111 -0
- package/agents/skills/architecture/graphql-schema.skill.md +64 -0
- package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
- package/agents/skills/architecture/microservices.skill.md +31 -0
- package/agents/skills/architecture/middleware-design.skill.md +59 -0
- package/agents/skills/architecture/monolith.skill.md +31 -0
- package/agents/skills/architecture/realtime-comm.skill.md +52 -0
- package/agents/skills/architecture/state-management.skill.md +72 -0
- package/agents/skills/architecture/system-qualities.skill.md +31 -0
- package/agents/skills/architecture/system-scalability.skill.md +31 -0
- package/agents/skills/architecture/systems-architecture.skill.md +31 -0
- package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
- package/agents/skills/brain/README.md +70 -0
- package/agents/skills/brain/active-inference.skill.md +74 -0
- package/agents/skills/brain/brain-mode.skill.md +125 -0
- package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
- package/agents/skills/brain/cognitive-testing.skill.md +62 -0
- package/agents/skills/brain/consciousness-loop.skill.md +68 -0
- package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
- package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
- package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
- package/agents/skills/brain/global-workspace.skill.md +77 -0
- package/agents/skills/brain/learning-adaptation.skill.md +68 -0
- package/agents/skills/brain/loki-mode.skill.md +267 -0
- package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
- package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
- package/agents/skills/brain/scripts/cognition_test.py +80 -0
- package/agents/skills/brain/scripts/global_workspace.py +104 -0
- package/agents/skills/brain/self-improvement.skill.md +80 -0
- package/agents/skills/brain/sensory-motor.skill.md +61 -0
- package/agents/skills/brain/sequential-thinking.skill.md +48 -0
- package/agents/skills/brain/working-memory.skill.md +47 -0
- package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
- package/agents/skills/coding/artisan-commands.skill.md +52 -0
- package/agents/skills/coding/browser-tdd.skill.md +131 -0
- package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
- package/agents/skills/coding/ci-autofix.skill.md +53 -0
- package/agents/skills/coding/clean-coder.skill.md +58 -0
- package/agents/skills/coding/code-review.skill.md +100 -0
- package/agents/skills/coding/debug.skill.md +100 -0
- package/agents/skills/coding/documentation.skill.md +149 -0
- package/agents/skills/coding/eval-driven-development.skill.md +107 -0
- package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
- package/agents/skills/coding/excalidraw.skill.md +90 -0
- package/agents/skills/coding/file-processing.skill.md +55 -0
- package/agents/skills/coding/git-workflow.skill.md +153 -0
- package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
- package/agents/skills/coding/mobile-dev.skill.md +41 -0
- package/agents/skills/coding/nodejs-expert.skill.md +23 -0
- package/agents/skills/coding/output-validation.skill.md +57 -0
- package/agents/skills/coding/pbt-strategy.skill.md +117 -0
- package/agents/skills/coding/performant-ai.skill.md +62 -0
- package/agents/skills/coding/performant-go.skill.md +61 -0
- package/agents/skills/coding/performant-laravel.skill.md +70 -0
- package/agents/skills/coding/performant-nodejs.skill.md +67 -0
- package/agents/skills/coding/performant-php.skill.md +53 -0
- package/agents/skills/coding/performant-python.skill.md +62 -0
- package/agents/skills/coding/refactor.skill.md +124 -0
- package/agents/skills/coding/secure-coding.skill.md +57 -0
- package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
- package/agents/skills/coding/spec-driven-development.skill.md +110 -0
- package/agents/skills/coding/tdd-cycle.skill.md +92 -0
- package/agents/skills/coding/testing-strategy.skill.md +74 -0
- package/agents/skills/coding/time-complexity.skill.md +112 -0
- package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
- package/agents/skills/coding/tool-construction.skill.md +47 -0
- package/agents/skills/coding/ui-gen.skill.md +64 -0
- package/agents/skills/coding/vibe-coding.skill.md +63 -0
- package/agents/skills/coding/visual-design.skill.md +65 -0
- package/agents/skills/coordination/agent-interop.skill.md +72 -0
- package/agents/skills/coordination/agent-protocol.skill.md +62 -0
- package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
- package/agents/skills/coordination/agentic-linter.skill.md +134 -0
- package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
- package/agents/skills/coordination/meta-optimize.skill.md +62 -0
- package/agents/skills/coordination/meta-prompting.skill.md +46 -0
- package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
- package/agents/skills/coordination/persona-selector.skill.md +78 -0
- package/agents/skills/coordination/self-optimize.skill.md +81 -0
- package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
- package/agents/skills/core/agent-analytics.skill.md +74 -0
- package/agents/skills/core/audit-trail.skill.md +122 -0
- package/agents/skills/core/clarify.skill.md +89 -0
- package/agents/skills/core/emerging-tech.skill.md +52 -0
- package/agents/skills/core/empirical-methods.skill.md +101 -0
- package/agents/skills/core/evals/clarify.eval.yaml +29 -0
- package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
- package/agents/skills/core/evals/research.eval.yaml +23 -0
- package/agents/skills/core/final-review.skill.md +66 -0
- package/agents/skills/core/integrity-check.skill.md +149 -0
- package/agents/skills/core/knowledge-connect.skill.md +77 -0
- package/agents/skills/core/knowledge-gap.skill.md +123 -0
- package/agents/skills/core/preflight.skill.md +106 -0
- package/agents/skills/core/research.skill.md +107 -0
- package/agents/skills/core/retrospective.skill.md +59 -0
- package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
- package/agents/skills/core/self-heal.skill.md +163 -0
- package/agents/skills/core/session-resume.skill.md +125 -0
- package/agents/skills/core/skills-registry.skill.md +65 -0
- package/agents/skills/core/state-portability.skill.md +89 -0
- package/agents/skills/core/state-preserve.skill.md +76 -0
- package/agents/skills/core/system-lifecycle.skill.md +51 -0
- package/agents/skills/core/update-scan.skill.md +92 -0
- package/agents/skills/data/data-engineering.skill.md +56 -0
- package/agents/skills/data/data-governance.skill.md +49 -0
- package/agents/skills/data/db-migration.skill.md +136 -0
- package/agents/skills/data/semantic-web.skill.md +28 -0
- package/agents/skills/data/sql-optimization.skill.md +78 -0
- package/agents/skills/industry/engineering-standards.skill.md +31 -0
- package/agents/skills/industry/global-standards.skill.md +30 -0
- package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
- package/agents/skills/industry/industrial-iot.skill.md +30 -0
- package/agents/skills/industry/telecom-networks.skill.md +30 -0
- package/agents/skills/ops/caching-strategy.skill.md +77 -0
- package/agents/skills/ops/capacity-planning.skill.md +67 -0
- package/agents/skills/ops/cloud-deploy.skill.md +55 -0
- package/agents/skills/ops/configuration-management.skill.md +107 -0
- package/agents/skills/ops/cost-optimization.skill.md +39 -0
- package/agents/skills/ops/decommission-sunset.skill.md +64 -0
- package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
- package/agents/skills/ops/deployment.skill.md +217 -0
- package/agents/skills/ops/dev-environments.skill.md +31 -0
- package/agents/skills/ops/dev-workflow.skill.md +28 -0
- package/agents/skills/ops/docker-dev.skill.md +52 -0
- package/agents/skills/ops/enterprise-integration.skill.md +53 -0
- package/agents/skills/ops/feature-flag-management.skill.md +59 -0
- package/agents/skills/ops/incident-response.skill.md +40 -0
- package/agents/skills/ops/infra-devops.skill.md +53 -0
- package/agents/skills/ops/k8s-dev.skill.md +51 -0
- package/agents/skills/ops/memory-optimization.skill.md +45 -0
- package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
- package/agents/skills/ops/performance-audit.skill.md +178 -0
- package/agents/skills/ops/performance-optimization.skill.md +51 -0
- package/agents/skills/ops/production-health.skill.md +85 -0
- package/agents/skills/ops/production-verifier.skill.md +50 -0
- package/agents/skills/ops/queue-management.skill.md +52 -0
- package/agents/skills/ops/release-management.skill.md +39 -0
- package/agents/skills/ops/release-validation.skill.md +51 -0
- package/agents/skills/ops/reliability-sre.skill.md +51 -0
- package/agents/skills/ops/runbook-authoring.skill.md +64 -0
- package/agents/skills/ops/system-benchmark.skill.md +69 -0
- package/agents/skills/ops/tech-debt.skill.md +143 -0
- package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
- package/agents/skills/product/accessibility.skill.md +143 -0
- package/agents/skills/product/adr-writer.skill.md +110 -0
- package/agents/skills/product/business-case.skill.md +70 -0
- package/agents/skills/product/change-management.skill.md +90 -0
- package/agents/skills/product/decompose.skill.md +75 -0
- package/agents/skills/product/design-thinking.skill.md +62 -0
- package/agents/skills/product/estimation-sizing.skill.md +87 -0
- package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
- package/agents/skills/product/financial-governance.skill.md +88 -0
- package/agents/skills/product/green-software.skill.md +46 -0
- package/agents/skills/product/ideation-facilitation.skill.md +87 -0
- package/agents/skills/product/market-analysis.skill.md +56 -0
- package/agents/skills/product/opportunity-assessment.skill.md +89 -0
- package/agents/skills/product/product-analytics.skill.md +92 -0
- package/agents/skills/product/professional-practice.skill.md +105 -0
- package/agents/skills/product/req-elicitation.skill.md +292 -0
- package/agents/skills/product/req-review.skill.md +280 -0
- package/agents/skills/product/spec-analyze.skill.md +98 -0
- package/agents/skills/product/spec-writer.skill.md +114 -0
- package/agents/skills/product/stakeholder-management.skill.md +54 -0
- package/agents/skills/product/sustainability-checks.skill.md +29 -0
- package/agents/skills/product/systems-thinking.skill.md +56 -0
- package/agents/skills/product/user-research-synthesis.skill.md +85 -0
- package/agents/skills/product/user-story-mapping.skill.md +54 -0
- package/agents/skills/product/visual-specs.skill.md +112 -0
- package/agents/skills/security/access-control.skill.md +45 -0
- package/agents/skills/security/agent-sandboxing.skill.md +69 -0
- package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
- package/agents/skills/security/ai-red-teaming.skill.md +74 -0
- package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
- package/agents/skills/security/api-security.skill.md +31 -0
- package/agents/skills/security/backup-recovery.skill.md +49 -0
- package/agents/skills/security/compliance-review.skill.md +152 -0
- package/agents/skills/security/cryptography-standards.skill.md +31 -0
- package/agents/skills/security/dependency-security.skill.md +47 -0
- package/agents/skills/security/hazard-analysis.skill.md +53 -0
- package/agents/skills/security/legal-review.skill.md +41 -0
- package/agents/skills/security/log-analysis.skill.md +68 -0
- package/agents/skills/security/network-security.skill.md +64 -0
- package/agents/skills/security/privacy-audit.skill.md +137 -0
- package/agents/skills/security/privacy-data-protection.skill.md +31 -0
- package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
- package/agents/skills/security/reliability-engineering.skill.md +47 -0
- package/agents/skills/security/safety-scan.skill.md +49 -0
- package/agents/skills/security/secrets-management.skill.md +65 -0
- package/agents/skills/security/secure-architecture.skill.md +31 -0
- package/agents/skills/security/security-audit.skill.md +164 -0
- package/agents/skills/security/threat-model.skill.md +120 -0
- package/agents/skills/security/traceability-audit.skill.md +48 -0
- package/agents/templates/00-index.md +162 -0
- package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
- package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
- package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
- package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
- package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
- package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
- package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
- package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
- package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
- package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
- package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
- package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
- package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
- package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
- package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
- package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
- package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
- package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
- package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
- package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
- package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
- package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
- package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
- package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
- package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
- package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
- package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
- package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
- package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
- package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
- package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
- package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
- package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
- package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
- package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
- package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
- package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
- package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
- package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
- package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
- package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
- package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
- package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
- package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
- package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
- package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
- package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
- package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
- package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
- package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
- package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
- package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
- package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
- package/agents/templates/core/SDLC_TRACKER.md +217 -0
- package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
- package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
- package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
- package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
- package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
- package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
- package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
- package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
- package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
- package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
- package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
- package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
- package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
- package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
- package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
- package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
- package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
- package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
- package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
- package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
- package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
- package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
- package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
- package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
- package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
- package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
- package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
- package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
- package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
- package/agents/templates/product/NFR_TEMPLATE.md +31 -0
- package/agents/templates/product/PRD_TEMPLATE.md +222 -0
- package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
- package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
- package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
- package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
- package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
- package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
- package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
- package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
- package/agents/templates/security/HAZARD_LOG.md +17 -0
- package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
- package/agents/templates/security/SAFETY_CASE.md +39 -0
- package/agents/templates/security/SAFETY_POLICY.md +25 -0
- package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
- package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
- package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
- package/bin/install.js +572 -0
- package/docs/CLI_REFERENCE.md +527 -0
- package/docs/INSTALL.md +68 -0
- package/docs/MCP_CONFIGURATIONS.md +1765 -0
- package/docs/PLATFORM_CONTROLS.md +324 -0
- package/docs/POST_INSTALL.md +75 -0
- package/docs/QUICK_COMMANDS.md +131 -0
- package/docs/QUICK_GUIDE.md +914 -0
- package/docs/README_FULL.md +1451 -0
- package/docs/SCHEMA.md +164 -0
- package/docs/V1_RELEASE_CHECKLIST.md +144 -0
- package/docs/VERIFICATION_GUIDE.md +283 -0
- package/docs/adr/0001-record-architecture-decisions.md +26 -0
- package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
- package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
- package/docs/assets/GABBE.png +0 -0
- package/docs/gabbe.config.example.json +9 -0
- package/docs/reports/duplication-report.md +30 -0
- package/install.ps1 +90 -0
- package/install.sh +89 -0
- package/package.json +49 -0
- package/scripts/init.py +1036 -0
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Cost Optimization Report
|
|
2
|
+
**Date:** [YYYY-MM-DD]
|
|
3
|
+
**Scope:** [AWS/GCP/Azure/All]
|
|
4
|
+
**Reviewer:** [Agent Name]
|
|
5
|
+
|
|
6
|
+
## Executive Summary
|
|
7
|
+
| Total Spend/Month | Estimated Waste | Potential Savings | ROI |
|
|
8
|
+
|---|---|---|---|
|
|
9
|
+
| $X,XXX | $XXX | $XXX | X% |
|
|
10
|
+
|
|
11
|
+
## 1. Idle Resources (Immediate Action)
|
|
12
|
+
These resources are running but unused (CPU < 5% for 7 days).
|
|
13
|
+
|
|
14
|
+
| Resource ID | Service | Cost/Month | Recommendation | Savings |
|
|
15
|
+
|---|---|---|---|---|
|
|
16
|
+
| `i-0123456789` | EC2 | $45.00 | Terminate | $45.00 |
|
|
17
|
+
| `vol-0987654` | EBS | $12.00 | Snapshot & Delete | $11.50 |
|
|
18
|
+
|
|
19
|
+
## 2. Over-Provisioned Resources
|
|
20
|
+
These resources are used, but larger than necessary.
|
|
21
|
+
|
|
22
|
+
| Resource ID | Service | Current Size | utilization | Recommended Size | Savings |
|
|
23
|
+
|---|---|---|---|---|---|
|
|
24
|
+
| `db-prod-01` | RDS | db.r5.2xlarge | 12% Max CPU | db.r5.large | $350.00 |
|
|
25
|
+
|
|
26
|
+
## 3. Storage Optimization
|
|
27
|
+
Data that can be moved to colder storage.
|
|
28
|
+
|
|
29
|
+
| Bucket Name | Total Size | Current Class | Recommendation | Est. Savings |
|
|
30
|
+
|---|---|---|---|---|
|
|
31
|
+
| `logs-2023` | 5 TB | Standard | Glacier Deep Archive | $110.00 |
|
|
32
|
+
|
|
33
|
+
## 4. Architecture Modernization (Long Term)
|
|
34
|
+
- Switch [Service A] to Lambda/Serverless?
|
|
35
|
+
- Use Spot Instances for [Workload B]?
|
|
36
|
+
|
|
37
|
+
## Action Plan
|
|
38
|
+
1. [ ] Terminate idle resources (Risk: Low)
|
|
39
|
+
2. [ ] Resize RDS instance (Risk: Medium - requires maintenance window)
|
|
40
|
+
3. [ ] Apply Lifecycle Policy to S3 buckets (Risk: Low)
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Decommission / Sunset Plan: [Service / Product Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Owner:** [name or team]
|
|
5
|
+
**Approver:** [name]
|
|
6
|
+
**Status:** Draft | Approved | In progress | Complete
|
|
7
|
+
|
|
8
|
+
<!-- Sunsetting is a project, not an afterthought. Plan the wind-down with the
|
|
9
|
+
same rigor as a launch. Communicate early; remove last. -->
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Summary
|
|
14
|
+
|
|
15
|
+
**What is being decommissioned:** [System and its scope.]
|
|
16
|
+
**Why:** [Reason — replaced by X / low usage / cost / risk.]
|
|
17
|
+
**Replacement (if any):** [Where users go instead.]
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 2. Deprecation Timeline
|
|
22
|
+
|
|
23
|
+
| Milestone | Date | Notes |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| Announce deprecation | [YYYY-MM-DD] | [Public/internal] |
|
|
26
|
+
| Feature freeze (no new signups) | [ ] | [ ] |
|
|
27
|
+
| Migration window opens | [ ] | [ ] |
|
|
28
|
+
| Read-only / degraded mode | [ ] | [ ] |
|
|
29
|
+
| Hard shutdown | [ ] | [ ] |
|
|
30
|
+
| Final teardown | [ ] | [ ] |
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 3. Affected Users & Communications
|
|
35
|
+
|
|
36
|
+
| Audience | Count / segment | First notice | Reminder cadence | Channel | Owner |
|
|
37
|
+
|---|---|---|---|---|---|
|
|
38
|
+
| [internal teams] | [ ] | [ ] | [e.g. T-90, T-30, T-7, T-1] | [ ] | [ ] |
|
|
39
|
+
| [external customers] | [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 4. Data: Retention, Migration, Export
|
|
44
|
+
|
|
45
|
+
| Data set | Owner | Action (migrate/export/delete) | Destination / format | Deadline |
|
|
46
|
+
|---|---|---|---|---|
|
|
47
|
+
| [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
48
|
+
|
|
49
|
+
**Self-serve export:** [How users get their own data out before shutdown.]
|
|
50
|
+
**Retention obligations:** [Legal/compliance minimums that override deletion.]
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 5. Archival
|
|
55
|
+
|
|
56
|
+
- [ ] Code repository archived (read-only) at [location].
|
|
57
|
+
- [ ] Final data snapshot stored at [location], retention [period].
|
|
58
|
+
- [ ] Documentation / runbooks archived.
|
|
59
|
+
- [ ] Configuration & secrets recorded then revoked.
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 6. License / Contract Wind-Down
|
|
64
|
+
|
|
65
|
+
| Item | Vendor / counterparty | Action | Notice required | Deadline | Owner |
|
|
66
|
+
|---|---|---|---|---|---|
|
|
67
|
+
| [SaaS subscription] | [ ] | [cancel/downgrade] | [e.g. 30d] | [ ] | [ ] |
|
|
68
|
+
| [domain / cert] | [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## 7. Traffic Drain Steps
|
|
73
|
+
|
|
74
|
+
<!-- Drain gradually so problems surface while rollback is still possible. -->
|
|
75
|
+
|
|
76
|
+
1. Redirect [X]% of traffic to replacement / error page: `[command]`
|
|
77
|
+
2. Lower DNS TTL ahead of cutover: `[command]`
|
|
78
|
+
3. Increase drain to 100%; keep service warm for rollback: `[command]`
|
|
79
|
+
4. Disable inbound; monitor for stragglers: `[command]`
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## 8. Final Teardown Checklist
|
|
84
|
+
|
|
85
|
+
- [ ] All traffic drained; zero live requests for [N] days.
|
|
86
|
+
- [ ] Compute / containers stopped and deleted.
|
|
87
|
+
- [ ] Databases snapshotted, then deprovisioned.
|
|
88
|
+
- [ ] DNS records removed.
|
|
89
|
+
- [ ] Secrets / API keys / IAM roles revoked.
|
|
90
|
+
- [ ] Monitoring, alerts, and on-call rotation removed.
|
|
91
|
+
- [ ] Billing confirmed stopped.
|
|
92
|
+
- [ ] Index/registry entries pointing at this service removed.
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 9. Post-Sunset Verification
|
|
97
|
+
|
|
98
|
+
- [ ] No traffic or errors observed in [N] days post-teardown.
|
|
99
|
+
- [ ] No orphaned cloud resources still billing (cost report checked).
|
|
100
|
+
- [ ] No broken references in dependent systems.
|
|
101
|
+
- [ ] Stakeholders notified of completion.
|
|
102
|
+
- [ ] Lessons recorded for future decommissions.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# Deployment Configuration Snippets
|
|
2
|
+
|
|
3
|
+
Copy the relevant section to your project root.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Vercel (`vercel.json`)
|
|
8
|
+
Use for frontend frameworks (Next.js, React, Vue) and Serverless Functions.
|
|
9
|
+
|
|
10
|
+
```json
|
|
11
|
+
{
|
|
12
|
+
"framework": "nextjs",
|
|
13
|
+
"buildCommand": "npm run build",
|
|
14
|
+
"outputDirectory": ".next",
|
|
15
|
+
"rewrites": [
|
|
16
|
+
{ "source": "/api/:path*", "destination": "https://api.example.com/:path*" }
|
|
17
|
+
],
|
|
18
|
+
"headers": [
|
|
19
|
+
{
|
|
20
|
+
"source": "/(.*)",
|
|
21
|
+
"headers": [
|
|
22
|
+
{ "key": "X-Content-Type-Options", "value": "nosniff" },
|
|
23
|
+
{ "key": "X-Frame-Options", "value": "DENY" }
|
|
24
|
+
]
|
|
25
|
+
}
|
|
26
|
+
],
|
|
27
|
+
"regions": ["iad1"],
|
|
28
|
+
"cleanUrls": true
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 2. Railway (`railway.toml`)
|
|
35
|
+
Use for backend services (Node, Go, Python, Docker) and Databases.
|
|
36
|
+
|
|
37
|
+
```toml
|
|
38
|
+
[build]
|
|
39
|
+
builder = "nixpacks"
|
|
40
|
+
buildCommand = "npm run build"
|
|
41
|
+
|
|
42
|
+
[deploy]
|
|
43
|
+
startCommand = "npm start"
|
|
44
|
+
healthcheckPath = "/health"
|
|
45
|
+
healthcheckTimeout = 100
|
|
46
|
+
restartPolicyType = "on-failure"
|
|
47
|
+
|
|
48
|
+
[service]
|
|
49
|
+
name = "my-backend-service"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 3. SST (`sst.config.ts`)
|
|
55
|
+
Use for AWS Serverless (Lambda, DynamoDB, API Gateway).
|
|
56
|
+
|
|
57
|
+
```typescript
|
|
58
|
+
import { SSTConfig } from "sst";
|
|
59
|
+
import { NextjsSite, Table } from "sst/constructs";
|
|
60
|
+
|
|
61
|
+
export default {
|
|
62
|
+
config(_input) {
|
|
63
|
+
return {
|
|
64
|
+
name: "my-sst-app",
|
|
65
|
+
region: "us-east-1",
|
|
66
|
+
};
|
|
67
|
+
},
|
|
68
|
+
stacks(app) {
|
|
69
|
+
app.stack(function Site({ stack }) {
|
|
70
|
+
const table = new Table(stack, "Notes", {
|
|
71
|
+
fields: {
|
|
72
|
+
pk: "string",
|
|
73
|
+
sk: "string",
|
|
74
|
+
},
|
|
75
|
+
primaryIndex: { partitionKey: "pk", sortKey: "sk" },
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
const site = new NextjsSite(stack, "site", {
|
|
79
|
+
bind: [table],
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
stack.addOutputs({
|
|
83
|
+
SiteUrl: site.url,
|
|
84
|
+
});
|
|
85
|
+
});
|
|
86
|
+
},
|
|
87
|
+
} satisfies SSTConfig;
|
|
88
|
+
```
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
# Incident Postmortem: [Incident Title]
|
|
2
|
+
|
|
3
|
+
**Date**: [YYYY-MM-DD]
|
|
4
|
+
**Authors**: [Names]
|
|
5
|
+
**Status**: [Draft / Review / Completed]
|
|
6
|
+
**Severity**: [SEV1 / SEV2 / SEV3]
|
|
7
|
+
|
|
8
|
+
## Executive Summary
|
|
9
|
+
*Briefly describe what happened, the impact (users affected), and the root cause.*
|
|
10
|
+
|
|
11
|
+
## Impact
|
|
12
|
+
- **Downtime Duration**: [HH:MM]
|
|
13
|
+
- **User Impact**: [X% of users experienced errors]
|
|
14
|
+
- **Data Impact**: [Data loss / Corruption / Latency]
|
|
15
|
+
|
|
16
|
+
## Timeline
|
|
17
|
+
| Time (UTC) | Description |
|
|
18
|
+
|---|---|
|
|
19
|
+
| 10:00 | Alert fired: High Error Rate > 5% |
|
|
20
|
+
| 10:05 | On-call Engineer acknowledged |
|
|
21
|
+
| 10:15 | Rollback initiated |
|
|
22
|
+
| 10:20 | Service recovered |
|
|
23
|
+
|
|
24
|
+
## Root Cause Analysis (5 Whys)
|
|
25
|
+
1. **Why did the system fail?** (e.g., DB CPU spiked to 100%)
|
|
26
|
+
2. **Why did the DB CPU spike?** (e.g., New deployment added a query)
|
|
27
|
+
3. **Why was the query slow?** (e.g., Missing index on `user_id`)
|
|
28
|
+
4. **Why was the index missing?** (e.g., Migration script failed but didn't error out)
|
|
29
|
+
5. **Why did the deployment proceed?** (e.g., Pipeline ignores migration warnings)
|
|
30
|
+
|
|
31
|
+
## Lessons Learned
|
|
32
|
+
- **What went well?** (e.g., Alerting was fast)
|
|
33
|
+
- **What went wrong?** (e.g., Rollback took too long)
|
|
34
|
+
- **Where did we get lucky?**
|
|
35
|
+
|
|
36
|
+
## Action Items
|
|
37
|
+
- [ ] [Fix] Add missing index to DB.
|
|
38
|
+
- [ ] [Prevent] Fail pipeline on migration warnings.
|
|
39
|
+
- [ ] [Detect] Add alert for high DB CPU.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Infrastructure Plan: [System Name]
|
|
2
|
+
|
|
3
|
+
**Status**: [Draft/Review/Approved]
|
|
4
|
+
**Cost Estimate**: [$X/month]
|
|
5
|
+
**Cloud Provider**: [AWS/GCP/Azure]
|
|
6
|
+
|
|
7
|
+
## 1. High-Level Architecture
|
|
8
|
+
[Insert Diagram Link]
|
|
9
|
+
|
|
10
|
+
## 2. Compute Strategy
|
|
11
|
+
- **Workload Type**: [Stateless Web / Batch / Stateful DB]
|
|
12
|
+
- **Service**: [EKS / Lambda / EC2 / CloudRun]
|
|
13
|
+
- **Scaling**: [HPA settings / Auto-scaling Group rules]
|
|
14
|
+
|
|
15
|
+
## 3. Data Storage
|
|
16
|
+
- **Relational**: [RDS Postgres / Cloud SQL]
|
|
17
|
+
- **NoSQL**: [DynamoDB / Firestore]
|
|
18
|
+
- **Object Storage**: [S3 / GCS]
|
|
19
|
+
- **Backup Policy**: [PITR retention period, Snapshot frequency]
|
|
20
|
+
|
|
21
|
+
## 4. Networking & Security
|
|
22
|
+
- **VPC**: [CIDR blocks, Subnet layout]
|
|
23
|
+
- **Exposure**: [Public ALB / Private Link]
|
|
24
|
+
- **WAF**: [Rulesets enabled]
|
|
25
|
+
- **IAM**: [Key roles and policies]
|
|
26
|
+
|
|
27
|
+
## 5. Observability
|
|
28
|
+
- **Logs**: [CloudWatch / Datadog]
|
|
29
|
+
- **Metrics**: [Prometheus / CloudWatch]
|
|
30
|
+
- **Tracing**: [OpenTelemetry / X-Ray]
|
|
31
|
+
|
|
32
|
+
## 6. Cost Analysis
|
|
33
|
+
| Resource | Count | Type | Est. Cost |
|
|
34
|
+
|---|---|---|---|
|
|
35
|
+
| EC2 | 2 | t3.medium | $30 |
|
|
36
|
+
| RDS | 1 | db.t3.medium | $60 |
|
|
37
|
+
| **Total** | | | **$90** |
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Release Readiness Report
|
|
2
|
+
|
|
3
|
+
**Release**: [vX.Y.Z]
|
|
4
|
+
**Date**: [YYYY-MM-DD]
|
|
5
|
+
**Decision**: [GO / NO-GO]
|
|
6
|
+
|
|
7
|
+
## 1. Executive Summary
|
|
8
|
+
- **Status**: [Green/Red]
|
|
9
|
+
- **Risks**: [Top 3 risks]
|
|
10
|
+
- **Feature Completeness**: [100%]
|
|
11
|
+
|
|
12
|
+
## 2. Gate Status
|
|
13
|
+
| Gate | Status | Notes |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| 1. Requirements | ✅ | All Traceable |
|
|
16
|
+
| 2. Architecture | ✅ | ADR-005 Approved |
|
|
17
|
+
| 3. Code Quality | ✅ | Clean Linter |
|
|
18
|
+
| 4. Tests | ✅ | 145/145 Pass |
|
|
19
|
+
| 5. Security | ⚠️ | 1 Low Sev (Accepted) |
|
|
20
|
+
| 6. Performance | ✅ | p95 < 200ms |
|
|
21
|
+
| 7. UAT / E2E | ✅ | Verified by PO |
|
|
22
|
+
|
|
23
|
+
## 3. Third-Party Validation
|
|
24
|
+
- **Penetration Test**: [Pass/Fail/Date]
|
|
25
|
+
- **Compliance Audit**: [Pass/Fail/Date]
|
|
26
|
+
|
|
27
|
+
## 4. Rollback Plan
|
|
28
|
+
- **Trigger**: Error Rate > 1% in first 10 mins.
|
|
29
|
+
- **Method**: Atomic Revert via Vercel/K8s.
|
|
30
|
+
- **Owner**: [Name]
|
|
31
|
+
|
|
32
|
+
## 5. Signatures
|
|
33
|
+
- **Product Owner**: [Sign]
|
|
34
|
+
- **Tech Lead**: [Sign]
|
|
35
|
+
- **QA Lead**: [Sign]
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Runbook: [Alert / Scenario Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Owner:** [team or on-call rotation]
|
|
5
|
+
**Last validated:** [YYYY-MM-DD]
|
|
6
|
+
**Status:** Draft | Active
|
|
7
|
+
|
|
8
|
+
<!-- A runbook is for a tired on-call engineer at 3am. Every step must be
|
|
9
|
+
copy-pasteable, unambiguous, and safe. Prefer commands over prose. -->
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. At a Glance
|
|
14
|
+
|
|
15
|
+
| Field | Value |
|
|
16
|
+
|---|---|
|
|
17
|
+
| Alert name | [Exact alert/monitor name as it fires] |
|
|
18
|
+
| Severity | [SEV1 / SEV2 / SEV3] |
|
|
19
|
+
| Service | [Affected service] |
|
|
20
|
+
| Owning team | [ ] |
|
|
21
|
+
|
|
22
|
+
**Symptom:** [What the alert is actually telling you, in plain language.]
|
|
23
|
+
|
|
24
|
+
**Impact / blast radius:** [Who and what is affected? e.g. "All checkout requests fail; ~X% of revenue at risk."]
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 2. Diagnosis
|
|
29
|
+
|
|
30
|
+
<!-- Numbered, copy-pasteable. Each step should narrow down the cause. -->
|
|
31
|
+
|
|
32
|
+
1. Confirm the alert is real (not flapping):
|
|
33
|
+
```
|
|
34
|
+
[command to check current state]
|
|
35
|
+
```
|
|
36
|
+
2. Check upstream dependency health:
|
|
37
|
+
```
|
|
38
|
+
[command]
|
|
39
|
+
```
|
|
40
|
+
3. Inspect recent deploys/changes:
|
|
41
|
+
```
|
|
42
|
+
[command]
|
|
43
|
+
```
|
|
44
|
+
4. Check error logs:
|
|
45
|
+
```
|
|
46
|
+
[command]
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**Decision point:** [How to tell which remediation path applies.]
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 3. Remediation
|
|
54
|
+
|
|
55
|
+
> Choose the path matching your diagnosis.
|
|
56
|
+
|
|
57
|
+
**Path A — [cause]:**
|
|
58
|
+
```
|
|
59
|
+
[step-by-step commands]
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
**Path B — [cause]:**
|
|
63
|
+
```
|
|
64
|
+
[step-by-step commands]
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 4. Rollback
|
|
70
|
+
|
|
71
|
+
<!-- The safe undo. When in doubt, roll back first, investigate later. -->
|
|
72
|
+
```
|
|
73
|
+
[exact rollback command(s)]
|
|
74
|
+
```
|
|
75
|
+
**Rollback verification:** [How to confirm the rollback took effect.]
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## 5. Escalation Path
|
|
80
|
+
|
|
81
|
+
| Level | Who | Contact | When to escalate |
|
|
82
|
+
|---|---|---|---|
|
|
83
|
+
| L1 | [Primary on-call] | [channel/page] | [ ] |
|
|
84
|
+
| L2 | [Service owner] | [ ] | [If not resolved in N min] |
|
|
85
|
+
| L3 | [Eng lead / incident commander] | [ ] | [SEV1 / data loss] |
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 6. Verification (Resolved)
|
|
90
|
+
|
|
91
|
+
- [ ] Alert cleared and stays cleared for [N] minutes.
|
|
92
|
+
- [ ] Key metric back within SLO: [metric + bound].
|
|
93
|
+
- [ ] No new related errors in logs.
|
|
94
|
+
- [ ] Incident notes recorded; follow-up ticket filed if needed.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## 7. Related Dashboards & Links
|
|
99
|
+
|
|
100
|
+
- **Dashboard:** [name — where to find it]
|
|
101
|
+
- **SLO / metric:** [name]
|
|
102
|
+
- **Related runbooks:** [name only]
|
|
103
|
+
- **Architecture / ADR:** [reference by name or ADR number]
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Tech Debt Backlog
|
|
2
|
+
<!-- Maintained by: tech-debt.skill | Updated: [date] -->
|
|
3
|
+
<!-- Priority: P1 (High Impact + Low Effort) | P2 (High Impact + High Effort) | P3 (Low + Low) | P4 (Low + High) -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Active Debt Items
|
|
8
|
+
|
|
9
|
+
### TD-[NNN]: [Short Title]
|
|
10
|
+
|
|
11
|
+
**Debt ID:** TD-[NNN]
|
|
12
|
+
**Type:** Code | Test | Architecture | Security | Dependency | Documentation
|
|
13
|
+
**Location:** `[file path]:[line number]`
|
|
14
|
+
**Detected:** [date] by [tech-debt.skill / code review / etc]
|
|
15
|
+
**Status:** OPEN | IN_PROGRESS | RESOLVED
|
|
16
|
+
|
|
17
|
+
**Description:**
|
|
18
|
+
[What is the debt? What is wrong with the current implementation?]
|
|
19
|
+
|
|
20
|
+
**Why it's debt:**
|
|
21
|
+
[What principle or best practice is being violated?
|
|
22
|
+
e.g., "Cyclomatic complexity is 18 — exceeds limit of 10.
|
|
23
|
+
Makes the function hard to test and modify."]
|
|
24
|
+
|
|
25
|
+
**Impact** (H/M/L): [H]
|
|
26
|
+
[How does this debt slow down development or create risk?
|
|
27
|
+
e.g., "Blocks all team members trying to add payment features.
|
|
28
|
+
Any change to this function causes unexpected failures."]
|
|
29
|
+
|
|
30
|
+
**Effort to fix** (H/M/L): [L]
|
|
31
|
+
[How much work is required to resolve this debt?
|
|
32
|
+
e.g., "Extract 3 validation functions — ~2 hours of focused work."]
|
|
33
|
+
|
|
34
|
+
**Priority:** P[1/2/3/4]
|
|
35
|
+
[P1 = High Impact + Low Effort | P2 = High Impact + High Effort
|
|
36
|
+
P3 = Low Impact + Low Effort | P4 = Low Impact + High Effort]
|
|
37
|
+
|
|
38
|
+
**Proposed fix:**
|
|
39
|
+
[Concrete approach to resolving this debt item]
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
Example:
|
|
43
|
+
1. Extract validateEmail() from UserController.update()
|
|
44
|
+
2. Extract validateAge() from UserController.update()
|
|
45
|
+
3. Extract validatePhone() from UserController.update()
|
|
46
|
+
4. Update tests to cover each extracted function independently
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**Acceptance criteria:**
|
|
50
|
+
- [ ] [Cyclomatic complexity of target function drops below 10]
|
|
51
|
+
- [ ] [All existing tests still pass]
|
|
52
|
+
- [ ] [New unit tests for each extracted function]
|
|
53
|
+
- [ ] [No new circular dependencies]
|
|
54
|
+
|
|
55
|
+
**Related PR/commit:** [link when resolved]
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Resolved Debt Items
|
|
60
|
+
|
|
61
|
+
| ID | Title | Type | Resolved Date | PR/Commit |
|
|
62
|
+
|---|---|---|---|---|
|
|
63
|
+
| TD-001 | [Example: Extracted UserValidator from Controller] | Code | [date] | [link] |
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Debt Backlog Summary
|
|
68
|
+
|
|
69
|
+
| Priority | Count | Total Effort |
|
|
70
|
+
|---|---|---|
|
|
71
|
+
| P1 (Do now) | [0] | [0h] |
|
|
72
|
+
| P2 (Plan next sprint) | [0] | [0d] |
|
|
73
|
+
| P3 (Good first issues) | [0] | [0h] |
|
|
74
|
+
| P4 (Deprioritize) | [0] | — |
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## Debt Metrics
|
|
79
|
+
|
|
80
|
+
| Metric | Current | Target | Trend |
|
|
81
|
+
|---|---|---|---|
|
|
82
|
+
| Cyclomatic complexity (max) | [X] | < 10 | [improving/stable/worsening] |
|
|
83
|
+
| Test coverage | [X]% | > 99% | [improving/stable/worsening] |
|
|
84
|
+
| Code duplication | [X]% | < 3% | [improving/stable/worsening] |
|
|
85
|
+
| TODO/FIXME count | [X] | 0 untracked | [improving/stable/worsening] |
|
|
86
|
+
| Outdated major deps | [X] | 0 | [improving/stable/worsening] |
|
|
87
|
+
|
|
88
|
+
*Last measured: [date]*
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Adding New Debt Items
|
|
93
|
+
|
|
94
|
+
Run `tech-debt.skill` to automatically scan and populate new entries.
|
|
95
|
+
Or add manually using the template above.
|
|
96
|
+
|
|
97
|
+
**Manual entry guidelines:**
|
|
98
|
+
1. Assign next sequential ID (TD-[next number])
|
|
99
|
+
2. Choose the most specific Type
|
|
100
|
+
3. Score Impact AND Effort honestly (not everything is high impact)
|
|
101
|
+
4. Propose a concrete fix (not "just refactor it")
|
|
102
|
+
5. Define testable acceptance criteria
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Business Case: [Project Name]
|
|
2
|
+
|
|
3
|
+
> **Executive Summary:** One paragraph summarizing the problem, the recommended solution, and the expected ROI.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Problem Definition (The Why)
|
|
8
|
+
|
|
9
|
+
### Current State (Status Quo)
|
|
10
|
+
* Describe the current process/system.
|
|
11
|
+
* **Metric:** What is the cost of the current state? (Time, money, risk)
|
|
12
|
+
|
|
13
|
+
### The Opportunity
|
|
14
|
+
* What happens if we solve this?
|
|
15
|
+
* Alignment with Company Goals: [Goal X], [Goal Y]
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 2. Solution Options
|
|
20
|
+
|
|
21
|
+
### Option A: Do Nothing
|
|
22
|
+
* **Pros:** Zero development cost.
|
|
23
|
+
* **Cons:** Problem persists; [Specific Con].
|
|
24
|
+
* **Cost:** $0 (but $X in ongoing pain).
|
|
25
|
+
|
|
26
|
+
### Option B: [Proposed Solution]
|
|
27
|
+
* **Description:** [Brief description]
|
|
28
|
+
* **Pros:** [Pro 1], [Pro 2].
|
|
29
|
+
* **Cons:** [Con 1].
|
|
30
|
+
* **Estimated Effort:** [X] weeks.
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 3. Financial Analysis (ROI)
|
|
35
|
+
|
|
36
|
+
| Category | Description | Estimated Value ($) |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| **Benefit** | (Revenue / Savings) | $0.00 |
|
|
39
|
+
| **Cost** | (Dev + Infra + Maint) | $0.00 |
|
|
40
|
+
| **Net Value** | (Benefit - Cost) | **$0.00** |
|
|
41
|
+
|
|
42
|
+
**Recommendation:** Proceed with Option B.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Change Management Plan (ADKAR): [Change Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Sponsor:** [executive owner]
|
|
5
|
+
**Change lead:** [name]
|
|
6
|
+
**Status:** Draft | Active | Complete
|
|
7
|
+
|
|
8
|
+
<!-- Structured on the ADKAR model: Awareness, Desire, Knowledge, Ability,
|
|
9
|
+
Reinforcement. People move through these stages in order; a stall at any
|
|
10
|
+
stage stalls the whole change. -->
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 1. Change Summary
|
|
15
|
+
|
|
16
|
+
**What is changing:** [The change, in one or two sentences.]
|
|
17
|
+
**Why now:** [Business driver.]
|
|
18
|
+
**Who is affected:** [Groups / teams.]
|
|
19
|
+
**Success looks like:** [Observable end-state.]
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 2. Stakeholder Map
|
|
24
|
+
|
|
25
|
+
| Stakeholder / group | Impact (H/M/L) | Stance (champion/neutral/resistor) | Influence | Engagement strategy |
|
|
26
|
+
|---|---|---|---|---|
|
|
27
|
+
| [group] | [ ] | [ ] | [ ] | [ ] |
|
|
28
|
+
| [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 3. ADKAR Plan
|
|
33
|
+
|
|
34
|
+
| Stage | Activities | Owner | Measure |
|
|
35
|
+
|---|---|---|---|
|
|
36
|
+
| **Awareness** (why the change) | [Comms, town halls, FAQs] | [ ] | [% who can state the why] |
|
|
37
|
+
| **Desire** (want to participate) | [Address WIIFM, involve influencers] | [ ] | [adoption intent / survey] |
|
|
38
|
+
| **Knowledge** (how to change) | [Training, docs, demos] | [ ] | [training completion] |
|
|
39
|
+
| **Ability** (do it in practice) | [Coaching, hands-on, support desk] | [ ] | [task success / error rate] |
|
|
40
|
+
| **Reinforcement** (make it stick) | [Recognition, metrics, follow-up] | [ ] | [sustained adoption over time] |
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 4. Communications Cadence
|
|
45
|
+
|
|
46
|
+
| Audience | Channel | Frequency | Message focus | Owner |
|
|
47
|
+
|---|---|---|---|---|
|
|
48
|
+
| [group] | [email/Slack/all-hands] | [ ] | [Awareness/Desire stage] | [ ] |
|
|
49
|
+
| [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 5. Training Plan
|
|
54
|
+
|
|
55
|
+
| Cohort | Format | Content | When | Owner |
|
|
56
|
+
|---|---|---|---|---|
|
|
57
|
+
| [ ] | [self-serve / live / workshop] | [ ] | [ ] | [ ] |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 6. Resistance & Risks
|
|
62
|
+
|
|
63
|
+
| Risk / source of resistance | Likelihood | Impact | Mitigation | Owner |
|
|
64
|
+
|---|---|---|---|---|
|
|
65
|
+
| [e.g. "team fears job loss"] | [ ] | [ ] | [ ] | [ ] |
|
|
66
|
+
| [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
67
|
+
|
|
68
|
+
**Escalation:** [Who handles resistance that mitigation doesn't resolve.]
|