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,162 @@
|
|
|
1
|
+
# Templates Registry — 00-index.md
|
|
2
|
+
|
|
3
|
+
> Complete catalog of all available templates.
|
|
4
|
+
> Templates = Standardized documents and configurations for consistent outputs.
|
|
5
|
+
> Usage: Agents fill these out during specific lifecycle phases.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
> **Total Templates**: 100
|
|
10
|
+
> *Registry categorized by domain.*
|
|
11
|
+
|
|
12
|
+
## Templates Registry
|
|
13
|
+
|
|
14
|
+
### 1. Coding & Development (`coding/`)
|
|
15
|
+
| Template | File | Purpose |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| Clean Code Checklist | `coding/CLEAN_CODE_CHECKLIST.md` | Pre-merge code quality gate (SOLID/DRY) |
|
|
18
|
+
| Test Plan | `coding/TEST_PLAN_TEMPLATE.md` | Master Test Plan strategy |
|
|
19
|
+
| Test Case | `coding/TEST_CASE_TEMPLATE.md` | Manual Test Case documentation |
|
|
20
|
+
| End-to-End Test Suite | `coding/E2E_TEST_SUITE_TEMPLATE.md` | Playwright/Cypress test scenarios |
|
|
21
|
+
| Dev Container | `coding/DEVCONTAINER_TEMPLATE.json` | VS Code Remote Containers config |
|
|
22
|
+
| Dev Space | `coding/DEV_SPACE_TEMPLATE.yaml` | Kubernetes dev environment |
|
|
23
|
+
| Design Tokens | `coding/DESIGN_TOKENS_TEMPLATE.json` | UI Design colors/typography |
|
|
24
|
+
| Time Complexity Report | `coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md` | Big-O analysis and hotspot tracking |
|
|
25
|
+
| Sketch-to-Diagram Report | `coding/SKETCH_TO_DIAGRAM_TEMPLATE.md` | Hand-drawn sketch recognition output |
|
|
26
|
+
| Eval Plan | `coding/EVAL_PLAN_TEMPLATE.md` | Offline eval suite plan (golden dataset + assertion tiers) |
|
|
27
|
+
| Golden Dataset | `coding/GOLDEN_DATASET_TEMPLATE.md` | Promptfoo-compatible eval cases + assertions |
|
|
28
|
+
| Eval Rubric | `coding/EVAL_RUBRIC_TEMPLATE.md` | LLM-as-judge scoring rubric + debiasing checklist |
|
|
29
|
+
| Property Test Checklist | `coding/PROPERTY_TEST_CHECKLIST.md` | PBT + metamorphic test readiness checklist |
|
|
30
|
+
|
|
31
|
+
### 2. Architecture & Design (`architecture/`)
|
|
32
|
+
| Template | File | Purpose |
|
|
33
|
+
|---|---|---|
|
|
34
|
+
| ADR | `architecture/ADR_TEMPLATE.md` | Architecture Decision Record |
|
|
35
|
+
| Decision Matrix | `architecture/ARCH_DECISION_FRAMEWORK.md` | Critical decision matrix |
|
|
36
|
+
| Fitness Functions | `architecture/FITNESS_FUNCTION_TEMPLATE.md` | Evolutionary-architecture fitness functions |
|
|
37
|
+
| ADD Workbook | `architecture/ADD_WORKBOOK_TEMPLATE.md` | Attribute-Driven Design 3.0 workbook |
|
|
38
|
+
| Architecture Decision Matrix | `architecture/ARCHITECTURE_DECISION_MATRIX.md` | Comparing 3+ options (weighted) |
|
|
39
|
+
| Architecture Review | `architecture/ARCHITECTURE_REVIEW_TEMPLATE.md` | Structured architecture audit |
|
|
40
|
+
| Architecture Views | `architecture/ARCHITECTURE_VIEWS_TEMPLATE.md` | C4/UML View documentation |
|
|
41
|
+
| C4 Architecture | `architecture/C4_ARCHITECTURE_TEMPLATE.md` | C4 Container/Component diagrams |
|
|
42
|
+
| Domain Model | `architecture/DOMAIN_MODEL_TEMPLATE.md` | DDD Entity & Relationship map |
|
|
43
|
+
| Context Map | `architecture/CONTEXT_MAP_TEMPLATE.md` | Bounded Context relationships |
|
|
44
|
+
| System Context | `architecture/SYSTEM_CONTEXT_TEMPLATE.md` | High-level system dependencies |
|
|
45
|
+
| Integration Spec | `architecture/INTEGRATION_SPEC_TEMPLATE.md` | API/Service integration details |
|
|
46
|
+
| Adaptive System | `architecture/ADAPTIVE_SYSTEM_TEMPLATE.md` | Reliability/Resilience patterns |
|
|
47
|
+
| Capability Map | `architecture/CAPABILITY_MAP_TEMPLATE.md` | Business Capability mapping |
|
|
48
|
+
| Legacy Audit | `architecture/LEGACY_AUDIT_TEMPLATE.md` | Mainframe/Legacy system analysis |
|
|
49
|
+
| Quality Attributes | `architecture/QUALITY_ATTRIBUTES_TEMPLATE.md` | NFR Definitions (SLAs/SLOs) |
|
|
50
|
+
| Pattern Usage | `architecture/DESIGN_PATTERN_USAGE.md` | Pattern Justification |
|
|
51
|
+
| Scalability Analysis | `architecture/SCALABILITY_ANALYSIS_TEMPLATE.md` | Bottleneck analysis |
|
|
52
|
+
| Smart Contract | `architecture/SMART_CONTRACT_TEMPLATE.md` | Web3 logic & Security |
|
|
53
|
+
|
|
54
|
+
### 3. Operations & SRE (`ops/`)
|
|
55
|
+
| Template | File | Purpose |
|
|
56
|
+
|---|---|---|
|
|
57
|
+
| Incident Postmortem | `ops/INCIDENT_POSTMORTEM_TEMPLATE.md` | Incident Root Cause Analysis |
|
|
58
|
+
| Runbook | `ops/RUNBOOK_TEMPLATE.md` | Operational runbook (alert → remediation) |
|
|
59
|
+
| Decommission Plan | `ops/DECOMMISSION_PLAN_TEMPLATE.md` | Sunset + data retention/migration plan |
|
|
60
|
+
| Capacity Plan | `ops/CAPACITY_PLAN_TEMPLATE.md` | Scaling & Load planning |
|
|
61
|
+
| Cost Optimization | `ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md` | FinOps analysis |
|
|
62
|
+
| Benchmark Report | `ops/BENCHMARK_REPORT_TEMPLATE.md` | System Benchmark results |
|
|
63
|
+
| Deploy Config | `ops/DEPLOY_CONFIG_TEMPLATE.md` | CI/CD Pipeline config |
|
|
64
|
+
| Infra Plan | `ops/INFRA_PLAN_TEMPLATE.md` | Terraform/Cloud formation plan |
|
|
65
|
+
| Release Readiness | `ops/RELEASE_READINESS_REPORT.md` | Go/No-Go decision record |
|
|
66
|
+
| Tech Debt Log | `ops/TECH_DEBT_TEMPLATE.md` | Debt tracking & payoff plan |
|
|
67
|
+
|
|
68
|
+
### 4. Security & Compliance (`security/`)
|
|
69
|
+
| Template | File | Purpose |
|
|
70
|
+
|---|---|---|
|
|
71
|
+
| Threat Model | `security/THREAT_MODEL_TEMPLATE.md` | STRIDE threat model |
|
|
72
|
+
| Security Checklist | `security/SECURITY_CHECKLIST.md` | Pre-release security gate |
|
|
73
|
+
| Ethical Impact | `security/ETHICAL_IMPACT_ASSESSMENT.md` | AI Ethics check |
|
|
74
|
+
| Hazard Log | `security/HAZARD_LOG.md` | Safety-critical hazard tracking |
|
|
75
|
+
| Safety Policy | `security/SAFETY_POLICY.md` | System safety constraints |
|
|
76
|
+
| Safety Case | `security/SAFETY_CASE.md` | Assurance arguments |
|
|
77
|
+
| Model Card | `security/MODEL_CARD_TEMPLATE.md` | AI model documentation (intended use, evals, limits) |
|
|
78
|
+
| Datasheet | `security/DATASHEET_TEMPLATE.md` | Dataset documentation (composition, collection, uses) |
|
|
79
|
+
| System Card | `security/SYSTEM_CARD_TEMPLATE.md` | Deployed AI-system risk/mitigation/eval card |
|
|
80
|
+
|
|
81
|
+
### 5. Product & Strategy (`product/`)
|
|
82
|
+
| Template | File | Purpose |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| PRD | `product/PRD_TEMPLATE.md` | Product Requirements (EARS) |
|
|
85
|
+
| Tech Spec | `product/SPEC_TEMPLATE.md` | Technical Specification |
|
|
86
|
+
| Experiment Plan | `product/EXPERIMENT_PLAN_TEMPLATE.md` | A/B experiment design (hypothesis, MDE, power) |
|
|
87
|
+
| Change Management Plan | `product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md` | ADKAR adoption + comms plan |
|
|
88
|
+
| User Story Map | `product/USER_STORY_MAP_TEMPLATE.md` | User Journey Mapping |
|
|
89
|
+
| Business Case | `product/BUSINESS_CASE_TEMPLATE.md` | ROI and project justification |
|
|
90
|
+
| Empathy Map | `product/EMPATHY_MAP_TEMPLATE.md` | User persona analysis |
|
|
91
|
+
| Problem Statement | `product/PROBLEM_STATEMENT_TEMPLATE.md` | User need framing |
|
|
92
|
+
| Ideation Log | `product/IDEATION_LOG_TEMPLATE.md` | Solution brainstorming log |
|
|
93
|
+
| Requirements Review | `product/REQUIREMENTS_REVIEW_TEMPLATE.md` | PRD/Spec audit |
|
|
94
|
+
| Stakeholder Register | `product/STAKEHOLDER_REGISTER_TEMPLATE.md` | RACI and stakeholder map |
|
|
95
|
+
| NFR Definition | `product/NFR_TEMPLATE.md` | Non-functional requirements |
|
|
96
|
+
| Green Software Report | `product/GREEN_SOFTWARE_REPORT_TEMPLATE.md` | Sustainability Audit |
|
|
97
|
+
| Visual Spec Package | `product/VISUAL_SPEC_PACKAGE_TEMPLATE.md` | Visual design artifacts + readiness gate |
|
|
98
|
+
|
|
99
|
+
### 6. Data & Analytics (`data/`)
|
|
100
|
+
| Template | File | Purpose |
|
|
101
|
+
|---|---|---|
|
|
102
|
+
| Data Pipeline | `data/DATA_PIPELINE_TEMPLATE.md` | ETL/ELT Design |
|
|
103
|
+
| Database Schema | `data/DATABASE_SCHEMA_TEMPLATE.md` | Physical database schema documentation |
|
|
104
|
+
| Ontology Map | `data/ONTOLOGY_TEMPLATE.md` | RDF/OWL Semantic data |
|
|
105
|
+
|
|
106
|
+
### 7. Coordination & Agents (`coordination/`)
|
|
107
|
+
| Template | File | Purpose |
|
|
108
|
+
|---|---|---|
|
|
109
|
+
| Agents Definition | `coordination/AGENTS_TEMPLATE.md` | Agent Swarm Definition |
|
|
110
|
+
| Swarm Config | `coordination/SWARM_CONFIG_TEMPLATE.json` | Multi-agent configuration |
|
|
111
|
+
| Agent Profile | `coordination/AGENT_PROFILE_TEMPLATE.md` | Persona definition |
|
|
112
|
+
| Agent Handshake | `coordination/AGENT_HANDSHAKE_TEMPLATE.json` | Protocol negotiation |
|
|
113
|
+
| Swarm Architecture | `coordination/SWARM_ARCHITECTURE_TEMPLATE.md` | Swarm topology |
|
|
114
|
+
|
|
115
|
+
### 8. Core System (`core/`)
|
|
116
|
+
| Template | File | Purpose |
|
|
117
|
+
|---|---|---|
|
|
118
|
+
| Implementation Plan | `core/PLAN_TEMPLATE.md` | High-level roadmap |
|
|
119
|
+
| Estimation | `core/ESTIMATION_TEMPLATE.md` | Probabilistic estimation worksheet (P50/P90) |
|
|
120
|
+
| Project Retrospective | `core/PROJECT_RETROSPECTIVE_TEMPLATE.md` | Blameless retro with owned actions |
|
|
121
|
+
| Dependency Graph | `core/DEPENDENCY_GRAPH_TEMPLATE.md` | Task dependency + parallelism worksheet |
|
|
122
|
+
| Tasks Breakdown | `core/TASKS_TEMPLATE.md` | Atomic Task decomposition |
|
|
123
|
+
| Audit Log | `core/AUDIT_LOG_TEMPLATE.md` | Project Audit Trail |
|
|
124
|
+
| SDLC Tracker | `core/SDLC_TRACKER.md` | Phase progress board |
|
|
125
|
+
| Session Snapshot | `core/SESSION_SNAPSHOT_TEMPLATE.md` | Complete project state |
|
|
126
|
+
| Traceability Matrix | `core/TRACEABILITY_MATRIX_TEMPLATE.md` | Req -> Code -> Test trace |
|
|
127
|
+
| Bug Report | `core/BUG_REPORT_TEMPLATE.md` | Structured bug reporting |
|
|
128
|
+
| System Analysis | `core/SYSTEM_ANALYSIS_TEMPLATE.md` | Root cause/System dynamics |
|
|
129
|
+
| MCP Config | `core/MCP_CONFIG_TEMPLATE.json` | Tool/MCP whitelisting |
|
|
130
|
+
| Whiteboard Design | `core/WHITEBOARD_DESIGN_TEMPLATE.md` | Freeform whiteboard/visual design capture |
|
|
131
|
+
|
|
132
|
+
### 9. Neuro-Architecture (`brain/`)
|
|
133
|
+
| Template | File | Purpose |
|
|
134
|
+
|---|---|---|
|
|
135
|
+
| Active Inference Loop | `brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md` | Cognitive loop structure |
|
|
136
|
+
| Global Workspace | `brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md` | GWT Blackboard config |
|
|
137
|
+
| Self-Improvement Log | `brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md` | Evolving prompts/tools |
|
|
138
|
+
| Knowledge Map | `brain/KNOWLEDGE_MAP_TEMPLATE.md` | Ontology & Relationships |
|
|
139
|
+
| OODA Loop Trace | `brain/OODA_LOOP_TRACE_TEMPLATE.md` | Cognitive decision tracing |
|
|
140
|
+
| Working Memory | `brain/WORKING_MEMORY_TEMPLATE.md` | Short-term context |
|
|
141
|
+
| Episodic Memory | `brain/EPISODIC_MEMORY_LOG_TEMPLATE.md` | Long-term experience log |
|
|
142
|
+
| Prediction Error | `brain/PREDICTION_ERROR_LOG_TEMPLATE.md` | Surprise minimization log |
|
|
143
|
+
|
|
144
|
+
### 10. Industry Specialized (`industry/`)
|
|
145
|
+
| Template | File | Purpose |
|
|
146
|
+
|---|---|---|
|
|
147
|
+
| FHIR Interop | `industry/FHIR_INTEGRATION_TEMPLATE.md` | Healthcare health mapping |
|
|
148
|
+
| IoT Telemetry | `industry/IOT_TELEMETRY_TEMPLATE.md` | Industrial IoT data mapping |
|
|
149
|
+
| Telecom API | `industry/TELECOM_API_TEMPLATE.md` | TMF Open API standards |
|
|
150
|
+
| Global Standards Audit | `industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md` | UN SDG/SDLC Compliance |
|
|
151
|
+
| Engineering Review | `industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md` | ISO/IEEE standard audit |
|
|
152
|
+
|
|
153
|
+
### 11. Memory & Continuity (`agents/memory/`)
|
|
154
|
+
| Template | File | Purpose |
|
|
155
|
+
|---|---|---|
|
|
156
|
+
| Decision Log | `../memory/episodic/DECISION_LOG_TEMPLATE.md` | Sequential decision history |
|
|
157
|
+
| Voting Log | `../memory/episodic/VOTING_LOG_TEMPLATE.md` | Swarm consensus decisions |
|
|
158
|
+
| Project Knowledge | `../memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md` | RAG/Long-term knowledge storage |
|
|
159
|
+
| Vector DB Config | `../memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json` | RAG connection settings |
|
|
160
|
+
| Project State | `../memory/PROJECT_STATE_TEMPLATE.md` | Master SDLC progression tracker |
|
|
161
|
+
| Continuity | `../memory/CONTINUITY_TEMPLATE.md` | Failed experiments and persistent warnings |
|
|
162
|
+
| Project Context | `brain/PROJECT_CONTEXT_TEMPLATE.md` | Working memory snapshot |
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Adaptive System Architecture: [System Name]
|
|
2
|
+
|
|
3
|
+
**Horizon**: [2026 / 2030]
|
|
4
|
+
**Pattern**: [Local-First / Edge-Native / Hybrid AI]
|
|
5
|
+
|
|
6
|
+
## 1. Evolution Strategy
|
|
7
|
+
*How will this system survive the next 5 years?*
|
|
8
|
+
- **Platform Agnostic**: [WASM Containers / Docker / Serverless]
|
|
9
|
+
- **Protocol**: [gRPC / GraphQL / Matter / NATS]
|
|
10
|
+
- **Extension Point**: [WASM Plugins / Webhooks / Scripting]
|
|
11
|
+
|
|
12
|
+
## 2. Compute Distribution (The Continuum)
|
|
13
|
+
*Where does the code run?*
|
|
14
|
+
|
|
15
|
+
| Layer | Responsibility | Technology |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| **Device (Local)** | UI, Instant Logic, SLM Inference | [SQLite / Rust / WASM] |
|
|
18
|
+
| **Edge (5G/6G)** | Caching, Real-time Aggregation | [Cloudflare Workers / AWS Greengrass] |
|
|
19
|
+
| **Cloud (Core)** | Long-term Storage, LLM Training | [K8s / Vector DB / Data Lake] |
|
|
20
|
+
|
|
21
|
+
## 3. Data Strategy (Local-First)
|
|
22
|
+
- **Source of Truth**: [Client Device / Central DB]
|
|
23
|
+
- **Sync Engine**: [Automerge / Yjs / ElectricSQL / Custom]
|
|
24
|
+
- **Conflict Resolution**: [CRDT (Merge) / Last-Write-Wins / Manual]
|
|
25
|
+
- **Vector Search**: [pgvector / Pinecone / None]
|
|
26
|
+
|
|
27
|
+
## 4. Connectivity & Resilience
|
|
28
|
+
- **Offline Behavior**: [Read-only / Full Read-Write / Queue]
|
|
29
|
+
- **Transport**: [WebSockets / QUIC / NATS JetStream]
|
|
30
|
+
- **IoT Protocol**: [Matter / MQTT / Zigbee]
|
|
31
|
+
|
|
32
|
+
## 5. Security (Zero Trust)
|
|
33
|
+
- **Identity**: [OIDC / DID (Decentralized ID) / Passkeys]
|
|
34
|
+
- **Encryption**: [TLS 1.3 / E2EE (Signal Protocol)]
|
|
35
|
+
- **Sandboxing**: [WASM / Firecracker]
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# Attribute-Driven Design (ADD 3.0) Workbook: [System Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Architect(s):** [names or roles]
|
|
5
|
+
**Status:** Draft | In progress | Complete
|
|
6
|
+
|
|
7
|
+
<!-- ADD 3.0 is an iterative, step-driven design method. You loop over design
|
|
8
|
+
rounds; each round refines one element of the system against the most
|
|
9
|
+
important drivers. Capture every round below. -->
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. Inputs (Design Drivers)
|
|
14
|
+
|
|
15
|
+
### 1.1 Functional Requirements
|
|
16
|
+
| ID | Requirement | Priority |
|
|
17
|
+
|---|---|---|
|
|
18
|
+
| F-1 | [What the system must do] | [H/M/L] |
|
|
19
|
+
| F-2 | [ ] | [ ] |
|
|
20
|
+
|
|
21
|
+
### 1.2 Quality-Attribute Scenarios
|
|
22
|
+
<!-- Format each scenario as: Source -> Stimulus -> Artifact -> Environment -> Response -> Response Measure. -->
|
|
23
|
+
|
|
24
|
+
| ID | Quality attribute | Scenario (stimulus → response → measure) | Priority (business × difficulty) |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| QA-1 | [e.g. Performance] | [e.g. "Under peak load, a request returns in < 200ms p99"] | [H/H] |
|
|
27
|
+
| QA-2 | [ ] | [ ] | [ ] |
|
|
28
|
+
|
|
29
|
+
### 1.3 Constraints
|
|
30
|
+
| ID | Constraint | Type (technical/business) |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| C-1 | [Non-negotiable, e.g. "Must run on existing K8s cluster"] | [ ] |
|
|
33
|
+
| C-2 | [ ] | [ ] |
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 2. Design Rounds
|
|
38
|
+
|
|
39
|
+
> Duplicate this block for each design round.
|
|
40
|
+
|
|
41
|
+
### Round [N]
|
|
42
|
+
|
|
43
|
+
**2.1 Design purpose:** [What this round aims to achieve — e.g. "Decompose the system into top-level modules."]
|
|
44
|
+
|
|
45
|
+
**2.2 Element(s) to refine / decompose:** [Which element from the previous round are we elaborating? For Round 1 this is usually "the system."]
|
|
46
|
+
|
|
47
|
+
**2.3 Drivers addressed this round:** [List the QA-/F-/C- IDs prioritized here and why.]
|
|
48
|
+
|
|
49
|
+
**2.4 Chosen tactics & patterns:**
|
|
50
|
+
| Driver addressed | Tactic / pattern selected | Alternatives rejected | Rationale |
|
|
51
|
+
|---|---|---|---|
|
|
52
|
+
| [QA-1] | [e.g. Caching, CQRS, Bulkhead] | [ ] | [ ] |
|
|
53
|
+
|
|
54
|
+
**2.5 Instantiated elements & responsibilities:**
|
|
55
|
+
| Element | Responsibility | Interfaces / dependencies |
|
|
56
|
+
|---|---|---|
|
|
57
|
+
| [Module/service/component] | [ ] | [ ] |
|
|
58
|
+
|
|
59
|
+
**2.6 Views sketch:** [Textual or Mermaid-style sketch of the structure produced this round — module view, C&C view, or deployment view.]
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
[ component diagram / box-and-line sketch here ]
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
**2.7 Decisions & ADR references:** [Link decisions made this round to their `ADR_TEMPLATE` records by ADR number.]
|
|
66
|
+
|
|
67
|
+
**2.8 Analysis vs drivers:**
|
|
68
|
+
| Driver | Satisfied? | Evidence / residual risk |
|
|
69
|
+
|---|---|---|
|
|
70
|
+
| [QA-1] | [Yes/Partial/No] | [How we know; what's left to validate] |
|
|
71
|
+
|
|
72
|
+
**2.9 Not-yet-addressed drivers (carried to next round):** [List.]
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 3. Exit Check
|
|
77
|
+
|
|
78
|
+
- [ ] All high-priority drivers addressed or explicitly deferred with rationale.
|
|
79
|
+
- [ ] Each design round records tactics, elements, a view, and an analysis.
|
|
80
|
+
- [ ] Key decisions captured as ADRs.
|
|
81
|
+
- [ ] Residual risks logged for the next iteration.
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
# ADR-[NNN]: [Title of Architectural Decision]
|
|
2
|
+
<!-- Architecture Decision Record — created by adr-writer.skill -->
|
|
3
|
+
<!-- Store in: docs/architecture/decisions/ADR-[NNN]-[slug].md -->
|
|
4
|
+
|
|
5
|
+
**Date:** [YYYY-MM-DD]
|
|
6
|
+
**Status:** Proposed | Accepted | Deprecated | Superseded by [ADR-NNN]
|
|
7
|
+
**Deciders:** [names or roles — e.g., "Tech Lead, Backend Team"]
|
|
8
|
+
**Tags:** [database | authentication | api | frontend | infrastructure | security | performance]
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Context
|
|
13
|
+
|
|
14
|
+
<!-- What is the problem we're solving?
|
|
15
|
+
What are the forces at play? (performance, security, team skills, cost, time)
|
|
16
|
+
What is the current state (status quo)?
|
|
17
|
+
Why does a decision need to be made NOW? -->
|
|
18
|
+
|
|
19
|
+
[2-5 sentences describing the situation and why this decision matters.]
|
|
20
|
+
|
|
21
|
+
**Current state:** [How things work today]
|
|
22
|
+
**Constraint(s):** [Non-negotiable constraints: budget, timeline, team expertise, existing system]
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Options Considered
|
|
27
|
+
|
|
28
|
+
### Option A: [Name]
|
|
29
|
+
<!-- Description: what is this option? -->
|
|
30
|
+
[Brief description]
|
|
31
|
+
|
|
32
|
+
**Pros:**
|
|
33
|
+
- [benefit 1]
|
|
34
|
+
- [benefit 2]
|
|
35
|
+
|
|
36
|
+
**Cons:**
|
|
37
|
+
- [drawback 1]
|
|
38
|
+
- [drawback 2]
|
|
39
|
+
|
|
40
|
+
**Source:** [Official docs, benchmark, team experience]
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
### Option B: [Name]
|
|
45
|
+
[Brief description]
|
|
46
|
+
|
|
47
|
+
**Pros:**
|
|
48
|
+
- [benefit 1]
|
|
49
|
+
- [benefit 2]
|
|
50
|
+
|
|
51
|
+
**Cons:**
|
|
52
|
+
- [drawback 1]
|
|
53
|
+
- [drawback 2]
|
|
54
|
+
|
|
55
|
+
**Source:** [Official docs, benchmark, team experience]
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
### Option C: [Name] (if applicable)
|
|
60
|
+
[Brief description]
|
|
61
|
+
|
|
62
|
+
**Pros:**
|
|
63
|
+
- [benefit 1]
|
|
64
|
+
|
|
65
|
+
**Cons:**
|
|
66
|
+
- [drawback 1]
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Decision
|
|
71
|
+
|
|
72
|
+
**We will use [Option X].**
|
|
73
|
+
|
|
74
|
+
Because:
|
|
75
|
+
1. [Primary reason — ties to constraint or requirement]
|
|
76
|
+
2. [Secondary reason]
|
|
77
|
+
3. [Supporting evidence — benchmark, official recommendation, team expertise]
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Consequences
|
|
82
|
+
|
|
83
|
+
### Positive
|
|
84
|
+
- [What improves as a result of this decision]
|
|
85
|
+
- [What becomes easier]
|
|
86
|
+
- [What risk is reduced]
|
|
87
|
+
|
|
88
|
+
### Negative
|
|
89
|
+
- [What trade-off or cost do we accept]
|
|
90
|
+
- [What becomes harder or more expensive]
|
|
91
|
+
- [What technical debt is introduced, if any]
|
|
92
|
+
|
|
93
|
+
### Neutral
|
|
94
|
+
- [Things that change but aren't clearly positive or negative]
|
|
95
|
+
- [Things teams need to learn or adapt to]
|
|
96
|
+
|
|
97
|
+
### Risks
|
|
98
|
+
- [Risk 1]: [how we mitigate it]
|
|
99
|
+
- [Risk 2]: [how we mitigate it or accept it]
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Y-Statement Summary
|
|
104
|
+
|
|
105
|
+
> For [context / who this decision serves]
|
|
106
|
+
> who need [goal or capability],
|
|
107
|
+
> [the chosen solution]
|
|
108
|
+
> is a [category: database, framework, pattern, approach]
|
|
109
|
+
> that [key benefit].
|
|
110
|
+
> Unlike [alternative],
|
|
111
|
+
> our solution [key differentiator].
|
|
112
|
+
|
|
113
|
+
**Example:**
|
|
114
|
+
> For the authentication team who need a stateless, scalable session mechanism,
|
|
115
|
+
> JWT with refresh token rotation
|
|
116
|
+
> is a token-based authentication approach
|
|
117
|
+
> that eliminates server-side session storage.
|
|
118
|
+
> Unlike session cookies,
|
|
119
|
+
> our solution works across multiple API servers without a shared session store.
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## Links
|
|
124
|
+
|
|
125
|
+
- **PRD Reference:** [link to PRD where this decision is needed]
|
|
126
|
+
- **Related ADRs:** [ADR-NNN — links to related decisions]
|
|
127
|
+
- **Official docs:** [link to official documentation that informed this decision]
|
|
128
|
+
- **Implementation:** [link to PR or commit where this was implemented]
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Review
|
|
133
|
+
|
|
134
|
+
**Approved by:** [name, date]
|
|
135
|
+
**Implementation complete:** [Yes/No — date]
|
|
136
|
+
**Revisit date:** [When should we revisit this decision? e.g., "2026 Q1 when library v3.0 releases"]
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
# Architecture Decision Matrix — [Decision Title]
|
|
2
|
+
<!-- Weighted multi-criteria decision matrix for comparing architecture options -->
|
|
3
|
+
<!-- Created by: arch-design.skill, adr-writer.skill -->
|
|
4
|
+
<!-- Use when: choosing between 2+ viable architectural approaches -->
|
|
5
|
+
<!-- One matrix per major decision. Reference from ADR. -->
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Meta
|
|
10
|
+
|
|
11
|
+
| Field | Value |
|
|
12
|
+
|---|---|
|
|
13
|
+
| **Decision** | [Clear decision statement: "Which architecture style to use for X"] |
|
|
14
|
+
| **Date** | [YYYY-MM-DD] |
|
|
15
|
+
| **Author** | [agent / human] |
|
|
16
|
+
| **Status** | DRAFT / DECIDED |
|
|
17
|
+
| **ADR reference** | [ADR-NNN] |
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## Decision Context
|
|
22
|
+
|
|
23
|
+
**Problem statement**: [What specific problem are we solving with this architectural decision?]
|
|
24
|
+
|
|
25
|
+
**Constraints** (non-negotiable — options violating these are eliminated):
|
|
26
|
+
- [Constraint 1: e.g., Must support 10k concurrent users without vertical scaling]
|
|
27
|
+
- [Constraint 2: e.g., Must integrate with existing [system] via [protocol]]
|
|
28
|
+
- [Constraint 3: e.g., Must be operable by a team of ≤ 3 engineers]
|
|
29
|
+
|
|
30
|
+
**Assumptions** (things we're taking as true — document to revisit later):
|
|
31
|
+
- [Assumption 1: e.g., User growth will not exceed 100x current load in 2 years]
|
|
32
|
+
- [Assumption 2: e.g., Team has familiarity with event-driven patterns]
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Options Considered
|
|
37
|
+
|
|
38
|
+
| Option | Short Description | Eliminated? (and why) |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| Option A | [e.g., Layered monolith] | NO — viable |
|
|
41
|
+
| Option B | [e.g., Event-driven service-based] | NO — viable |
|
|
42
|
+
| Option C | [e.g., Full microservices] | YES — violates Constraint 3 (team size) |
|
|
43
|
+
| Option D | [e.g., Serverless] | YES — violates Constraint 2 (integration protocol) |
|
|
44
|
+
|
|
45
|
+
**Options proceeding to evaluation**: Option A, Option B
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Evaluation Criteria
|
|
50
|
+
|
|
51
|
+
Define criteria that matter for this specific decision.
|
|
52
|
+
Assign weight (1-5) based on which quality attributes are most important for this system.
|
|
53
|
+
|
|
54
|
+
| # | Criterion | Why it matters | Weight (1-5) |
|
|
55
|
+
|---|---|---|---|
|
|
56
|
+
| C1 | [Operational simplicity] | [Small team — operations complexity is a key risk] | 5 |
|
|
57
|
+
| C2 | [Scalability] | [System must handle 10x growth] | 4 |
|
|
58
|
+
| C3 | [Development velocity] | [Team needs to ship features frequently] | 4 |
|
|
59
|
+
| C4 | [Fault isolation] | [Failure in one area must not cascade] | 3 |
|
|
60
|
+
| C5 | [Data consistency] | [Financial data must be consistent] | 5 |
|
|
61
|
+
| C6 | [Cost to implement] | [Limited budget for initial build] | 3 |
|
|
62
|
+
| C7 | [Team familiarity] | [Learning curve has real cost] | 2 |
|
|
63
|
+
|
|
64
|
+
**Scoring scale**: 1 (very poor) → 5 (excellent) for each criterion.
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Decision Matrix
|
|
69
|
+
|
|
70
|
+
| Criterion | Weight | Option A Score | Option A Weighted | Option B Score | Option B Weighted |
|
|
71
|
+
|---|---|---|---|---|---|
|
|
72
|
+
| C1 — Operational simplicity | 5 | 5 | **25** | 3 | **15** |
|
|
73
|
+
| C2 — Scalability | 4 | 3 | **12** | 5 | **20** |
|
|
74
|
+
| C3 — Development velocity | 4 | 4 | **16** | 3 | **12** |
|
|
75
|
+
| C4 — Fault isolation | 3 | 2 | **6** | 4 | **12** |
|
|
76
|
+
| C5 — Data consistency | 5 | 5 | **25** | 3 | **15** |
|
|
77
|
+
| C6 — Cost to implement | 3 | 4 | **12** | 2 | **6** |
|
|
78
|
+
| C7 — Team familiarity | 2 | 5 | **10** | 2 | **4** |
|
|
79
|
+
| **TOTAL** | | | **106** | | **84** |
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Qualitative Analysis
|
|
84
|
+
|
|
85
|
+
### Option A: [Name]
|
|
86
|
+
|
|
87
|
+
**Pros:**
|
|
88
|
+
- [Strength 1]
|
|
89
|
+
- [Strength 2]
|
|
90
|
+
- [Strength 3]
|
|
91
|
+
|
|
92
|
+
**Cons:**
|
|
93
|
+
- [Weakness 1]
|
|
94
|
+
- [Weakness 2]
|
|
95
|
+
|
|
96
|
+
**Key risk**: [What is the biggest risk if we choose this option?]
|
|
97
|
+
|
|
98
|
+
**Reversibility**: HIGH / MEDIUM / LOW
|
|
99
|
+
[How easy is it to change this decision later if it proves wrong?]
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
### Option B: [Name]
|
|
104
|
+
|
|
105
|
+
**Pros:**
|
|
106
|
+
- [Strength 1]
|
|
107
|
+
- [Strength 2]
|
|
108
|
+
|
|
109
|
+
**Cons:**
|
|
110
|
+
- [Weakness 1]
|
|
111
|
+
- [Weakness 2]
|
|
112
|
+
|
|
113
|
+
**Key risk**: [What is the biggest risk if we choose this option?]
|
|
114
|
+
|
|
115
|
+
**Reversibility**: HIGH / MEDIUM / LOW
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## Sensitivity Analysis
|
|
120
|
+
|
|
121
|
+
```
|
|
122
|
+
Which criteria, if weighted differently, would change the outcome?
|
|
123
|
+
|
|
124
|
+
If C2 (Scalability) weight = 5 instead of 4:
|
|
125
|
+
Option A total: [recalculate]
|
|
126
|
+
Option B total: [recalculate]
|
|
127
|
+
Winner changes? YES/NO
|
|
128
|
+
|
|
129
|
+
If C1 (Operational simplicity) weight = 3 instead of 5:
|
|
130
|
+
Option A total: [recalculate]
|
|
131
|
+
Option B total: [recalculate]
|
|
132
|
+
Winner changes? YES/NO
|
|
133
|
+
|
|
134
|
+
Conclusion:
|
|
135
|
+
The decision is ROBUST — winner stays the same across weight variations.
|
|
136
|
+
OR
|
|
137
|
+
The decision is SENSITIVE to [C2] weighting — human must confirm priority.
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## Decision
|
|
143
|
+
|
|
144
|
+
**Recommended option**: [Option A / Option B]
|
|
145
|
+
**Based on**: [weighted score + key qualitative factors]
|
|
146
|
+
|
|
147
|
+
**Rationale** (beyond the numbers):
|
|
148
|
+
[2-3 sentences explaining the decision in human-readable terms, focusing on the most important factors]
|
|
149
|
+
|
|
150
|
+
**Specific conditions on the decision**:
|
|
151
|
+
- [Condition 1: e.g., Re-evaluate if team grows beyond 10 engineers]
|
|
152
|
+
- [Condition 2: e.g., Re-evaluate if user growth exceeds 50x]
|
|
153
|
+
|
|
154
|
+
**Accepted risks**:
|
|
155
|
+
- [Risk 1: e.g., Scaling beyond 10x will require architectural rework — accepted for now]
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## Decision Sign-off
|
|
160
|
+
|
|
161
|
+
| Role | Name | Date | Approved |
|
|
162
|
+
|---|---|---|---|
|
|
163
|
+
| [Architect / Tech Lead] | | [YYYY-MM-DD] | [ ] |
|
|
164
|
+
| [Product Owner] | | [YYYY-MM-DD] | [ ] |
|
|
165
|
+
| [Engineering Manager] | | [YYYY-MM-DD] | [ ] |
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
169
|
+
**Linked ADR**: [ADR-NNN — write full ADR using adr-writer.skill referencing this matrix]
|