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,40 @@
1
+ # Cost Optimization Report
2
+ **Date:** [YYYY-MM-DD]
3
+ **Scope:** [AWS/GCP/Azure/All]
4
+ **Reviewer:** [Agent Name]
5
+
6
+ ## Executive Summary
7
+ | Total Spend/Month | Estimated Waste | Potential Savings | ROI |
8
+ |---|---|---|---|
9
+ | $X,XXX | $XXX | $XXX | X% |
10
+
11
+ ## 1. Idle Resources (Immediate Action)
12
+ These resources are running but unused (CPU < 5% for 7 days).
13
+
14
+ | Resource ID | Service | Cost/Month | Recommendation | Savings |
15
+ |---|---|---|---|---|
16
+ | `i-0123456789` | EC2 | $45.00 | Terminate | $45.00 |
17
+ | `vol-0987654` | EBS | $12.00 | Snapshot & Delete | $11.50 |
18
+
19
+ ## 2. Over-Provisioned Resources
20
+ These resources are used, but larger than necessary.
21
+
22
+ | Resource ID | Service | Current Size | utilization | Recommended Size | Savings |
23
+ |---|---|---|---|---|---|
24
+ | `db-prod-01` | RDS | db.r5.2xlarge | 12% Max CPU | db.r5.large | $350.00 |
25
+
26
+ ## 3. Storage Optimization
27
+ Data that can be moved to colder storage.
28
+
29
+ | Bucket Name | Total Size | Current Class | Recommendation | Est. Savings |
30
+ |---|---|---|---|---|
31
+ | `logs-2023` | 5 TB | Standard | Glacier Deep Archive | $110.00 |
32
+
33
+ ## 4. Architecture Modernization (Long Term)
34
+ - Switch [Service A] to Lambda/Serverless?
35
+ - Use Spot Instances for [Workload B]?
36
+
37
+ ## Action Plan
38
+ 1. [ ] Terminate idle resources (Risk: Low)
39
+ 2. [ ] Resize RDS instance (Risk: Medium - requires maintenance window)
40
+ 3. [ ] Apply Lifecycle Policy to S3 buckets (Risk: Low)
@@ -0,0 +1,102 @@
1
+ # Decommission / Sunset Plan: [Service / Product Name]
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Owner:** [name or team]
5
+ **Approver:** [name]
6
+ **Status:** Draft | Approved | In progress | Complete
7
+
8
+ <!-- Sunsetting is a project, not an afterthought. Plan the wind-down with the
9
+ same rigor as a launch. Communicate early; remove last. -->
10
+
11
+ ---
12
+
13
+ ## 1. Summary
14
+
15
+ **What is being decommissioned:** [System and its scope.]
16
+ **Why:** [Reason — replaced by X / low usage / cost / risk.]
17
+ **Replacement (if any):** [Where users go instead.]
18
+
19
+ ---
20
+
21
+ ## 2. Deprecation Timeline
22
+
23
+ | Milestone | Date | Notes |
24
+ |---|---|---|
25
+ | Announce deprecation | [YYYY-MM-DD] | [Public/internal] |
26
+ | Feature freeze (no new signups) | [ ] | [ ] |
27
+ | Migration window opens | [ ] | [ ] |
28
+ | Read-only / degraded mode | [ ] | [ ] |
29
+ | Hard shutdown | [ ] | [ ] |
30
+ | Final teardown | [ ] | [ ] |
31
+
32
+ ---
33
+
34
+ ## 3. Affected Users & Communications
35
+
36
+ | Audience | Count / segment | First notice | Reminder cadence | Channel | Owner |
37
+ |---|---|---|---|---|---|
38
+ | [internal teams] | [ ] | [ ] | [e.g. T-90, T-30, T-7, T-1] | [ ] | [ ] |
39
+ | [external customers] | [ ] | [ ] | [ ] | [ ] | [ ] |
40
+
41
+ ---
42
+
43
+ ## 4. Data: Retention, Migration, Export
44
+
45
+ | Data set | Owner | Action (migrate/export/delete) | Destination / format | Deadline |
46
+ |---|---|---|---|---|
47
+ | [ ] | [ ] | [ ] | [ ] | [ ] |
48
+
49
+ **Self-serve export:** [How users get their own data out before shutdown.]
50
+ **Retention obligations:** [Legal/compliance minimums that override deletion.]
51
+
52
+ ---
53
+
54
+ ## 5. Archival
55
+
56
+ - [ ] Code repository archived (read-only) at [location].
57
+ - [ ] Final data snapshot stored at [location], retention [period].
58
+ - [ ] Documentation / runbooks archived.
59
+ - [ ] Configuration & secrets recorded then revoked.
60
+
61
+ ---
62
+
63
+ ## 6. License / Contract Wind-Down
64
+
65
+ | Item | Vendor / counterparty | Action | Notice required | Deadline | Owner |
66
+ |---|---|---|---|---|---|
67
+ | [SaaS subscription] | [ ] | [cancel/downgrade] | [e.g. 30d] | [ ] | [ ] |
68
+ | [domain / cert] | [ ] | [ ] | [ ] | [ ] | [ ] |
69
+
70
+ ---
71
+
72
+ ## 7. Traffic Drain Steps
73
+
74
+ <!-- Drain gradually so problems surface while rollback is still possible. -->
75
+
76
+ 1. Redirect [X]% of traffic to replacement / error page: `[command]`
77
+ 2. Lower DNS TTL ahead of cutover: `[command]`
78
+ 3. Increase drain to 100%; keep service warm for rollback: `[command]`
79
+ 4. Disable inbound; monitor for stragglers: `[command]`
80
+
81
+ ---
82
+
83
+ ## 8. Final Teardown Checklist
84
+
85
+ - [ ] All traffic drained; zero live requests for [N] days.
86
+ - [ ] Compute / containers stopped and deleted.
87
+ - [ ] Databases snapshotted, then deprovisioned.
88
+ - [ ] DNS records removed.
89
+ - [ ] Secrets / API keys / IAM roles revoked.
90
+ - [ ] Monitoring, alerts, and on-call rotation removed.
91
+ - [ ] Billing confirmed stopped.
92
+ - [ ] Index/registry entries pointing at this service removed.
93
+
94
+ ---
95
+
96
+ ## 9. Post-Sunset Verification
97
+
98
+ - [ ] No traffic or errors observed in [N] days post-teardown.
99
+ - [ ] No orphaned cloud resources still billing (cost report checked).
100
+ - [ ] No broken references in dependent systems.
101
+ - [ ] Stakeholders notified of completion.
102
+ - [ ] Lessons recorded for future decommissions.
@@ -0,0 +1,88 @@
1
+ # Deployment Configuration Snippets
2
+
3
+ Copy the relevant section to your project root.
4
+
5
+ ---
6
+
7
+ ## 1. Vercel (`vercel.json`)
8
+ Use for frontend frameworks (Next.js, React, Vue) and Serverless Functions.
9
+
10
+ ```json
11
+ {
12
+ "framework": "nextjs",
13
+ "buildCommand": "npm run build",
14
+ "outputDirectory": ".next",
15
+ "rewrites": [
16
+ { "source": "/api/:path*", "destination": "https://api.example.com/:path*" }
17
+ ],
18
+ "headers": [
19
+ {
20
+ "source": "/(.*)",
21
+ "headers": [
22
+ { "key": "X-Content-Type-Options", "value": "nosniff" },
23
+ { "key": "X-Frame-Options", "value": "DENY" }
24
+ ]
25
+ }
26
+ ],
27
+ "regions": ["iad1"],
28
+ "cleanUrls": true
29
+ }
30
+ ```
31
+
32
+ ---
33
+
34
+ ## 2. Railway (`railway.toml`)
35
+ Use for backend services (Node, Go, Python, Docker) and Databases.
36
+
37
+ ```toml
38
+ [build]
39
+ builder = "nixpacks"
40
+ buildCommand = "npm run build"
41
+
42
+ [deploy]
43
+ startCommand = "npm start"
44
+ healthcheckPath = "/health"
45
+ healthcheckTimeout = 100
46
+ restartPolicyType = "on-failure"
47
+
48
+ [service]
49
+ name = "my-backend-service"
50
+ ```
51
+
52
+ ---
53
+
54
+ ## 3. SST (`sst.config.ts`)
55
+ Use for AWS Serverless (Lambda, DynamoDB, API Gateway).
56
+
57
+ ```typescript
58
+ import { SSTConfig } from "sst";
59
+ import { NextjsSite, Table } from "sst/constructs";
60
+
61
+ export default {
62
+ config(_input) {
63
+ return {
64
+ name: "my-sst-app",
65
+ region: "us-east-1",
66
+ };
67
+ },
68
+ stacks(app) {
69
+ app.stack(function Site({ stack }) {
70
+ const table = new Table(stack, "Notes", {
71
+ fields: {
72
+ pk: "string",
73
+ sk: "string",
74
+ },
75
+ primaryIndex: { partitionKey: "pk", sortKey: "sk" },
76
+ });
77
+
78
+ const site = new NextjsSite(stack, "site", {
79
+ bind: [table],
80
+ });
81
+
82
+ stack.addOutputs({
83
+ SiteUrl: site.url,
84
+ });
85
+ });
86
+ },
87
+ } satisfies SSTConfig;
88
+ ```
@@ -0,0 +1,39 @@
1
+ # Incident Postmortem: [Incident Title]
2
+
3
+ **Date**: [YYYY-MM-DD]
4
+ **Authors**: [Names]
5
+ **Status**: [Draft / Review / Completed]
6
+ **Severity**: [SEV1 / SEV2 / SEV3]
7
+
8
+ ## Executive Summary
9
+ *Briefly describe what happened, the impact (users affected), and the root cause.*
10
+
11
+ ## Impact
12
+ - **Downtime Duration**: [HH:MM]
13
+ - **User Impact**: [X% of users experienced errors]
14
+ - **Data Impact**: [Data loss / Corruption / Latency]
15
+
16
+ ## Timeline
17
+ | Time (UTC) | Description |
18
+ |---|---|
19
+ | 10:00 | Alert fired: High Error Rate > 5% |
20
+ | 10:05 | On-call Engineer acknowledged |
21
+ | 10:15 | Rollback initiated |
22
+ | 10:20 | Service recovered |
23
+
24
+ ## Root Cause Analysis (5 Whys)
25
+ 1. **Why did the system fail?** (e.g., DB CPU spiked to 100%)
26
+ 2. **Why did the DB CPU spike?** (e.g., New deployment added a query)
27
+ 3. **Why was the query slow?** (e.g., Missing index on `user_id`)
28
+ 4. **Why was the index missing?** (e.g., Migration script failed but didn't error out)
29
+ 5. **Why did the deployment proceed?** (e.g., Pipeline ignores migration warnings)
30
+
31
+ ## Lessons Learned
32
+ - **What went well?** (e.g., Alerting was fast)
33
+ - **What went wrong?** (e.g., Rollback took too long)
34
+ - **Where did we get lucky?**
35
+
36
+ ## Action Items
37
+ - [ ] [Fix] Add missing index to DB.
38
+ - [ ] [Prevent] Fail pipeline on migration warnings.
39
+ - [ ] [Detect] Add alert for high DB CPU.
@@ -0,0 +1,37 @@
1
+ # Infrastructure Plan: [System Name]
2
+
3
+ **Status**: [Draft/Review/Approved]
4
+ **Cost Estimate**: [$X/month]
5
+ **Cloud Provider**: [AWS/GCP/Azure]
6
+
7
+ ## 1. High-Level Architecture
8
+ [Insert Diagram Link]
9
+
10
+ ## 2. Compute Strategy
11
+ - **Workload Type**: [Stateless Web / Batch / Stateful DB]
12
+ - **Service**: [EKS / Lambda / EC2 / CloudRun]
13
+ - **Scaling**: [HPA settings / Auto-scaling Group rules]
14
+
15
+ ## 3. Data Storage
16
+ - **Relational**: [RDS Postgres / Cloud SQL]
17
+ - **NoSQL**: [DynamoDB / Firestore]
18
+ - **Object Storage**: [S3 / GCS]
19
+ - **Backup Policy**: [PITR retention period, Snapshot frequency]
20
+
21
+ ## 4. Networking & Security
22
+ - **VPC**: [CIDR blocks, Subnet layout]
23
+ - **Exposure**: [Public ALB / Private Link]
24
+ - **WAF**: [Rulesets enabled]
25
+ - **IAM**: [Key roles and policies]
26
+
27
+ ## 5. Observability
28
+ - **Logs**: [CloudWatch / Datadog]
29
+ - **Metrics**: [Prometheus / CloudWatch]
30
+ - **Tracing**: [OpenTelemetry / X-Ray]
31
+
32
+ ## 6. Cost Analysis
33
+ | Resource | Count | Type | Est. Cost |
34
+ |---|---|---|---|
35
+ | EC2 | 2 | t3.medium | $30 |
36
+ | RDS | 1 | db.t3.medium | $60 |
37
+ | **Total** | | | **$90** |
@@ -0,0 +1,35 @@
1
+ # Release Readiness Report
2
+
3
+ **Release**: [vX.Y.Z]
4
+ **Date**: [YYYY-MM-DD]
5
+ **Decision**: [GO / NO-GO]
6
+
7
+ ## 1. Executive Summary
8
+ - **Status**: [Green/Red]
9
+ - **Risks**: [Top 3 risks]
10
+ - **Feature Completeness**: [100%]
11
+
12
+ ## 2. Gate Status
13
+ | Gate | Status | Notes |
14
+ |---|---|---|
15
+ | 1. Requirements | ✅ | All Traceable |
16
+ | 2. Architecture | ✅ | ADR-005 Approved |
17
+ | 3. Code Quality | ✅ | Clean Linter |
18
+ | 4. Tests | ✅ | 145/145 Pass |
19
+ | 5. Security | ⚠️ | 1 Low Sev (Accepted) |
20
+ | 6. Performance | ✅ | p95 < 200ms |
21
+ | 7. UAT / E2E | ✅ | Verified by PO |
22
+
23
+ ## 3. Third-Party Validation
24
+ - **Penetration Test**: [Pass/Fail/Date]
25
+ - **Compliance Audit**: [Pass/Fail/Date]
26
+
27
+ ## 4. Rollback Plan
28
+ - **Trigger**: Error Rate > 1% in first 10 mins.
29
+ - **Method**: Atomic Revert via Vercel/K8s.
30
+ - **Owner**: [Name]
31
+
32
+ ## 5. Signatures
33
+ - **Product Owner**: [Sign]
34
+ - **Tech Lead**: [Sign]
35
+ - **QA Lead**: [Sign]
@@ -0,0 +1,103 @@
1
+ # Runbook: [Alert / Scenario Name]
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Owner:** [team or on-call rotation]
5
+ **Last validated:** [YYYY-MM-DD]
6
+ **Status:** Draft | Active
7
+
8
+ <!-- A runbook is for a tired on-call engineer at 3am. Every step must be
9
+ copy-pasteable, unambiguous, and safe. Prefer commands over prose. -->
10
+
11
+ ---
12
+
13
+ ## 1. At a Glance
14
+
15
+ | Field | Value |
16
+ |---|---|
17
+ | Alert name | [Exact alert/monitor name as it fires] |
18
+ | Severity | [SEV1 / SEV2 / SEV3] |
19
+ | Service | [Affected service] |
20
+ | Owning team | [ ] |
21
+
22
+ **Symptom:** [What the alert is actually telling you, in plain language.]
23
+
24
+ **Impact / blast radius:** [Who and what is affected? e.g. "All checkout requests fail; ~X% of revenue at risk."]
25
+
26
+ ---
27
+
28
+ ## 2. Diagnosis
29
+
30
+ <!-- Numbered, copy-pasteable. Each step should narrow down the cause. -->
31
+
32
+ 1. Confirm the alert is real (not flapping):
33
+ ```
34
+ [command to check current state]
35
+ ```
36
+ 2. Check upstream dependency health:
37
+ ```
38
+ [command]
39
+ ```
40
+ 3. Inspect recent deploys/changes:
41
+ ```
42
+ [command]
43
+ ```
44
+ 4. Check error logs:
45
+ ```
46
+ [command]
47
+ ```
48
+
49
+ **Decision point:** [How to tell which remediation path applies.]
50
+
51
+ ---
52
+
53
+ ## 3. Remediation
54
+
55
+ > Choose the path matching your diagnosis.
56
+
57
+ **Path A — [cause]:**
58
+ ```
59
+ [step-by-step commands]
60
+ ```
61
+
62
+ **Path B — [cause]:**
63
+ ```
64
+ [step-by-step commands]
65
+ ```
66
+
67
+ ---
68
+
69
+ ## 4. Rollback
70
+
71
+ <!-- The safe undo. When in doubt, roll back first, investigate later. -->
72
+ ```
73
+ [exact rollback command(s)]
74
+ ```
75
+ **Rollback verification:** [How to confirm the rollback took effect.]
76
+
77
+ ---
78
+
79
+ ## 5. Escalation Path
80
+
81
+ | Level | Who | Contact | When to escalate |
82
+ |---|---|---|---|
83
+ | L1 | [Primary on-call] | [channel/page] | [ ] |
84
+ | L2 | [Service owner] | [ ] | [If not resolved in N min] |
85
+ | L3 | [Eng lead / incident commander] | [ ] | [SEV1 / data loss] |
86
+
87
+ ---
88
+
89
+ ## 6. Verification (Resolved)
90
+
91
+ - [ ] Alert cleared and stays cleared for [N] minutes.
92
+ - [ ] Key metric back within SLO: [metric + bound].
93
+ - [ ] No new related errors in logs.
94
+ - [ ] Incident notes recorded; follow-up ticket filed if needed.
95
+
96
+ ---
97
+
98
+ ## 7. Related Dashboards & Links
99
+
100
+ - **Dashboard:** [name — where to find it]
101
+ - **SLO / metric:** [name]
102
+ - **Related runbooks:** [name only]
103
+ - **Architecture / ADR:** [reference by name or ADR number]
@@ -0,0 +1,102 @@
1
+ # Tech Debt Backlog
2
+ <!-- Maintained by: tech-debt.skill | Updated: [date] -->
3
+ <!-- Priority: P1 (High Impact + Low Effort) | P2 (High Impact + High Effort) | P3 (Low + Low) | P4 (Low + High) -->
4
+
5
+ ---
6
+
7
+ ## Active Debt Items
8
+
9
+ ### TD-[NNN]: [Short Title]
10
+
11
+ **Debt ID:** TD-[NNN]
12
+ **Type:** Code | Test | Architecture | Security | Dependency | Documentation
13
+ **Location:** `[file path]:[line number]`
14
+ **Detected:** [date] by [tech-debt.skill / code review / etc]
15
+ **Status:** OPEN | IN_PROGRESS | RESOLVED
16
+
17
+ **Description:**
18
+ [What is the debt? What is wrong with the current implementation?]
19
+
20
+ **Why it's debt:**
21
+ [What principle or best practice is being violated?
22
+ e.g., "Cyclomatic complexity is 18 — exceeds limit of 10.
23
+ Makes the function hard to test and modify."]
24
+
25
+ **Impact** (H/M/L): [H]
26
+ [How does this debt slow down development or create risk?
27
+ e.g., "Blocks all team members trying to add payment features.
28
+ Any change to this function causes unexpected failures."]
29
+
30
+ **Effort to fix** (H/M/L): [L]
31
+ [How much work is required to resolve this debt?
32
+ e.g., "Extract 3 validation functions — ~2 hours of focused work."]
33
+
34
+ **Priority:** P[1/2/3/4]
35
+ [P1 = High Impact + Low Effort | P2 = High Impact + High Effort
36
+ P3 = Low Impact + Low Effort | P4 = Low Impact + High Effort]
37
+
38
+ **Proposed fix:**
39
+ [Concrete approach to resolving this debt item]
40
+
41
+ ```
42
+ Example:
43
+ 1. Extract validateEmail() from UserController.update()
44
+ 2. Extract validateAge() from UserController.update()
45
+ 3. Extract validatePhone() from UserController.update()
46
+ 4. Update tests to cover each extracted function independently
47
+ ```
48
+
49
+ **Acceptance criteria:**
50
+ - [ ] [Cyclomatic complexity of target function drops below 10]
51
+ - [ ] [All existing tests still pass]
52
+ - [ ] [New unit tests for each extracted function]
53
+ - [ ] [No new circular dependencies]
54
+
55
+ **Related PR/commit:** [link when resolved]
56
+
57
+ ---
58
+
59
+ ## Resolved Debt Items
60
+
61
+ | ID | Title | Type | Resolved Date | PR/Commit |
62
+ |---|---|---|---|---|
63
+ | TD-001 | [Example: Extracted UserValidator from Controller] | Code | [date] | [link] |
64
+
65
+ ---
66
+
67
+ ## Debt Backlog Summary
68
+
69
+ | Priority | Count | Total Effort |
70
+ |---|---|---|
71
+ | P1 (Do now) | [0] | [0h] |
72
+ | P2 (Plan next sprint) | [0] | [0d] |
73
+ | P3 (Good first issues) | [0] | [0h] |
74
+ | P4 (Deprioritize) | [0] | — |
75
+
76
+ ---
77
+
78
+ ## Debt Metrics
79
+
80
+ | Metric | Current | Target | Trend |
81
+ |---|---|---|---|
82
+ | Cyclomatic complexity (max) | [X] | < 10 | [improving/stable/worsening] |
83
+ | Test coverage | [X]% | > 99% | [improving/stable/worsening] |
84
+ | Code duplication | [X]% | < 3% | [improving/stable/worsening] |
85
+ | TODO/FIXME count | [X] | 0 untracked | [improving/stable/worsening] |
86
+ | Outdated major deps | [X] | 0 | [improving/stable/worsening] |
87
+
88
+ *Last measured: [date]*
89
+
90
+ ---
91
+
92
+ ## Adding New Debt Items
93
+
94
+ Run `tech-debt.skill` to automatically scan and populate new entries.
95
+ Or add manually using the template above.
96
+
97
+ **Manual entry guidelines:**
98
+ 1. Assign next sequential ID (TD-[next number])
99
+ 2. Choose the most specific Type
100
+ 3. Score Impact AND Effort honestly (not everything is high impact)
101
+ 4. Propose a concrete fix (not "just refactor it")
102
+ 5. Define testable acceptance criteria
@@ -0,0 +1,42 @@
1
+ # Business Case: [Project Name]
2
+
3
+ > **Executive Summary:** One paragraph summarizing the problem, the recommended solution, and the expected ROI.
4
+
5
+ ---
6
+
7
+ ## 1. Problem Definition (The Why)
8
+
9
+ ### Current State (Status Quo)
10
+ * Describe the current process/system.
11
+ * **Metric:** What is the cost of the current state? (Time, money, risk)
12
+
13
+ ### The Opportunity
14
+ * What happens if we solve this?
15
+ * Alignment with Company Goals: [Goal X], [Goal Y]
16
+
17
+ ---
18
+
19
+ ## 2. Solution Options
20
+
21
+ ### Option A: Do Nothing
22
+ * **Pros:** Zero development cost.
23
+ * **Cons:** Problem persists; [Specific Con].
24
+ * **Cost:** $0 (but $X in ongoing pain).
25
+
26
+ ### Option B: [Proposed Solution]
27
+ * **Description:** [Brief description]
28
+ * **Pros:** [Pro 1], [Pro 2].
29
+ * **Cons:** [Con 1].
30
+ * **Estimated Effort:** [X] weeks.
31
+
32
+ ---
33
+
34
+ ## 3. Financial Analysis (ROI)
35
+
36
+ | Category | Description | Estimated Value ($) |
37
+ |---|---|---|
38
+ | **Benefit** | (Revenue / Savings) | $0.00 |
39
+ | **Cost** | (Dev + Infra + Maint) | $0.00 |
40
+ | **Net Value** | (Benefit - Cost) | **$0.00** |
41
+
42
+ **Recommendation:** Proceed with Option B.
@@ -0,0 +1,68 @@
1
+ # Change Management Plan (ADKAR): [Change Name]
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Sponsor:** [executive owner]
5
+ **Change lead:** [name]
6
+ **Status:** Draft | Active | Complete
7
+
8
+ <!-- Structured on the ADKAR model: Awareness, Desire, Knowledge, Ability,
9
+ Reinforcement. People move through these stages in order; a stall at any
10
+ stage stalls the whole change. -->
11
+
12
+ ---
13
+
14
+ ## 1. Change Summary
15
+
16
+ **What is changing:** [The change, in one or two sentences.]
17
+ **Why now:** [Business driver.]
18
+ **Who is affected:** [Groups / teams.]
19
+ **Success looks like:** [Observable end-state.]
20
+
21
+ ---
22
+
23
+ ## 2. Stakeholder Map
24
+
25
+ | Stakeholder / group | Impact (H/M/L) | Stance (champion/neutral/resistor) | Influence | Engagement strategy |
26
+ |---|---|---|---|---|
27
+ | [group] | [ ] | [ ] | [ ] | [ ] |
28
+ | [ ] | [ ] | [ ] | [ ] | [ ] |
29
+
30
+ ---
31
+
32
+ ## 3. ADKAR Plan
33
+
34
+ | Stage | Activities | Owner | Measure |
35
+ |---|---|---|---|
36
+ | **Awareness** (why the change) | [Comms, town halls, FAQs] | [ ] | [% who can state the why] |
37
+ | **Desire** (want to participate) | [Address WIIFM, involve influencers] | [ ] | [adoption intent / survey] |
38
+ | **Knowledge** (how to change) | [Training, docs, demos] | [ ] | [training completion] |
39
+ | **Ability** (do it in practice) | [Coaching, hands-on, support desk] | [ ] | [task success / error rate] |
40
+ | **Reinforcement** (make it stick) | [Recognition, metrics, follow-up] | [ ] | [sustained adoption over time] |
41
+
42
+ ---
43
+
44
+ ## 4. Communications Cadence
45
+
46
+ | Audience | Channel | Frequency | Message focus | Owner |
47
+ |---|---|---|---|---|
48
+ | [group] | [email/Slack/all-hands] | [ ] | [Awareness/Desire stage] | [ ] |
49
+ | [ ] | [ ] | [ ] | [ ] | [ ] |
50
+
51
+ ---
52
+
53
+ ## 5. Training Plan
54
+
55
+ | Cohort | Format | Content | When | Owner |
56
+ |---|---|---|---|---|
57
+ | [ ] | [self-serve / live / workshop] | [ ] | [ ] | [ ] |
58
+
59
+ ---
60
+
61
+ ## 6. Resistance & Risks
62
+
63
+ | Risk / source of resistance | Likelihood | Impact | Mitigation | Owner |
64
+ |---|---|---|---|---|
65
+ | [e.g. "team fears job loss"] | [ ] | [ ] | [ ] | [ ] |
66
+ | [ ] | [ ] | [ ] | [ ] | [ ] |
67
+
68
+ **Escalation:** [Who handles resistance that mitigation doesn't resolve.]