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.
Files changed (502) hide show
  1. package/LICENSE +25 -0
  2. package/LICENSE-CODE +202 -0
  3. package/README.md +817 -0
  4. package/agents/AGENTS.md +542 -0
  5. package/agents/CONSTITUTION.md +188 -0
  6. package/agents/guides/00-index.md +142 -0
  7. package/agents/guides/ai/a2ui-protocols.md +71 -0
  8. package/agents/guides/ai/actor-agent-frameworks.md +82 -0
  9. package/agents/guides/ai/agent-communication.md +146 -0
  10. package/agents/guides/ai/agent-identity-trust.md +69 -0
  11. package/agents/guides/ai/agent-only-cognition.md +73 -0
  12. package/agents/guides/ai/agent-only-swarms.md +70 -0
  13. package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
  14. package/agents/guides/ai/agent-ui.md +106 -0
  15. package/agents/guides/ai/ai-agentic.md +309 -0
  16. package/agents/guides/ai/beyond-llms.md +60 -0
  17. package/agents/guides/ai/dynamic-capability-loading.md +121 -0
  18. package/agents/guides/ai/gabbe-innovations.md +111 -0
  19. package/agents/guides/ai/model-customization-decisions.md +78 -0
  20. package/agents/guides/ai/multi-agent-systems.md +85 -0
  21. package/agents/guides/ai/self-evolving-skills.md +137 -0
  22. package/agents/guides/ai/self-healing-summary.md +21 -0
  23. package/agents/guides/ai/visual-mcp-integration.md +106 -0
  24. package/agents/guides/architecture/api-standards.md +61 -0
  25. package/agents/guides/architecture/blockchain-dlt.md +36 -0
  26. package/agents/guides/architecture/critical-systems-arch.md +66 -0
  27. package/agents/guides/architecture/event-driven-architecture.md +39 -0
  28. package/agents/guides/architecture/microservices.md +292 -0
  29. package/agents/guides/architecture/monolith.md +303 -0
  30. package/agents/guides/architecture/orchestration.md +75 -0
  31. package/agents/guides/architecture/system-qualities.md +51 -0
  32. package/agents/guides/architecture/system-scalability.md +47 -0
  33. package/agents/guides/architecture/systems-architecture.md +506 -0
  34. package/agents/guides/data/semantic-web.md +23 -0
  35. package/agents/guides/data/sql-nosql.md +305 -0
  36. package/agents/guides/industry/engineering-standards.md +36 -0
  37. package/agents/guides/industry/global-standards.md +24 -0
  38. package/agents/guides/industry/healthcare-fhir.md +33 -0
  39. package/agents/guides/industry/industrial-iot.md +33 -0
  40. package/agents/guides/industry/telecom-networks.md +34 -0
  41. package/agents/guides/languages/c-sharp.md +66 -0
  42. package/agents/guides/languages/go-lang.md +251 -0
  43. package/agents/guides/languages/java.md +73 -0
  44. package/agents/guides/languages/js-ts-nodejs.md +361 -0
  45. package/agents/guides/languages/nodejs-advanced.md +56 -0
  46. package/agents/guides/languages/php-laravel.md +376 -0
  47. package/agents/guides/languages/python-fastapi-ai.md +257 -0
  48. package/agents/guides/languages/rust.md +73 -0
  49. package/agents/guides/ops/compliance-audit.md +177 -0
  50. package/agents/guides/ops/cost-optimization.md +57 -0
  51. package/agents/guides/ops/dev-environments.md +67 -0
  52. package/agents/guides/ops/dev-workflow.md +44 -0
  53. package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
  54. package/agents/guides/ops/production-health.md +62 -0
  55. package/agents/guides/ops/troubleshooting-guide.md +69 -0
  56. package/agents/guides/patterns/agentic-design-patterns.md +308 -0
  57. package/agents/guides/patterns/agentic-patterns.md +43 -0
  58. package/agents/guides/patterns/ai-native-scenarios.md +71 -0
  59. package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
  60. package/agents/guides/patterns/design-patterns.md +68 -0
  61. package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
  62. package/agents/guides/patterns/enterprise-patterns.md +56 -0
  63. package/agents/guides/patterns/software-design-patterns.md +106 -0
  64. package/agents/guides/patterns/time-complexity-analysis.md +116 -0
  65. package/agents/guides/planning/product-requirements.md +407 -0
  66. package/agents/guides/planning/strategic-analysis.md +98 -0
  67. package/agents/guides/planning/visual-product-specs.md +162 -0
  68. package/agents/guides/principles/clean-code-standards.md +51 -0
  69. package/agents/guides/principles/computing-foundations.md +87 -0
  70. package/agents/guides/principles/diagramming-standards.md +568 -0
  71. package/agents/guides/principles/evaluation-strategy.md +103 -0
  72. package/agents/guides/principles/future-tech.md +35 -0
  73. package/agents/guides/principles/human-agent-collaboration.md +54 -0
  74. package/agents/guides/principles/legacy-tech.md +61 -0
  75. package/agents/guides/principles/mathematical-foundations.md +103 -0
  76. package/agents/guides/principles/modeling-methods.md +97 -0
  77. package/agents/guides/principles/no-code-integration.md +84 -0
  78. package/agents/guides/principles/testing-strategy.md +97 -0
  79. package/agents/guides/principles/visual-design-system.md +44 -0
  80. package/agents/guides/processes/RARV_CYCLE.md +262 -0
  81. package/agents/guides/processes/extension-protocol.md +183 -0
  82. package/agents/guides/processes/full-system-lifecycle.md +47 -0
  83. package/agents/guides/processes/knowledge-integration.md +82 -0
  84. package/agents/guides/processes/loki-sdlc-phases.md +446 -0
  85. package/agents/guides/product/green-software.md +38 -0
  86. package/agents/guides/product/sustainability-checks.md +29 -0
  87. package/agents/guides/security/ai-risk-standards-map.md +98 -0
  88. package/agents/guides/security/api-security.md +51 -0
  89. package/agents/guides/security/cryptography-standards.md +38 -0
  90. package/agents/guides/security/privacy-data-protection.md +41 -0
  91. package/agents/guides/security/secure-architecture.md +43 -0
  92. package/agents/guides/security/threat-modeling.md +46 -0
  93. package/agents/memory/AUDIT_LOG.md +48 -0
  94. package/agents/memory/CONTINUITY.md +49 -0
  95. package/agents/memory/PROJECT_STATE.md +134 -0
  96. package/agents/memory/RESUME_POINTER.md +15 -0
  97. package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
  98. package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
  99. package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
  100. package/agents/personas/00-index.md +148 -0
  101. package/agents/personas/biz-compliance.md +112 -0
  102. package/agents/personas/biz-legal.md +131 -0
  103. package/agents/personas/eng-api.md +110 -0
  104. package/agents/personas/eng-backend.md +113 -0
  105. package/agents/personas/eng-data.md +50 -0
  106. package/agents/personas/eng-database.md +95 -0
  107. package/agents/personas/eng-frontend.md +75 -0
  108. package/agents/personas/eng-infra.md +105 -0
  109. package/agents/personas/eng-messaging.md +50 -0
  110. package/agents/personas/eng-ml.md +50 -0
  111. package/agents/personas/eng-mobile.md +75 -0
  112. package/agents/personas/eng-perf.md +90 -0
  113. package/agents/personas/eng-qa.md +125 -0
  114. package/agents/personas/eng-tooling.md +49 -0
  115. package/agents/personas/ops-compliance.md +109 -0
  116. package/agents/personas/ops-cost.md +92 -0
  117. package/agents/personas/ops-devops.md +85 -0
  118. package/agents/personas/ops-incident.md +123 -0
  119. package/agents/personas/ops-monitor.md +89 -0
  120. package/agents/personas/ops-release.md +91 -0
  121. package/agents/personas/ops-security.md +104 -0
  122. package/agents/personas/ops-sre.md +85 -0
  123. package/agents/personas/orch-coordinator.md +140 -0
  124. package/agents/personas/orch-judge.md +135 -0
  125. package/agents/personas/orch-planner.md +114 -0
  126. package/agents/personas/orch-researcher.md +165 -0
  127. package/agents/personas/prod-architect.md +110 -0
  128. package/agents/personas/prod-design.md +112 -0
  129. package/agents/personas/prod-ethicist.md +50 -0
  130. package/agents/personas/prod-integration.md +120 -0
  131. package/agents/personas/prod-pm.md +115 -0
  132. package/agents/personas/prod-product-ops.md +128 -0
  133. package/agents/personas/prod-research.md +49 -0
  134. package/agents/personas/prod-safety-engineer.md +28 -0
  135. package/agents/personas/prod-tech-lead.md +119 -0
  136. package/agents/personas/ui-design.md +81 -0
  137. package/agents/scripts/check_skills_docs.py +120 -0
  138. package/agents/scripts/compile_skills.py +284 -0
  139. package/agents/scripts/comprehensive_checker.py +187 -0
  140. package/agents/scripts/dump-context.sh +37 -0
  141. package/agents/scripts/eval_skills.py +268 -0
  142. package/agents/scripts/preflight_summary.sh +80 -0
  143. package/agents/scripts/report_duplicates.py +125 -0
  144. package/agents/scripts/setup-context.ps1 +250 -0
  145. package/agents/scripts/setup-context.sh +398 -0
  146. package/agents/scripts/state_export.sh +84 -0
  147. package/agents/scripts/state_import.sh +99 -0
  148. package/agents/scripts/validate_integrity.py +98 -0
  149. package/agents/scripts/validate_links.py +96 -0
  150. package/agents/scripts/validate_methodology_graph.py +194 -0
  151. package/agents/scripts/validate_skills.py +81 -0
  152. package/agents/scripts/verify_e2e_init_flows.py +246 -0
  153. package/agents/scripts/verify_setup_simulation.py +104 -0
  154. package/agents/scripts/verify_triggers_and_mcps.py +159 -0
  155. package/agents/scripts/verify_use_cases.py +498 -0
  156. package/agents/skills/00-index.md +322 -0
  157. package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
  158. package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
  159. package/agents/skills/ai/agent-communication.skill.md +36 -0
  160. package/agents/skills/ai/agent-ui.skill.md +31 -0
  161. package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
  162. package/agents/skills/ai/beyond-llms.skill.md +31 -0
  163. package/agents/skills/ai/context-engineering.skill.md +79 -0
  164. package/agents/skills/ai/llm-as-judge.skill.md +97 -0
  165. package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
  166. package/agents/skills/ai/rag-evaluation.skill.md +93 -0
  167. package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
  168. package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
  169. package/agents/skills/architecture/api-design.skill.md +92 -0
  170. package/agents/skills/architecture/api-standards.skill.md +31 -0
  171. package/agents/skills/architecture/arch-debt.skill.md +180 -0
  172. package/agents/skills/architecture/arch-design.skill.md +304 -0
  173. package/agents/skills/architecture/arch-patterns.skill.md +52 -0
  174. package/agents/skills/architecture/arch-review.skill.md +326 -0
  175. package/agents/skills/architecture/architecture-governance.skill.md +62 -0
  176. package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
  177. package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
  178. package/agents/skills/architecture/compatibility-design.skill.md +51 -0
  179. package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
  180. package/agents/skills/architecture/design-patterns.skill.md +59 -0
  181. package/agents/skills/architecture/diagramming.skill.md +380 -0
  182. package/agents/skills/architecture/domain-model.skill.md +294 -0
  183. package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
  184. package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
  185. package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
  186. package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
  187. package/agents/skills/architecture/event-governance.skill.md +55 -0
  188. package/agents/skills/architecture/fitness-functions.skill.md +111 -0
  189. package/agents/skills/architecture/graphql-schema.skill.md +64 -0
  190. package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
  191. package/agents/skills/architecture/microservices.skill.md +31 -0
  192. package/agents/skills/architecture/middleware-design.skill.md +59 -0
  193. package/agents/skills/architecture/monolith.skill.md +31 -0
  194. package/agents/skills/architecture/realtime-comm.skill.md +52 -0
  195. package/agents/skills/architecture/state-management.skill.md +72 -0
  196. package/agents/skills/architecture/system-qualities.skill.md +31 -0
  197. package/agents/skills/architecture/system-scalability.skill.md +31 -0
  198. package/agents/skills/architecture/systems-architecture.skill.md +31 -0
  199. package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
  200. package/agents/skills/brain/README.md +70 -0
  201. package/agents/skills/brain/active-inference.skill.md +74 -0
  202. package/agents/skills/brain/brain-mode.skill.md +125 -0
  203. package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
  204. package/agents/skills/brain/cognitive-testing.skill.md +62 -0
  205. package/agents/skills/brain/consciousness-loop.skill.md +68 -0
  206. package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
  207. package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
  208. package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
  209. package/agents/skills/brain/global-workspace.skill.md +77 -0
  210. package/agents/skills/brain/learning-adaptation.skill.md +68 -0
  211. package/agents/skills/brain/loki-mode.skill.md +267 -0
  212. package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
  213. package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
  214. package/agents/skills/brain/scripts/cognition_test.py +80 -0
  215. package/agents/skills/brain/scripts/global_workspace.py +104 -0
  216. package/agents/skills/brain/self-improvement.skill.md +80 -0
  217. package/agents/skills/brain/sensory-motor.skill.md +61 -0
  218. package/agents/skills/brain/sequential-thinking.skill.md +48 -0
  219. package/agents/skills/brain/working-memory.skill.md +47 -0
  220. package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
  221. package/agents/skills/coding/artisan-commands.skill.md +52 -0
  222. package/agents/skills/coding/browser-tdd.skill.md +131 -0
  223. package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
  224. package/agents/skills/coding/ci-autofix.skill.md +53 -0
  225. package/agents/skills/coding/clean-coder.skill.md +58 -0
  226. package/agents/skills/coding/code-review.skill.md +100 -0
  227. package/agents/skills/coding/debug.skill.md +100 -0
  228. package/agents/skills/coding/documentation.skill.md +149 -0
  229. package/agents/skills/coding/eval-driven-development.skill.md +107 -0
  230. package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
  231. package/agents/skills/coding/excalidraw.skill.md +90 -0
  232. package/agents/skills/coding/file-processing.skill.md +55 -0
  233. package/agents/skills/coding/git-workflow.skill.md +153 -0
  234. package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
  235. package/agents/skills/coding/mobile-dev.skill.md +41 -0
  236. package/agents/skills/coding/nodejs-expert.skill.md +23 -0
  237. package/agents/skills/coding/output-validation.skill.md +57 -0
  238. package/agents/skills/coding/pbt-strategy.skill.md +117 -0
  239. package/agents/skills/coding/performant-ai.skill.md +62 -0
  240. package/agents/skills/coding/performant-go.skill.md +61 -0
  241. package/agents/skills/coding/performant-laravel.skill.md +70 -0
  242. package/agents/skills/coding/performant-nodejs.skill.md +67 -0
  243. package/agents/skills/coding/performant-php.skill.md +53 -0
  244. package/agents/skills/coding/performant-python.skill.md +62 -0
  245. package/agents/skills/coding/refactor.skill.md +124 -0
  246. package/agents/skills/coding/secure-coding.skill.md +57 -0
  247. package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
  248. package/agents/skills/coding/spec-driven-development.skill.md +110 -0
  249. package/agents/skills/coding/tdd-cycle.skill.md +92 -0
  250. package/agents/skills/coding/testing-strategy.skill.md +74 -0
  251. package/agents/skills/coding/time-complexity.skill.md +112 -0
  252. package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
  253. package/agents/skills/coding/tool-construction.skill.md +47 -0
  254. package/agents/skills/coding/ui-gen.skill.md +64 -0
  255. package/agents/skills/coding/vibe-coding.skill.md +63 -0
  256. package/agents/skills/coding/visual-design.skill.md +65 -0
  257. package/agents/skills/coordination/agent-interop.skill.md +72 -0
  258. package/agents/skills/coordination/agent-protocol.skill.md +62 -0
  259. package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
  260. package/agents/skills/coordination/agentic-linter.skill.md +134 -0
  261. package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
  262. package/agents/skills/coordination/meta-optimize.skill.md +62 -0
  263. package/agents/skills/coordination/meta-prompting.skill.md +46 -0
  264. package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
  265. package/agents/skills/coordination/persona-selector.skill.md +78 -0
  266. package/agents/skills/coordination/self-optimize.skill.md +81 -0
  267. package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
  268. package/agents/skills/core/agent-analytics.skill.md +74 -0
  269. package/agents/skills/core/audit-trail.skill.md +122 -0
  270. package/agents/skills/core/clarify.skill.md +89 -0
  271. package/agents/skills/core/emerging-tech.skill.md +52 -0
  272. package/agents/skills/core/empirical-methods.skill.md +101 -0
  273. package/agents/skills/core/evals/clarify.eval.yaml +29 -0
  274. package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
  275. package/agents/skills/core/evals/research.eval.yaml +23 -0
  276. package/agents/skills/core/final-review.skill.md +66 -0
  277. package/agents/skills/core/integrity-check.skill.md +149 -0
  278. package/agents/skills/core/knowledge-connect.skill.md +77 -0
  279. package/agents/skills/core/knowledge-gap.skill.md +123 -0
  280. package/agents/skills/core/preflight.skill.md +106 -0
  281. package/agents/skills/core/research.skill.md +107 -0
  282. package/agents/skills/core/retrospective.skill.md +59 -0
  283. package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
  284. package/agents/skills/core/self-heal.skill.md +163 -0
  285. package/agents/skills/core/session-resume.skill.md +125 -0
  286. package/agents/skills/core/skills-registry.skill.md +65 -0
  287. package/agents/skills/core/state-portability.skill.md +89 -0
  288. package/agents/skills/core/state-preserve.skill.md +76 -0
  289. package/agents/skills/core/system-lifecycle.skill.md +51 -0
  290. package/agents/skills/core/update-scan.skill.md +92 -0
  291. package/agents/skills/data/data-engineering.skill.md +56 -0
  292. package/agents/skills/data/data-governance.skill.md +49 -0
  293. package/agents/skills/data/db-migration.skill.md +136 -0
  294. package/agents/skills/data/semantic-web.skill.md +28 -0
  295. package/agents/skills/data/sql-optimization.skill.md +78 -0
  296. package/agents/skills/industry/engineering-standards.skill.md +31 -0
  297. package/agents/skills/industry/global-standards.skill.md +30 -0
  298. package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
  299. package/agents/skills/industry/industrial-iot.skill.md +30 -0
  300. package/agents/skills/industry/telecom-networks.skill.md +30 -0
  301. package/agents/skills/ops/caching-strategy.skill.md +77 -0
  302. package/agents/skills/ops/capacity-planning.skill.md +67 -0
  303. package/agents/skills/ops/cloud-deploy.skill.md +55 -0
  304. package/agents/skills/ops/configuration-management.skill.md +107 -0
  305. package/agents/skills/ops/cost-optimization.skill.md +39 -0
  306. package/agents/skills/ops/decommission-sunset.skill.md +64 -0
  307. package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
  308. package/agents/skills/ops/deployment.skill.md +217 -0
  309. package/agents/skills/ops/dev-environments.skill.md +31 -0
  310. package/agents/skills/ops/dev-workflow.skill.md +28 -0
  311. package/agents/skills/ops/docker-dev.skill.md +52 -0
  312. package/agents/skills/ops/enterprise-integration.skill.md +53 -0
  313. package/agents/skills/ops/feature-flag-management.skill.md +59 -0
  314. package/agents/skills/ops/incident-response.skill.md +40 -0
  315. package/agents/skills/ops/infra-devops.skill.md +53 -0
  316. package/agents/skills/ops/k8s-dev.skill.md +51 -0
  317. package/agents/skills/ops/memory-optimization.skill.md +45 -0
  318. package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
  319. package/agents/skills/ops/performance-audit.skill.md +178 -0
  320. package/agents/skills/ops/performance-optimization.skill.md +51 -0
  321. package/agents/skills/ops/production-health.skill.md +85 -0
  322. package/agents/skills/ops/production-verifier.skill.md +50 -0
  323. package/agents/skills/ops/queue-management.skill.md +52 -0
  324. package/agents/skills/ops/release-management.skill.md +39 -0
  325. package/agents/skills/ops/release-validation.skill.md +51 -0
  326. package/agents/skills/ops/reliability-sre.skill.md +51 -0
  327. package/agents/skills/ops/runbook-authoring.skill.md +64 -0
  328. package/agents/skills/ops/system-benchmark.skill.md +69 -0
  329. package/agents/skills/ops/tech-debt.skill.md +143 -0
  330. package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
  331. package/agents/skills/product/accessibility.skill.md +143 -0
  332. package/agents/skills/product/adr-writer.skill.md +110 -0
  333. package/agents/skills/product/business-case.skill.md +70 -0
  334. package/agents/skills/product/change-management.skill.md +90 -0
  335. package/agents/skills/product/decompose.skill.md +75 -0
  336. package/agents/skills/product/design-thinking.skill.md +62 -0
  337. package/agents/skills/product/estimation-sizing.skill.md +87 -0
  338. package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
  339. package/agents/skills/product/financial-governance.skill.md +88 -0
  340. package/agents/skills/product/green-software.skill.md +46 -0
  341. package/agents/skills/product/ideation-facilitation.skill.md +87 -0
  342. package/agents/skills/product/market-analysis.skill.md +56 -0
  343. package/agents/skills/product/opportunity-assessment.skill.md +89 -0
  344. package/agents/skills/product/product-analytics.skill.md +92 -0
  345. package/agents/skills/product/professional-practice.skill.md +105 -0
  346. package/agents/skills/product/req-elicitation.skill.md +292 -0
  347. package/agents/skills/product/req-review.skill.md +280 -0
  348. package/agents/skills/product/spec-analyze.skill.md +98 -0
  349. package/agents/skills/product/spec-writer.skill.md +114 -0
  350. package/agents/skills/product/stakeholder-management.skill.md +54 -0
  351. package/agents/skills/product/sustainability-checks.skill.md +29 -0
  352. package/agents/skills/product/systems-thinking.skill.md +56 -0
  353. package/agents/skills/product/user-research-synthesis.skill.md +85 -0
  354. package/agents/skills/product/user-story-mapping.skill.md +54 -0
  355. package/agents/skills/product/visual-specs.skill.md +112 -0
  356. package/agents/skills/security/access-control.skill.md +45 -0
  357. package/agents/skills/security/agent-sandboxing.skill.md +69 -0
  358. package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
  359. package/agents/skills/security/ai-red-teaming.skill.md +74 -0
  360. package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
  361. package/agents/skills/security/api-security.skill.md +31 -0
  362. package/agents/skills/security/backup-recovery.skill.md +49 -0
  363. package/agents/skills/security/compliance-review.skill.md +152 -0
  364. package/agents/skills/security/cryptography-standards.skill.md +31 -0
  365. package/agents/skills/security/dependency-security.skill.md +47 -0
  366. package/agents/skills/security/hazard-analysis.skill.md +53 -0
  367. package/agents/skills/security/legal-review.skill.md +41 -0
  368. package/agents/skills/security/log-analysis.skill.md +68 -0
  369. package/agents/skills/security/network-security.skill.md +64 -0
  370. package/agents/skills/security/privacy-audit.skill.md +137 -0
  371. package/agents/skills/security/privacy-data-protection.skill.md +31 -0
  372. package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
  373. package/agents/skills/security/reliability-engineering.skill.md +47 -0
  374. package/agents/skills/security/safety-scan.skill.md +49 -0
  375. package/agents/skills/security/secrets-management.skill.md +65 -0
  376. package/agents/skills/security/secure-architecture.skill.md +31 -0
  377. package/agents/skills/security/security-audit.skill.md +164 -0
  378. package/agents/skills/security/threat-model.skill.md +120 -0
  379. package/agents/skills/security/traceability-audit.skill.md +48 -0
  380. package/agents/templates/00-index.md +162 -0
  381. package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
  382. package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
  383. package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
  384. package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
  385. package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
  386. package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
  387. package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
  388. package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
  389. package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
  390. package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
  391. package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
  392. package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
  393. package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
  394. package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
  395. package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
  396. package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
  397. package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
  398. package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
  399. package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
  400. package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
  401. package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
  402. package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
  403. package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
  404. package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
  405. package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
  406. package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
  407. package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
  408. package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
  409. package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
  410. package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
  411. package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
  412. package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
  413. package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
  414. package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
  415. package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
  416. package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
  417. package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
  418. package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
  419. package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
  420. package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
  421. package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
  422. package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
  423. package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
  424. package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
  425. package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
  426. package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
  427. package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
  428. package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
  429. package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
  430. package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
  431. package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
  432. package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
  433. package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
  434. package/agents/templates/core/SDLC_TRACKER.md +217 -0
  435. package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
  436. package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
  437. package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
  438. package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
  439. package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
  440. package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
  441. package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
  442. package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
  443. package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
  444. package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
  445. package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
  446. package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
  447. package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
  448. package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
  449. package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
  450. package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
  451. package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
  452. package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
  453. package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
  454. package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
  455. package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
  456. package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
  457. package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
  458. package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
  459. package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
  460. package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
  461. package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
  462. package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
  463. package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
  464. package/agents/templates/product/NFR_TEMPLATE.md +31 -0
  465. package/agents/templates/product/PRD_TEMPLATE.md +222 -0
  466. package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
  467. package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
  468. package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
  469. package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
  470. package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
  471. package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
  472. package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
  473. package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
  474. package/agents/templates/security/HAZARD_LOG.md +17 -0
  475. package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
  476. package/agents/templates/security/SAFETY_CASE.md +39 -0
  477. package/agents/templates/security/SAFETY_POLICY.md +25 -0
  478. package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
  479. package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
  480. package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
  481. package/bin/install.js +572 -0
  482. package/docs/CLI_REFERENCE.md +527 -0
  483. package/docs/INSTALL.md +68 -0
  484. package/docs/MCP_CONFIGURATIONS.md +1765 -0
  485. package/docs/PLATFORM_CONTROLS.md +324 -0
  486. package/docs/POST_INSTALL.md +75 -0
  487. package/docs/QUICK_COMMANDS.md +131 -0
  488. package/docs/QUICK_GUIDE.md +914 -0
  489. package/docs/README_FULL.md +1451 -0
  490. package/docs/SCHEMA.md +164 -0
  491. package/docs/V1_RELEASE_CHECKLIST.md +144 -0
  492. package/docs/VERIFICATION_GUIDE.md +283 -0
  493. package/docs/adr/0001-record-architecture-decisions.md +26 -0
  494. package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
  495. package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
  496. package/docs/assets/GABBE.png +0 -0
  497. package/docs/gabbe.config.example.json +9 -0
  498. package/docs/reports/duplication-report.md +30 -0
  499. package/install.ps1 +90 -0
  500. package/install.sh +89 -0
  501. package/package.json +49 -0
  502. 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]