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,185 @@
|
|
|
1
|
+
# C4 Architecture — [System Name]
|
|
2
|
+
<!-- C4 Model: 4 levels of abstraction for software architecture -->
|
|
3
|
+
<!-- Created by: prod-architect | Date: [date] | Store in: docs/architecture/ -->
|
|
4
|
+
<!-- Reference: https://c4model.com -->
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Level 1 — System Context Diagram
|
|
9
|
+
|
|
10
|
+
> Highest level view: who uses the system and what external systems does it interact with?
|
|
11
|
+
|
|
12
|
+
```mermaid
|
|
13
|
+
C4Context
|
|
14
|
+
title System Context — [System Name]
|
|
15
|
+
|
|
16
|
+
Person(user, "End User", "A person who uses the system via web browser or mobile app")
|
|
17
|
+
Person(admin, "Administrator", "Internal team member managing the system")
|
|
18
|
+
|
|
19
|
+
System(system, "[System Name]", "The system being designed — [one sentence description]")
|
|
20
|
+
|
|
21
|
+
System_Ext(email, "Email Service", "Sends transactional emails (SendGrid / Postmark)")
|
|
22
|
+
System_Ext(payment, "Payment Processor", "Handles payments (Stripe / PayPal)")
|
|
23
|
+
System_Ext(auth, "Identity Provider", "OAuth2 / SSO provider (Auth0 / Google)")
|
|
24
|
+
|
|
25
|
+
Rel(user, system, "Uses", "HTTPS")
|
|
26
|
+
Rel(admin, system, "Administers", "HTTPS")
|
|
27
|
+
Rel(system, email, "Sends emails via", "HTTPS/SMTP")
|
|
28
|
+
Rel(system, payment, "Processes payments via", "HTTPS")
|
|
29
|
+
Rel(system, auth, "Authenticates via", "OIDC/OAuth2")
|
|
30
|
+
|
|
31
|
+
UpdateLayoutConfig($c4ShapeInRow="3", $c4BoundaryInRow="1")
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
```text
|
|
35
|
+
[End User] ---> [System Name] <--- [Administrator]
|
|
36
|
+
|
|
|
37
|
+
+--------------------+--------------------+
|
|
38
|
+
v v v
|
|
39
|
+
[Email Service] [Payment Processor] [Identity Provider]
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Level 2 — Container Diagram
|
|
45
|
+
|
|
46
|
+
> Zoom into the system: what are the deployable units (applications, databases, services)?
|
|
47
|
+
|
|
48
|
+
```mermaid
|
|
49
|
+
C4Container
|
|
50
|
+
title Container Diagram — [System Name]
|
|
51
|
+
|
|
52
|
+
Person(user, "End User")
|
|
53
|
+
|
|
54
|
+
System_Boundary(system, "[System Name]") {
|
|
55
|
+
Container(webapp, "Web Application", "React / Next.js", "Single Page Application — UI in browser")
|
|
56
|
+
Container(api, "API Service", "Node.js / Fastify", "REST API serving mobile and web clients")
|
|
57
|
+
Container(worker, "Background Worker", "Node.js / BullMQ", "Processes async jobs: emails, exports, etc.")
|
|
58
|
+
ContainerDb(db, "Database", "PostgreSQL 16", "Primary data store — users, orders, etc.")
|
|
59
|
+
ContainerDb(cache, "Cache", "Redis 7", "Session cache, rate limiting, job queue")
|
|
60
|
+
ContainerDb(storage, "File Storage", "AWS S3", "User uploads and generated files")
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
System_Ext(email, "Email Service (SendGrid)")
|
|
64
|
+
System_Ext(payment, "Stripe")
|
|
65
|
+
|
|
66
|
+
Rel(user, webapp, "Uses", "HTTPS")
|
|
67
|
+
Rel(webapp, api, "API calls", "HTTPS/JSON")
|
|
68
|
+
Rel(api, db, "Reads/writes", "TCP/5432")
|
|
69
|
+
Rel(api, cache, "Reads/writes", "TCP/6379")
|
|
70
|
+
Rel(api, storage, "Stores files", "HTTPS")
|
|
71
|
+
Rel(api, payment, "Processes payments", "HTTPS")
|
|
72
|
+
Rel(worker, db, "Reads/writes", "TCP/5432")
|
|
73
|
+
Rel(worker, cache, "Job queue", "TCP/6379")
|
|
74
|
+
Rel(worker, email, "Sends emails", "HTTPS")
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Level 3 — Component Diagram
|
|
80
|
+
|
|
81
|
+
> Zoom into one container: what are the major components inside the API service?
|
|
82
|
+
|
|
83
|
+
```mermaid
|
|
84
|
+
C4Component
|
|
85
|
+
title Component Diagram — API Service
|
|
86
|
+
|
|
87
|
+
Container_Boundary(api, "API Service") {
|
|
88
|
+
Component(router, "HTTP Router", "Fastify", "Routes incoming HTTP requests to controllers")
|
|
89
|
+
Component(authMW, "Auth Middleware", "JWT/Passport", "Validates JWT tokens, injects user context")
|
|
90
|
+
|
|
91
|
+
Component(userCtrl, "User Controller", "TypeScript", "Handles user CRUD operations")
|
|
92
|
+
Component(orderCtrl, "Order Controller", "TypeScript", "Handles order creation and management")
|
|
93
|
+
|
|
94
|
+
Component(createUserUC, "CreateUserUseCase", "TypeScript", "Business logic for user registration")
|
|
95
|
+
Component(createOrderUC, "CreateOrderUseCase", "TypeScript", "Business logic for order creation")
|
|
96
|
+
|
|
97
|
+
Component(userRepo, "UserRepository", "Prisma", "Persists and retrieves user data")
|
|
98
|
+
Component(orderRepo, "OrderRepository", "Prisma", "Persists and retrieves order data")
|
|
99
|
+
Component(eventBus, "EventBus", "BullMQ", "Dispatches domain events to worker")
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
ContainerDb(db, "Database", "PostgreSQL")
|
|
103
|
+
ContainerDb(cache, "Cache", "Redis")
|
|
104
|
+
|
|
105
|
+
Rel(router, authMW, "All requests through")
|
|
106
|
+
Rel(authMW, userCtrl, "Authenticated requests")
|
|
107
|
+
Rel(authMW, orderCtrl, "Authenticated requests")
|
|
108
|
+
Rel(userCtrl, createUserUC, "Calls")
|
|
109
|
+
Rel(orderCtrl, createOrderUC, "Calls")
|
|
110
|
+
Rel(createUserUC, userRepo, "Uses")
|
|
111
|
+
Rel(createOrderUC, orderRepo, "Uses")
|
|
112
|
+
Rel(createOrderUC, eventBus, "Publishes OrderCreated")
|
|
113
|
+
Rel(userRepo, db, "SQL queries")
|
|
114
|
+
Rel(orderRepo, db, "SQL queries")
|
|
115
|
+
Rel(eventBus, cache, "Job queue")
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## Level 4 — Code/Class Diagram
|
|
121
|
+
|
|
122
|
+
> Zoom into a component: class structure and relationships (add as needed for complex components)
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
[Add Level 4 diagrams for complex domain areas as needed]
|
|
126
|
+
|
|
127
|
+
Example: User aggregate
|
|
128
|
+
User (aggregate root)
|
|
129
|
+
- Email (value object)
|
|
130
|
+
- UserId (value object)
|
|
131
|
+
- UserRole (enum)
|
|
132
|
+
+ create(email, name): Result<User>
|
|
133
|
+
+ updateEmail(email): Result<void>
|
|
134
|
+
- validate(): void
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## Architecture Decisions
|
|
140
|
+
|
|
141
|
+
See ADRs in `docs/architecture/decisions/` for rationale behind technology choices:
|
|
142
|
+
|
|
143
|
+
| ADR | Decision | Status |
|
|
144
|
+
|---|---|---|
|
|
145
|
+
| ADR-001 | [Technology choice] | [Accepted/Proposed] |
|
|
146
|
+
| ADR-002 | [Architecture pattern] | [Accepted/Proposed] |
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## Layer Import Rules
|
|
151
|
+
|
|
152
|
+
```
|
|
153
|
+
Domain layer: No imports from application, adapters, or infrastructure
|
|
154
|
+
Application layer: Imports domain only (interfaces, entities, value objects)
|
|
155
|
+
Adapters layer: Imports domain + application (through interfaces)
|
|
156
|
+
Infrastructure: Imports domain interfaces (implements them)
|
|
157
|
+
Main/Bootstrap: Imports all layers (composition root only)
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
Enforced by: `agentic-linter.skill` using `dependency-cruiser` or `deptrac`
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## Data Flow Diagrams
|
|
165
|
+
|
|
166
|
+
### User Registration Flow
|
|
167
|
+
```
|
|
168
|
+
Browser → POST /api/v1/users
|
|
169
|
+
→ AuthMiddleware (skip — public endpoint)
|
|
170
|
+
→ UserController.create()
|
|
171
|
+
→ Zod validation (422 if invalid)
|
|
172
|
+
→ CreateUserUseCase.execute()
|
|
173
|
+
→ Email value object (domain validation)
|
|
174
|
+
→ UserRepository.findByEmail() → 409 if exists
|
|
175
|
+
→ User.create() (domain entity)
|
|
176
|
+
→ UserRepository.save()
|
|
177
|
+
→ EventBus.publish(UserRegisteredEvent)
|
|
178
|
+
→ Return UserDto
|
|
179
|
+
→ 201 Created { id, email, name, createdAt }
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
*Last updated: [date]*
|
|
185
|
+
*Review when: new services added, major refactoring, technology changes*
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
# Business Capability Map — [Organization / System Name]
|
|
2
|
+
<!-- Business capability model: what the business/system CAN DO, independent of how -->
|
|
3
|
+
<!-- Technology-agnostic. No implementation, no process, no org structure. -->
|
|
4
|
+
<!-- Created by: req-elicitation.skill or arch-design.skill -->
|
|
5
|
+
<!-- Use to: identify system scope, find bounded contexts, prioritize investment -->
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Meta
|
|
10
|
+
|
|
11
|
+
| Field | Value |
|
|
12
|
+
|---|---|
|
|
13
|
+
| **Organization / System** | [name] |
|
|
14
|
+
| **Scope** | [full org / product line / specific system] |
|
|
15
|
+
| **Version** | [1.0] |
|
|
16
|
+
| **Date** | [YYYY-MM-DD] |
|
|
17
|
+
| **Status** | DRAFT / APPROVED |
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## What is a Business Capability?
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
A business capability defines WHAT a business does — not HOW it does it.
|
|
25
|
+
It is stable: capabilities don't change when technology changes or org restructures.
|
|
26
|
+
|
|
27
|
+
Good capability: "Order Management" (stable — always needed)
|
|
28
|
+
Bad example: "SAP Order Processing" (implementation — changes with tools)
|
|
29
|
+
Bad example: "Order Processing Team" (org structure — changes with reorgs)
|
|
30
|
+
|
|
31
|
+
Capabilities are hierarchical:
|
|
32
|
+
Level 1: Major capability areas (coarsest granularity — 5-15 total)
|
|
33
|
+
Level 2: Sub-capabilities within each L1 (15-50 total)
|
|
34
|
+
Level 3: Specific capabilities within each L2 (50-200 total — as needed)
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Capability Map
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
Color coding for investment priority:
|
|
43
|
+
⬛ RED: Pain area — immediate investment needed
|
|
44
|
+
🟨 YELLOW: Adequate — maintain, no major investment
|
|
45
|
+
🟩 GREEN: Differentiating — competitive advantage, invest further
|
|
46
|
+
⬜ WHITE: Not assessed
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Level 1 — Major Capability Areas
|
|
50
|
+
|
|
51
|
+
```
|
|
52
|
+
[System/Org Name] Business Capabilities
|
|
53
|
+
|
|
54
|
+
┌─────────────────────────────────────────────────────────────────────────┐
|
|
55
|
+
│ 1. CUSTOMER MANAGEMENT │ 2. PRODUCT & CATALOG │ 3. ORDER MGMT │
|
|
56
|
+
├─────────────────────────────────────────────────────────────────────────┤
|
|
57
|
+
│ 4. FULFILLMENT │ 5. PAYMENT & FINANCE │ 6. ANALYTICS │
|
|
58
|
+
├─────────────────────────────────────────────────────────────────────────┤
|
|
59
|
+
│ 7. [CAPABILITY AREA] │ 8. [CAPABILITY AREA] │ 9. ... │
|
|
60
|
+
└─────────────────────────────────────────────────────────────────────────┘
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Capability Hierarchy (Detailed)
|
|
66
|
+
|
|
67
|
+
### 1. [Capability Area Name — e.g., Customer Management]
|
|
68
|
+
|
|
69
|
+
**Purpose**: [What business outcome this capability area enables]
|
|
70
|
+
|
|
71
|
+
| L2 Capability | L3 Capabilities | Priority | Investment Status | Bounded Context |
|
|
72
|
+
|---|---|---|---|---|
|
|
73
|
+
| 1.1 [Customer Acquisition] | 1.1.1 Registration, 1.1.2 Onboarding, 1.1.3 Identity Verification | HIGH | 🟨 Adequate | [Identity Context] |
|
|
74
|
+
| 1.2 [Customer Retention] | 1.2.1 Loyalty Programs, 1.2.2 Communication Preferences | MEDIUM | ⬛ Pain area | [CRM Context] |
|
|
75
|
+
| 1.3 [Customer Data Management] | 1.3.1 Profile Mgmt, 1.3.2 Consent Management, 1.3.3 Data Portability | HIGH | 🟨 Adequate | [Identity Context] |
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
### 2. [Capability Area Name — e.g., Order Management]
|
|
80
|
+
|
|
81
|
+
**Purpose**: [What business outcome this capability area enables]
|
|
82
|
+
|
|
83
|
+
| L2 Capability | L3 Capabilities | Priority | Investment Status | Bounded Context |
|
|
84
|
+
|---|---|---|---|---|
|
|
85
|
+
| 2.1 [Order Capture] | 2.1.1 Cart Management, 2.1.2 Order Placement, 2.1.3 Order Validation | HIGH | 🟩 Differentiating | [Order Context] |
|
|
86
|
+
| 2.2 [Order Processing] | 2.2.1 Fulfilment Routing, 2.2.2 Status Tracking, 2.2.3 Exception Handling | HIGH | ⬛ Pain area | [Order Context] |
|
|
87
|
+
| 2.3 [Order Modification] | 2.3.1 Cancellation, 2.3.2 Returns, 2.3.3 Exchanges | MEDIUM | 🟨 Adequate | [Order Context] |
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
### 3. [Capability Area Name]
|
|
92
|
+
|
|
93
|
+
| L2 Capability | L3 Capabilities | Priority | Investment Status | Bounded Context |
|
|
94
|
+
|---|---|---|---|---|
|
|
95
|
+
| | | | | |
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
<!-- Add one section per L1 capability area -->
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## Capability Assessment
|
|
104
|
+
|
|
105
|
+
### Pain Areas (Immediate Investment Needed)
|
|
106
|
+
|
|
107
|
+
| Capability | Current Problem | Business Impact | Recommended Action |
|
|
108
|
+
|---|---|---|---|
|
|
109
|
+
| [1.2 Customer Retention] | [No loyalty program infrastructure] | [HIGH — customer churn 30% above industry] | [Build v1 loyalty capability in Q2] |
|
|
110
|
+
| [2.2 Order Processing] | [Manual exception handling] | [MEDIUM — 15% of orders need manual intervention] | [Automate exception routing] |
|
|
111
|
+
|
|
112
|
+
### Differentiating Capabilities (Competitive Advantage — Invest)
|
|
113
|
+
|
|
114
|
+
| Capability | Why Differentiating | Investment Recommendation |
|
|
115
|
+
|---|---|---|
|
|
116
|
+
| [2.1 Order Capture] | [Unique UX reduces cart abandonment by 40%] | [Continue R&D investment; protect IP] |
|
|
117
|
+
|
|
118
|
+
### Generic Capabilities (Buy/SaaS — Don't Build)
|
|
119
|
+
|
|
120
|
+
| Capability | Current Status | Recommendation |
|
|
121
|
+
|---|---|---|
|
|
122
|
+
| [Email Delivery] | [Built in-house] | [Replace with SaaS (e.g., transactional email service)] |
|
|
123
|
+
| [Payment Processing] | [Using gateway already] | [Keep on SaaS — do not internalize] |
|
|
124
|
+
|
|
125
|
+
---
|
|
126
|
+
|
|
127
|
+
## Capability-to-System Mapping
|
|
128
|
+
|
|
129
|
+
> Which systems currently serve each capability? Identifies gaps and overlaps.
|
|
130
|
+
|
|
131
|
+
| Capability | Current System(s) | Status |
|
|
132
|
+
|---|---|---|
|
|
133
|
+
| [Customer Registration] | [Current Auth System] | COVERED |
|
|
134
|
+
| [Customer Consent Management] | [None] | GAP — not implemented |
|
|
135
|
+
| [Order Placement] | [Legacy Order System + this new system] | OVERLAP — duplication |
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## Capability Investment Roadmap
|
|
140
|
+
|
|
141
|
+
Based on pain areas and strategic priorities:
|
|
142
|
+
|
|
143
|
+
| Quarter | Capability | Investment Type | Expected Outcome |
|
|
144
|
+
|---|---|---|---|
|
|
145
|
+
| Q1 | [2.2 Order Processing] | Improve | [Reduce manual intervention from 15% to 3%] |
|
|
146
|
+
| Q2 | [1.2 Customer Retention] | Build | [Launch basic loyalty program] |
|
|
147
|
+
| Q3 | [3.x New capability] | Build | [Enable [business outcome]] |
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
## Notes
|
|
152
|
+
|
|
153
|
+
[Any additional context about the capability landscape, strategic context, or pending decisions]
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
# Context Map — [System Name]
|
|
2
|
+
<!-- Domain bounded contexts and their integration relationships -->
|
|
3
|
+
<!-- Created by: domain-model.skill -->
|
|
4
|
+
<!-- Standard: Domain-Driven Design (Eric Evans), Implementing DDD (Vaughn Vernon) -->
|
|
5
|
+
<!-- Referenced by: ARCHITECTURE_VIEWS_TEMPLATE.md, DOMAIN_MODEL_TEMPLATE.md -->
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Meta
|
|
10
|
+
|
|
11
|
+
| Field | Value |
|
|
12
|
+
|---|---|
|
|
13
|
+
| **System** | [system name] |
|
|
14
|
+
| **Version** | [1.0] |
|
|
15
|
+
| **Date** | [YYYY-MM-DD] |
|
|
16
|
+
| **Status** | DRAFT / APPROVED |
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Bounded Context Inventory
|
|
21
|
+
|
|
22
|
+
| Context ID | Name | Description | Team/Owner | Stability |
|
|
23
|
+
|---|---|---|---|---|
|
|
24
|
+
| BC-01 | [Context Name] | [What business capability this context encapsulates] | [Team] | [STABLE/EVOLVING/LEGACY] |
|
|
25
|
+
| BC-02 | | | | |
|
|
26
|
+
| BC-03 | | | | |
|
|
27
|
+
| BC-04 | | | | |
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Context Map Diagram
|
|
32
|
+
|
|
33
|
+
```mermaid
|
|
34
|
+
graph TB
|
|
35
|
+
subgraph "BC-01: [Context Name] [U]"
|
|
36
|
+
BC01[[BC-01\n[Context Name]]]
|
|
37
|
+
end
|
|
38
|
+
subgraph "BC-02: [Context Name] [U]"
|
|
39
|
+
BC02[[BC-02\n[Context Name]]]
|
|
40
|
+
end
|
|
41
|
+
subgraph "BC-03: [Context Name] [D]"
|
|
42
|
+
BC03[[BC-03\n[Context Name]]]
|
|
43
|
+
end
|
|
44
|
+
subgraph "BC-04: [Context Name] [D]"
|
|
45
|
+
BC04[[BC-04\n[Context Name]]]
|
|
46
|
+
end
|
|
47
|
+
|
|
48
|
+
BC01 -->|"OHS/PL\n[API name]"| BC03
|
|
49
|
+
BC02 -->|"Customer/Supplier\n[data shared]"| BC03
|
|
50
|
+
BC01 -->|"Partnership\n[shared model]"| BC02
|
|
51
|
+
BC01 -->|"Published Language\n[event name]"| BC04
|
|
52
|
+
|
|
53
|
+
style BC01 fill:#d5e8d4,stroke:#82b366
|
|
54
|
+
style BC02 fill:#dae8fc,stroke:#6c8ebf
|
|
55
|
+
style BC03 fill:#fff2cc,stroke:#d6b656
|
|
56
|
+
style BC04 fill:#fff2cc,stroke:#d6b656
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
```text
|
|
60
|
+
[BC-01: Context Name [U]] [BC-02: Context Name [U]]
|
|
61
|
+
| | |
|
|
62
|
+
| +----(Partnership)---------+
|
|
63
|
+
|
|
|
64
|
+
(OHS/PL [API name])
|
|
65
|
+
| (Customer/Supplier [data])
|
|
66
|
+
v |
|
|
67
|
+
[BC-03: Context Name [D]] <-------------------+
|
|
68
|
+
|
|
69
|
+
[BC-01: Context Name [U]]
|
|
70
|
+
|
|
|
71
|
+
(Published Language [event])
|
|
72
|
+
|
|
|
73
|
+
v
|
|
74
|
+
[BC-04: Context Name [D]]
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
**Legend:**
|
|
78
|
+
- [U] = Upstream (provides the interface)
|
|
79
|
+
- [D] = Downstream (consumes the interface)
|
|
80
|
+
- Green = Core domain (highest business value)
|
|
81
|
+
- Blue = Supporting domain
|
|
82
|
+
- Yellow = Generic / downstream
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Integration Relationship Details
|
|
87
|
+
|
|
88
|
+
### Relationship 1: BC-01 → BC-03
|
|
89
|
+
|
|
90
|
+
| Field | Value |
|
|
91
|
+
|---|---|
|
|
92
|
+
| **Pattern** | [OHS/PL / Customer-Supplier / Conformist / ACL / Partnership / Shared Kernel / Separate Ways] |
|
|
93
|
+
| **Direction** | BC-01 (Upstream) → BC-03 (Downstream) |
|
|
94
|
+
| **What is shared** | [specific data structures, events, or APIs] |
|
|
95
|
+
| **Integration mechanism** | [REST API / Event Bus / Shared Schema / Shared Library] |
|
|
96
|
+
| **Contract** | [link to API spec or event schema] |
|
|
97
|
+
| **Change impact** | [what happens if BC-01 changes its interface] |
|
|
98
|
+
|
|
99
|
+
**Pattern explanation:**
|
|
100
|
+
```
|
|
101
|
+
OHS (Open Host Service): BC-01 provides a well-documented, stable API
|
|
102
|
+
PL (Published Language): The API uses a formally defined schema
|
|
103
|
+
ACL needed at BC-03: [YES/NO — does BC-03 need to translate BC-01's model?]
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
### Relationship 2: BC-02 → BC-03
|
|
109
|
+
|
|
110
|
+
| Field | Value |
|
|
111
|
+
|---|---|
|
|
112
|
+
| **Pattern** | [pattern name] |
|
|
113
|
+
| **Direction** | |
|
|
114
|
+
| **What is shared** | |
|
|
115
|
+
| **Integration mechanism** | |
|
|
116
|
+
| **Contract** | |
|
|
117
|
+
| **Change impact** | |
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
<!-- Add one section per integration relationship -->
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Integration Pattern Reference
|
|
126
|
+
|
|
127
|
+
```
|
|
128
|
+
Partnership:
|
|
129
|
+
Both teams plan and develop together — changes coordinated.
|
|
130
|
+
Use when: high interdependence, teams can communicate frequently.
|
|
131
|
+
Risk: both teams must move together.
|
|
132
|
+
|
|
133
|
+
Shared Kernel:
|
|
134
|
+
A small piece of the domain model is shared between contexts.
|
|
135
|
+
Use when: sharing is genuinely valuable and teams coordinate well.
|
|
136
|
+
Risk: tight coupling — changes require coordination.
|
|
137
|
+
|
|
138
|
+
Customer/Supplier (Upstream/Downstream):
|
|
139
|
+
Upstream provides an API; downstream consumes it.
|
|
140
|
+
Upstream is not influenced by downstream needs.
|
|
141
|
+
Use when: one context clearly serves another.
|
|
142
|
+
Risk: downstream is at the mercy of upstream priorities.
|
|
143
|
+
|
|
144
|
+
Conformist:
|
|
145
|
+
Downstream conforms completely to upstream's model.
|
|
146
|
+
Use when: upstream cannot be influenced; not worth translating.
|
|
147
|
+
Risk: downstream model polluted by upstream concerns.
|
|
148
|
+
|
|
149
|
+
Anti-Corruption Layer (ACL):
|
|
150
|
+
Downstream translates upstream's model into its own language.
|
|
151
|
+
Use when: upstream model is messy or conflicts with your domain.
|
|
152
|
+
Cost: translation code to maintain.
|
|
153
|
+
|
|
154
|
+
Open Host Service (OHS):
|
|
155
|
+
Context provides a well-defined, stable protocol for any consumer.
|
|
156
|
+
Use when: many contexts depend on this one.
|
|
157
|
+
Combined with Published Language for formal schema definition.
|
|
158
|
+
|
|
159
|
+
Published Language (PL):
|
|
160
|
+
Formal, shared language (JSON Schema, Protobuf, OpenAPI) for communication.
|
|
161
|
+
Often combined with OHS.
|
|
162
|
+
Benefit: decoupled from implementation language.
|
|
163
|
+
|
|
164
|
+
Separate Ways:
|
|
165
|
+
No integration — contexts solve the problem independently.
|
|
166
|
+
Use when: cost of integration > cost of duplication.
|
|
167
|
+
Risk: data duplication; no single source of truth.
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## Ubiquitous Language Conflicts
|
|
173
|
+
|
|
174
|
+
Document where the same term means different things across contexts:
|
|
175
|
+
|
|
176
|
+
| Term | In BC-XX | Means | In BC-YY | Means | Resolution |
|
|
177
|
+
|---|---|---|---|---|---|
|
|
178
|
+
| "Order" | BC-01 | A confirmed purchase | BC-05 | A production work order | Use "PurchaseOrder" in BC-01, "WorkOrder" in BC-05 |
|
|
179
|
+
| "User" | BC-02 | Authenticated account holder | BC-03 | Any person interacting | Define "Account" (BC-02) vs "Visitor" (BC-03) |
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## Context Integration Events
|
|
184
|
+
|
|
185
|
+
Events that cross context boundaries:
|
|
186
|
+
|
|
187
|
+
| Event Name | Emitted by | Consumed by | Payload Summary | Pattern |
|
|
188
|
+
|---|---|---|---|---|
|
|
189
|
+
| [OrderPlaced] | BC-01 | BC-04 | {orderId, customerId, total} | OHS/PL |
|
|
190
|
+
| [PaymentConfirmed] | BC-02 | BC-01, BC-04 | {paymentId, orderId, amount} | OHS/PL |
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Migration Notes
|
|
195
|
+
|
|
196
|
+
[If this context map replaces an older implicit architecture, document what changed and why]
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Design Pattern Usage
|
|
2
|
+
|
|
3
|
+
**Pattern Name**: [e.g., Strategy Pattern]
|
|
4
|
+
**Component/File**: [e.g., `PaymentProcessor.ts`]
|
|
5
|
+
|
|
6
|
+
## 1. The Problem
|
|
7
|
+
[Describe the problem that led to choosing this pattern. e.g., "We had a switch statement growing out of control for payment methods."]
|
|
8
|
+
|
|
9
|
+
## 2. The Solution
|
|
10
|
+
[Explain how the pattern solves it. e.g., "We extracted each payment method into its own class implementing a common interface."]
|
|
11
|
+
|
|
12
|
+
## 3. Implementation Details
|
|
13
|
+
- **Context**: [The class using the strategy]
|
|
14
|
+
- **Interface**: [The common interface]
|
|
15
|
+
- **Concretions**: [List of concrete implementations]
|
|
16
|
+
|
|
17
|
+
## 4. Trade-offs
|
|
18
|
+
**Pros**:
|
|
19
|
+
- [e.g., Open/Closed principle followed]
|
|
20
|
+
- [e.g., Easier to test individual strategies]
|
|
21
|
+
|
|
22
|
+
**Cons**:
|
|
23
|
+
- [e.g., Increased number of classes]
|
|
24
|
+
- [e.g., Clients must know which strategy to select]
|