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,162 @@
1
+ # Implementation Plan: [Feature Name]
2
+ <!-- Derived from: SPEC_TEMPLATE.md — do not start before spec is approved -->
3
+ <!-- Created by: prod-architect | Date: [date] -->
4
+
5
+ ---
6
+
7
+ ## 1. Overview
8
+
9
+ **Feature:** [Name]
10
+ **Spec Reference:** [link to SPEC_TEMPLATE.md]
11
+ **Estimated phases:** [N]
12
+ **Dependencies:** [External dependencies — library upgrades, other features, team dependencies]
13
+
14
+ ---
15
+
16
+ ## 2. Implementation Phases
17
+
18
+ ### Phase 1 — [Foundation / Domain Layer]
19
+ **Goal:** [What will be working after this phase]
20
+
21
+ **Files to create:**
22
+ ```
23
+ src/domain/[entity].ts - Entity definition + invariants
24
+ src/domain/events/[event].ts - Domain events
25
+ src/domain/value-objects/[vo].ts - Value objects
26
+ src/domain/ports/[repo-interface].ts - Repository interface (IRepository)
27
+ ```
28
+
29
+ **Files to modify:**
30
+ ```
31
+ [none in Phase 1 — foundation only]
32
+ ```
33
+
34
+ **Acceptance criteria for this phase:**
35
+ - [ ] Domain entity tests pass
36
+ - [ ] Value object validation tests pass
37
+ - [ ] No framework imports in domain layer
38
+
39
+ ---
40
+
41
+ ### Phase 2 — [Application Layer]
42
+ **Goal:** [What will be working after this phase]
43
+ **Depends on:** Phase 1 complete
44
+
45
+ **Files to create:**
46
+ ```
47
+ src/application/[feature]/[action]-[entity].use-case.ts
48
+ src/application/[feature]/[action]-[entity].command.ts
49
+ src/application/[feature]/[action]-[entity].result.ts
50
+ tests/unit/application/[action]-[entity].use-case.test.ts
51
+ ```
52
+
53
+ **Acceptance criteria for this phase:**
54
+ - [ ] Use case unit tests pass with mocked repository
55
+ - [ ] Use case is framework-agnostic (testable without HTTP or DB)
56
+
57
+ ---
58
+
59
+ ### Phase 3 — [Infrastructure Layer]
60
+ **Goal:** [What will be working after this phase]
61
+ **Depends on:** Phase 1 complete (needs domain interfaces)
62
+
63
+ **Files to create:**
64
+ ```
65
+ src/infrastructure/[entity]/prisma-[entity].repository.ts
66
+ prisma/migrations/[timestamp]_[migration-name]/migration.sql
67
+ ```
68
+
69
+ **Files to modify:**
70
+ ```
71
+ prisma/schema.prisma - Add new model
72
+ ```
73
+
74
+ **Acceptance criteria for this phase:**
75
+ - [ ] Repository integration tests pass against test DB
76
+ - [ ] Migration runs forward and backward without errors
77
+ - [ ] All existing tests still pass
78
+
79
+ ---
80
+
81
+ ### Phase 4 — [Adapters / API Layer]
82
+ **Goal:** [What will be working after this phase]
83
+ **Depends on:** Phase 2 and Phase 3 complete
84
+
85
+ **Files to create:**
86
+ ```
87
+ src/adapters/http/[entity].controller.ts
88
+ src/adapters/http/[entity].dto.ts - Zod schema for request validation
89
+ tests/integration/api/[entity].test.ts
90
+ ```
91
+
92
+ **Acceptance criteria for this phase:**
93
+ - [ ] POST /api/v1/[resource] returns 201 with valid input
94
+ - [ ] Returns 422 with field errors for invalid input
95
+ - [ ] Returns 401 when unauthenticated
96
+ - [ ] Integration tests pass
97
+
98
+ ---
99
+
100
+ ### Phase 5 — [Wiring / Bootstrap]
101
+ **Goal:** Full feature wired and functional end-to-end
102
+ **Depends on:** All previous phases complete
103
+
104
+ **Files to modify:**
105
+ ```
106
+ src/main/container.ts - Register new dependencies in DI container
107
+ src/main/routes.ts - Register new routes
108
+ ```
109
+
110
+ **Acceptance criteria for this phase:**
111
+ - [ ] Full end-to-end test passes (registration → login → use feature)
112
+ - [ ] All tests pass (unit + integration)
113
+ - [ ] No new circular dependencies (run madge)
114
+ - [ ] Lint and typecheck pass
115
+
116
+ ---
117
+
118
+ ## 3. Dependencies Between Phases
119
+
120
+ ```
121
+ Phase 1 (Domain)
122
+ └─> Phase 2 (Application) — depends on domain entities and interfaces
123
+ └─> Phase 3 (Infrastructure) — depends on domain interfaces
124
+
125
+ Phase 2 + Phase 3 complete
126
+ └─> Phase 4 (Adapters)
127
+
128
+ Phase 1 + 2 + 3 + 4 complete
129
+ └─> Phase 5 (Wiring)
130
+ ```
131
+
132
+ ---
133
+
134
+ ## 4. Risk & Assumptions Log
135
+
136
+ | # | Risk/Assumption | Likelihood | Impact | Mitigation |
137
+ |---|---|---|---|---|
138
+ | 1 | [Risk: Database migration may lock table] | M | H | Use pt-online-schema-change or test on production-sized dataset |
139
+ | 2 | [Assumption: Auth middleware already in place] | — | H | Verify in Phase 4 — fallback: implement basic auth in this phase |
140
+ | 3 | [Risk: External API rate limits] | L | M | Add retry with exponential backoff in infrastructure layer |
141
+
142
+ ---
143
+
144
+ ## 5. Testing Strategy per Phase
145
+
146
+ | Phase | Test Type | Command | Pass Criteria |
147
+ |---|---|---|---|
148
+ | 1 | Unit | `[test cmd] tests/unit/domain/` | All pass |
149
+ | 2 | Unit | `[test cmd] tests/unit/application/` | All pass |
150
+ | 3 | Integration | `[test cmd] tests/integration/db/` | All pass against test DB |
151
+ | 4 | Integration | `[test cmd] tests/integration/api/` | All pass |
152
+ | 5 | E2E | `[test cmd] tests/e2e/` | Happy path passes |
153
+
154
+ ---
155
+
156
+ ## 6. Approval
157
+
158
+ | Role | Name | Status | Date |
159
+ |---|---|---|---|
160
+ | Tech Lead | [name] | [APPROVED / PENDING] | [date] |
161
+
162
+ **Human approval required before decomposing into tasks (S04).**
@@ -0,0 +1,67 @@
1
+ # Project Retrospective: [Project / Milestone Name]
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Facilitator:** [name]
5
+ **Participants:** [names or roles]
6
+ **Period covered:** [start] → [end]
7
+ **Status:** Draft | Final
8
+
9
+ ---
10
+
11
+ ## 1. Metadata
12
+
13
+ | Field | Value |
14
+ |---|---|
15
+ | Project | [name] |
16
+ | Outcome | [Shipped / Cancelled / Pivoted / Ongoing] |
17
+ | Planned vs actual duration | [e.g. "6w planned, 9w actual"] |
18
+ | Team size | [N] |
19
+ | Key metrics | [e.g. defects, velocity, SLO attainment] |
20
+
21
+ ---
22
+
23
+ ## 2. Timeline
24
+
25
+ <!-- A short factual sequence of events. No blame, just what happened and when. -->
26
+
27
+ | Date | Event / milestone | Note |
28
+ |---|---|---|
29
+ | [YYYY-MM-DD] | [Kickoff / decision / incident / launch] | [ ] |
30
+ | [ ] | [ ] | [ ] |
31
+
32
+ ---
33
+
34
+ ## 3. Reflection
35
+
36
+ ### What went well
37
+ - [Practice or outcome worth repeating]
38
+ - [ ]
39
+
40
+ ### What didn't go well
41
+ - [Problem, friction, or miss]
42
+ - [ ]
43
+
44
+ ### Puzzles (things we still don't understand)
45
+ - [Open question or surprising result we couldn't explain]
46
+ - [ ]
47
+
48
+ ---
49
+
50
+ ## 4. Action Items
51
+
52
+ <!-- Every action must have a single owner and a date, or it won't happen. -->
53
+
54
+ | Action | Owner | Due | Status |
55
+ |---|---|---|---|
56
+ | [Concrete, verifiable change] | [name] | [YYYY-MM-DD] | [Open/In progress/Done] |
57
+ | [ ] | [ ] | [ ] | [ ] |
58
+
59
+ ---
60
+
61
+ ## 5. Lessons to Carry Forward
62
+
63
+ <!-- Durable lessons get promoted to CONTINUITY.md so future work inherits them.
64
+ Keep these general enough to apply beyond this one project. -->
65
+
66
+ - [Lesson to record in CONTINUITY.md]
67
+ - [ ]
@@ -0,0 +1,217 @@
1
+ # SDLC Tracker
2
+ <!-- Updated by: sdlc-checkpoint.skill | Read by: session-resume.skill, integrity-check.skill -->
3
+ <!-- Project: [Project Name] | Started: [date] -->
4
+
5
+ ---
6
+
7
+ ## Current Status
8
+
9
+ ```
10
+ Current Phase: S[XX] — [Phase Name]
11
+ Status: NOT_STARTED | IN_PROGRESS | BLOCKED | COMPLETED
12
+ Last updated: [date]
13
+ Updated by: [agent/human]
14
+ ```
15
+
16
+ ---
17
+
18
+ ## Phase Progress Board
19
+
20
+ | Phase | Name | Status | Started | Completed | Approver | Gate Criteria |
21
+ |---|---|---|---|---|---|---|
22
+ | S00 | Strategy & Discovery (Day-0) | NOT_STARTED | — | — | — | Problem statement + opportunity assessment + RICE, human GO/NO-GO |
23
+ | S01 | Requirements | NOT_STARTED | — | — | — | PRD.md with EARS, human approval |
24
+ | S02 | Design | NOT_STARTED | — | — | — | Architecture + ADRs + threat model |
25
+ | S03 | Specification | NOT_STARTED | — | — | — | Tech spec + API contracts |
26
+ | S04 | Tasks | NOT_STARTED | — | — | — | All tasks decomposed to 15-min units |
27
+ | S05 | Implementation | NOT_STARTED | — | — | — | All project/TASKS.md items DONE |
28
+ | S06 | Testing | NOT_STARTED | — | — | — | Tests pass, coverage ≥ 99%, 7 gates |
29
+ | S07 | Security | NOT_STARTED | — | — | — | SECURITY_CHECKLIST.md 100%, 0 critical CVEs |
30
+ | S08 | Review | NOT_STARTED | — | — | — | Human code review approved |
31
+ | S09 | Staging | NOT_STARTED | — | — | — | Deployed + smoke tests passing |
32
+ | S10 | Production | NOT_STARTED | — | — | — | Deployed + rollback documented |
33
+ | S11 | Operate & Maintain (Day-2) | NOT_STARTED | — | — | — | SLOs met, runbooks live, no critical CVEs, spend within budget |
34
+ | S12 | Evolve & Improve (Day-2) | NOT_STARTED | — | — | — | Retrospective actions logged, experiments decided, DORA/SPACE reviewed |
35
+ | S13 | Decommission & Sunset (Day-2) | NOT_STARTED | — | — | — | Deprecation approved, data archived/migrated, users notified |
36
+
37
+ **Status values:** `NOT_STARTED` | `IN_PROGRESS` | `BLOCKED` | `COMPLETED`
38
+
39
+ ---
40
+
41
+ ## Definition of Done — Per Phase
42
+
43
+ ### S00 — Strategy & Discovery (Day-0)
44
+ ```
45
+ [ ] Problem statement drafted (job-to-be-done, who hurts, why now)
46
+ [ ] Opportunity assessment complete (sizing, risks, North-Star + HEART metrics)
47
+ [ ] Market/competitive scan + Wardley map captured
48
+ [ ] Candidate bets prioritized with RICE
49
+ [ ] Human GO/NO-GO decision recorded (GO required to start S01)
50
+ [ ] SESSION_SNAPSHOT/S00_discovery.md created
51
+ ```
52
+
53
+ ### S01 — Requirements
54
+ ```
55
+ [ ] PRD.md created using PRD_TEMPLATE.md
56
+ [ ] All requirements written in EARS syntax (no "should" or "might")
57
+ [ ] Ambiguity layer completed — no unresolved questions
58
+ [ ] Out-of-scope section filled
59
+ [ ] Human explicitly approved PRD.md
60
+ [ ] SESSION_SNAPSHOT/S01_requirements.md created
61
+ [ ] AUDIT_LOG.md entry: HUMAN_APPROVED
62
+ ```
63
+
64
+ ### S02 — Design
65
+ ```
66
+ [ ] Architecture approach documented in PLAN.md
67
+ [ ] C4 Level 1+2 diagrams in docs/architecture/ (or documented exception)
68
+ [ ] ADR created for every significant technology choice
69
+ [ ] Threat model completed for ALL security-sensitive features
70
+ [ ] Human approved architecture approach
71
+ [ ] SESSION_SNAPSHOT/S02_design.md created
72
+ ```
73
+
74
+ ### S03 — Specification
75
+ ```
76
+ [ ] SPEC_TEMPLATE.md completed: domain model, API contracts, DB changes
77
+ [ ] OpenAPI spec at docs/api/openapi.yaml (or equivalent)
78
+ [ ] Migration plan documented (if DB changes)
79
+ [ ] Testing strategy defined per layer
80
+ [ ] Human approved technical specification
81
+ [ ] SESSION_SNAPSHOT/S03_specification.md created
82
+ ```
83
+
84
+ ### S04 — Tasks
85
+ ```
86
+ [ ] All PLAN.md items decomposed into TASKS_TEMPLATE.md
87
+ [ ] Each task: achievable in ~15 minutes
88
+ [ ] Each task: has testable acceptance criteria
89
+ [ ] Tasks have correct dependency ordering
90
+ [ ] No ambiguous tasks ("do the stuff" — must be specific files/functions)
91
+ [ ] SESSION_SNAPSHOT/S04_TASKS.md created
92
+ ```
93
+
94
+ ### S05 — Implementation
95
+ ```
96
+ [ ] All tasks in project/TASKS.md have status DONE (none TODO/IN_PROGRESS/BLOCKED)
97
+ [ ] TDD followed for each task: failing test written first
98
+ [ ] Each task commit references the task ID
99
+ [ ] AUDIT_LOG.md has TASK_DONE entry for each task
100
+ [ ] SESSION_SNAPSHOT/S05_implementation.md created
101
+ ```
102
+
103
+ ### S06 — Testing
104
+ ```
105
+ [ ] [test command] passes: 0 failing, 0 unexpected skips
106
+ [ ] Coverage >= 99% (run [coverage command])
107
+ [ ] Gate 1 Lint: 0 errors
108
+ [ ] Gate 2 Typecheck: 0 errors
109
+ [ ] Gate 3 Coverage: >= 99%
110
+ [ ] Gate 4 Integration: Docker Compose tests pass
111
+ [ ] Gate 5 Security: npm/composer audit clean (0 critical/high CVEs)
112
+ [ ] Gate 6 Complexity: max cyclomatic complexity < 10
113
+ [ ] Gate 7 EARS compliance: all requirements have tests
114
+ [ ] agentic-linter: 0 architecture violations
115
+ [ ] SESSION_SNAPSHOT/S06_testing.md created
116
+ ```
117
+
118
+ ### S07 — Security
119
+ ```
120
+ [ ] security-audit.skill run on full codebase
121
+ [ ] SECURITY_CHECKLIST.md 100% complete
122
+ [ ] 0 critical CVEs in dependencies
123
+ [ ] 0 high CVEs unresolved (or risk accepted by human)
124
+ [ ] gitleaks detect: CLEAN (no secrets in git)
125
+ [ ] All threat model mitigations implemented
126
+ [ ] Human security approval
127
+ [ ] SESSION_SNAPSHOT/S07_security.md created
128
+ ```
129
+
130
+ ### S08 — Review
131
+ ```
132
+ [ ] PR created with complete description
133
+ [ ] Human reviewer has reviewed all changes
134
+ [ ] All reviewer comments addressed
135
+ [ ] No "RESOLVE LATER" comments (all blocking feedback resolved)
136
+ [ ] PR approved and merge ready
137
+ [ ] SESSION_SNAPSHOT/S08_review.md created
138
+ ```
139
+
140
+ ### S09 — Staging
141
+ ```
142
+ [ ] Deployed to staging environment
143
+ [ ] Database migrations applied to staging
144
+ [ ] Smoke tests passing (health check + core user flows)
145
+ [ ] No error spike in monitoring after deploy
146
+ [ ] Performance within acceptable range
147
+ [ ] SESSION_SNAPSHOT/S09_staging.md created
148
+ ```
149
+
150
+ ### S10 — Production
151
+ ```
152
+ [ ] Production deploy completed
153
+ [ ] Database migrations applied to production
154
+ [ ] Smoke tests passing in production
155
+ [ ] Monitoring/alerting active for new feature
156
+ [ ] Rollback plan documented and verified
157
+ [ ] No error spike in first 30 minutes post-deploy
158
+ [ ] SESSION_SNAPSHOT/S10_production.md created
159
+ [ ] Git tag: v[semver] created
160
+ ```
161
+
162
+ ### S11 — Operate & Maintain (Day-2)
163
+ ```
164
+ [ ] Observability stack live (metrics/logs/traces, dashboards, SLOs)
165
+ [ ] Runbooks authored per service (RUNBOOK_TEMPLATE.md)
166
+ [ ] On-call rotation + error-budget policy defined
167
+ [ ] Dependency/patch cadence running; 0 open critical CVEs
168
+ [ ] SLO adherence report green; cost within budget
169
+ [ ] SESSION_SNAPSHOT/S11_operate.md created
170
+ ```
171
+
172
+ ### S12 — Evolve & Improve (Day-2)
173
+ ```
174
+ [ ] Blameless retrospective held; action items logged
175
+ [ ] Product analytics reviewed (funnels, retention, North-Star movement)
176
+ [ ] A/B experiments planned and each has a decision (ship/iterate/kill)
177
+ [ ] Tech-debt paydown items fed back into the backlog/S04
178
+ [ ] DORA + SPACE metrics reviewed; stale feature flags retired
179
+ [ ] SESSION_SNAPSHOT/S12_evolve.md created
180
+ ```
181
+
182
+ ### S13 — Decommission & Sunset (Day-2)
183
+ ```
184
+ [ ] Deprecation policy + timeline approved
185
+ [ ] Data retention/migration executed; archives + final backups taken
186
+ [ ] Users notified; migration paths communicated
187
+ [ ] Infra torn down safely; no live dependents remain
188
+ [ ] License/contract/vendor wind-down confirmed
189
+ [ ] SESSION_SNAPSHOT/S13_sunset.md created
190
+ ```
191
+
192
+ ---
193
+
194
+ ## Current Blockers
195
+
196
+ | Blocker | Since | Waiting for | Owner |
197
+ |---|---|---|---|
198
+ | [description] | [date] | [decision/person/event] | [name] |
199
+
200
+ ---
201
+
202
+ ## Upcoming Milestones
203
+
204
+ | Milestone | Target Date | Dependencies |
205
+ |---|---|---|
206
+ | PRD approved (S01) | [date] | Stakeholder availability |
207
+ | Ready to code (S04) | [date] | S01+S02+S03 complete |
208
+ | Feature complete (S05) | [date] | All tasks |
209
+ | Production deploy (S10) | [date] | S06-S09 gates |
210
+
211
+ ---
212
+
213
+ ## History
214
+
215
+ | Date | Phase | Event | By |
216
+ |---|---|---|---|
217
+ | [date] | S00 | Kit initialized | setup-context.sh |
@@ -0,0 +1,168 @@
1
+ # Session Snapshot — S[XX]_[PHASE_NAME]
2
+ <!-- Created by: sdlc-checkpoint.skill -->
3
+ <!-- Store in: agents/memory/episodic/SESSION_SNAPSHOT/S[XX]_[phase].md -->
4
+ <!-- IMMUTABLE after creation — never overwrite, create new snapshot for revisions -->
5
+
6
+ ---
7
+
8
+ **Snapshot ID:** S[XX]-[YYYYMMDD]-[HH]
9
+ **Timestamp:** [ISO 8601: 2025-03-15T14:30:00Z]
10
+ **SDLC Phase:** S[XX] — [Phase Name: REQUIREMENTS/DESIGN/SPEC/TASKS/IMPLEMENTATION/TESTING/SECURITY/REVIEW/STAGING/PRODUCTION]
11
+ **Created by:** [agent persona name or "human"]
12
+ **Project:** [Project name from AGENTS.md]
13
+
14
+ ---
15
+
16
+ ## 1. Current Project State
17
+
18
+ ```
19
+ SDLC Phase: S[XX] — [Phase Name]
20
+ Phase status: COMPLETED / IN_PROGRESS
21
+ Gate criteria met: YES / NO (if NO, explain)
22
+ Overall progress: [X]/10 phases complete
23
+ Confidence: HIGH / MEDIUM / LOW
24
+ ```
25
+
26
+ ---
27
+
28
+ ## 2. What Was Decided / Built This Phase
29
+
30
+ <!-- Summary of the key work done since the last snapshot -->
31
+
32
+ **Key decisions:**
33
+ - [Decision 1: e.g., "Chose Prisma as ORM — see ADR-003"]
34
+ - [Decision 2: e.g., "Deferred multi-currency support to v2 — PRD updated"]
35
+
36
+ **Key artifacts produced:**
37
+ - [Artifact 1: e.g., "PRD.md with 12 EARS requirements — human approved 2025-03-15"]
38
+ - [Artifact 2: e.g., "PLAN.md with 5 implementation phases"]
39
+ - [Artifact 3: e.g., "ADR-001 to ADR-003 in docs/architecture/decisions/"]
40
+
41
+ **Key code changes:**
42
+ - [e.g., "Implemented CreateUserUseCase — all 8 unit tests passing"]
43
+ - [e.g., "Database migration: added users table + email_verified_at column"]
44
+
45
+ ---
46
+
47
+ ## 3. Artifact Status
48
+
49
+ | Artifact | Status | Location | Notes |
50
+ |---|---|---|---|
51
+ | PRD.md | exists / MISSING | docs/PRD.md | Human approved [date] |
52
+ | SPEC.md | exists / MISSING | docs/SPEC.md | — |
53
+ | PLAN.md | exists / MISSING | docs/PLAN.md | — |
54
+ | project/TASKS.md | [N/M tasks done] | project/TASKS.md | [N] TODO, [N] IN_PROGRESS, [N] DONE, [N] BLOCKED |
55
+ | ADRs | [N] created | docs/architecture/decisions/ | Latest: ADR-[NNN] |
56
+ | Threat models | [N] created | docs/security/threat-models/ | — |
57
+ | OpenAPI spec | exists / MISSING | docs/api/openapi.yaml | — |
58
+
59
+ ---
60
+
61
+ ## 4. Test Status
62
+
63
+ ```
64
+ Last run: [ISO datetime or "never"]
65
+ Pass: [N]
66
+ Fail: [0] (must be 0 at checkpoint)
67
+ Skip: [0] (or documented reason for each skip)
68
+ Coverage: [X]% (must be >= 99% at S06+)
69
+
70
+ Flaky tests: [none / list any known flaky tests]
71
+ Last test cmd: [exact command run]
72
+ ```
73
+
74
+ ---
75
+
76
+ ## 5. Quality Gate Status
77
+
78
+ | Gate | Status | Last Run | Score/Notes |
79
+ |---|---|---|---|
80
+ | Gate 1: Lint | PASS/FAIL | [date] | [0 errors] |
81
+ | Gate 2: Typecheck | PASS/FAIL | [date] | [0 errors] |
82
+ | Gate 3: Coverage | PASS/FAIL | [date] | [X]% |
83
+ | Gate 4: Integration | PASS/FAIL | [date] | [N] endpoints tested] |
84
+ | Gate 5: Security scan | PASS/FAIL | [date] | [0 critical CVEs] |
85
+ | Gate 6: Complexity | PASS/FAIL | [date] | [max complexity: X] |
86
+ | Gate 7: EARS compliance | PASS/FAIL | [date] | [N/M requirements covered] |
87
+
88
+ ---
89
+
90
+ ## 6. Security Status
91
+
92
+ ```
93
+ Last security audit: [date or "not run"]
94
+ Open CVEs (critical): [0]
95
+ Open CVEs (high): [0]
96
+ SECURITY_CHECKLIST: [X]% complete
97
+ Threat models created: [N]
98
+ Last gitleaks scan: [date] — CLEAN / ISSUES FOUND
99
+ ```
100
+
101
+ ---
102
+
103
+ ## 7. Architecture Status
104
+
105
+ ```
106
+ Last agentic-linter run: [date or "not run"]
107
+ Architecture violations: [0] (must be 0 at S06+)
108
+ Circular dependencies: [0]
109
+ ADRs for decisions: ALL / [N missing]
110
+ ```
111
+
112
+ ---
113
+
114
+ ## 8. Open Issues & Known Debt
115
+
116
+ **Blocked tasks:**
117
+ - [Task ID]: [reason it's blocked]
118
+
119
+ **Pending human decisions:**
120
+ - [Question 1: e.g., "Should we support SSO in v1 or defer to v2?"]
121
+
122
+ **Known bugs (not blocking):**
123
+ - [Bug 1: file.ts:42 — non-critical edge case]
124
+
125
+ **Tech debt backlog size:** [N items] — see TECH_DEBT_TEMPLATE.md
126
+
127
+ ---
128
+
129
+ ## 9. Memory Pointers
130
+
131
+ <!-- Help the next session quickly find key context -->
132
+
133
+ **Key ADRs to read:**
134
+ - ADR-[NNN]: [topic — link]
135
+
136
+ **Key CONTINUITY.md entries relevant to next phase:**
137
+ - [Any past failures that the next phase should be aware of]
138
+
139
+ **Semantic knowledge to load:**
140
+ - [Key facts in agents/memory/semantic/ relevant to continuing work]
141
+
142
+ ---
143
+
144
+ ## 10. Next Actions
145
+
146
+ <!-- Ordered list of what needs to happen next to advance the project -->
147
+
148
+ 1. [First thing to do in the next session]
149
+ 2. [Second thing]
150
+ 3. [Third thing]
151
+
152
+ **Next phase entry criteria:**
153
+ - [ ] [What must be true to start Phase S[XX+1]]
154
+ - [ ] [Human approval received for: X]
155
+
156
+ ---
157
+
158
+ ## 11. Gate Criteria — Verified This Checkpoint
159
+
160
+ <!-- Document what was checked and confirmed for this phase gate -->
161
+
162
+ - [x] [criterion 1 — verified]
163
+ - [x] [criterion 2 — verified]
164
+ - [ ] [criterion 3 — NOT MET (reason)]
165
+
166
+ **Gate PASSED: YES / NO**
167
+
168
+ If NO: list what must be done before this checkpoint is valid.
@@ -0,0 +1,52 @@
1
+ # Strategic System Analysis: [System Name]
2
+
3
+ ## 1. The Iceberg Model
4
+
5
+ ### Events (What happened?)
6
+ * [Event 1]
7
+ * [Event 2]
8
+
9
+ ### Patterns (What trends are occurring?)
10
+ * [Trend 1]
11
+ * [Trend 2]
12
+
13
+ ### Structures (What influences the patterns?)
14
+ * **Physical:** (Architecture, Network)
15
+ * **Process:** (CI/CD, Code Review, Sprints)
16
+ * **Organizational:** (Team incentives, Silos)
17
+
18
+ ### Mental Models (What assumptions drive the structure?)
19
+ * "We must ship features fast to survive."
20
+ * "Testing slows us down."
21
+
22
+ ---
23
+
24
+ ## 2. Causal Loop Analysis
25
+
26
+ **Key Variables:**
27
+ 1. Variable A
28
+ 2. Variable B
29
+
30
+ **Loops:**
31
+
32
+ * **Loop 1 (Reinforcing/Balancing): [Name]**
33
+ * A increases B
34
+ * B decreases C
35
+ * C increases A
36
+ * *Result:* Oscillation / Explosion
37
+
38
+ *(Insert Mermaid diagram here if possible)*
39
+
40
+ ---
41
+
42
+ ## 3. Leverage Points
43
+
44
+ | Intervention | Leverage (Low/Med/High) | Expected Impact |
45
+ |---|---|---|
46
+ | Change Parameter X | Low | Small stabilization |
47
+ | Change Feedback Loop Y | Medium | Faster correction |
48
+ | Change Goal of System | High | Fundamental shift |
49
+
50
+ ## 4. Archetype
51
+ **Identified Trap:** [e.g., Fixes that Fail]
52
+ **Way Out:** [Strategy to break the trap]