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,104 @@
1
+ # Tasks: [Feature Name]
2
+ <!-- Atomic task breakdown — 15-minute rule: if a task takes > 15 min, decompose further -->
3
+ <!-- Derived from: PLAN_TEMPLATE.md | Created by: prod-tech-lead | Date: [date] -->
4
+
5
+ ---
6
+
7
+ ## Status Legend
8
+
9
+ ```
10
+ TODO - Not started
11
+ IN_PROGRESS - Currently being worked on (max 1 task in this state)
12
+ DONE - Completed and verified (tests pass)
13
+ BLOCKED - Cannot proceed — reason documented below
14
+ ```
15
+
16
+ ---
17
+
18
+ ## Phase 1 — [Domain Layer]
19
+
20
+ | ID | Task | Status | Acceptance Criteria | Notes |
21
+ |---|---|---|---|---|
22
+ | T-001 | Create `src/domain/[entity].ts` — define entity interface | TODO | TypeScript interface defined, no framework imports | |
23
+ | T-002 | Create `src/domain/value-objects/[Email].ts` — validation logic | TODO | VO rejects invalid values, constructor is private | |
24
+ | T-003 | Write tests for `[Entity]` domain invariants | TODO | All invariants tested: null, empty, too long, invalid format | |
25
+ | T-004 | Write tests for `[ValueObject]` validation | TODO | Tests cover valid, invalid (each error case), edge cases | |
26
+ | T-005 | Create `src/domain/ports/i-[entity]-repository.ts` — interface | TODO | Interface has: findById, save, findByEmail, delete | |
27
+ | T-006 | Create `src/domain/events/[entity]-created.event.ts` | TODO | Event has: type, payload, occurredAt | |
28
+
29
+ ## Phase 2 — [Application Layer]
30
+
31
+ | ID | Task | Status | Acceptance Criteria | Notes |
32
+ |---|---|---|---|---|
33
+ | T-007 | Create `Create[Entity]Command` DTO | TODO | All required fields, typed, validated | |
34
+ | T-008 | Create `Create[Entity]UseCase` skeleton | TODO | Constructor injects I[Entity]Repository, IEventBus | |
35
+ | T-009 | Write unit test: valid input creates entity | TODO | TDD Red — test written before implementation | |
36
+ | T-010 | Write unit test: invalid email returns error | TODO | TDD Red | |
37
+ | T-011 | Write unit test: duplicate email returns error | TODO | TDD Red | |
38
+ | T-012 | Implement `Create[Entity]UseCase.execute()` | TODO | All 3 tests pass Green | |
39
+ | T-013 | Verify use case has no framework imports | TODO | `madge --circular` passes, no express/prisma/etc imports | |
40
+
41
+ ## Phase 3 — [Infrastructure Layer]
42
+
43
+ | ID | Task | Status | Acceptance Criteria | Notes |
44
+ |---|---|---|---|---|
45
+ | T-014 | Add `[Entity]` to `prisma/schema.prisma` | TODO | Schema validates: `prisma validate` passes | |
46
+ | T-015 | Create migration: `add_[entity]_table` | TODO | `prisma migrate dev` runs without error | |
47
+ | T-016 | Test migration rollback | TODO | Rollback runs without error, schema is clean | |
48
+ | T-017 | Create `Prisma[Entity]Repository` implementing `I[Entity]Repository` | TODO | All interface methods implemented | |
49
+ | T-018 | Write integration test: `findById` returns correct entity | TODO | Test runs against real test database | |
50
+ | T-019 | Write integration test: `save` persists entity | TODO | Entity retrievable after save | |
51
+ | T-020 | Write integration test: `findByEmail` returns entity or null | TODO | Both found and not-found cases tested | |
52
+
53
+ ## Phase 4 — [Adapters / API Layer]
54
+
55
+ | ID | Task | Status | Acceptance Criteria | Notes |
56
+ |---|---|---|---|---|
57
+ | T-021 | Create Zod schema for `Create[Entity]Request` | TODO | Schema validates: required fields, email format, max lengths | |
58
+ | T-022 | Create `[Entity]Controller.create()` method | TODO | Validates input, calls use case, returns 201 or 422 | |
59
+ | T-023 | Write integration test: POST with valid body → 201 | TODO | TDD Red first, then implement | |
60
+ | T-024 | Write integration test: POST without auth → 401 | TODO | TDD Red | |
61
+ | T-025 | Write integration test: POST with invalid email → 422 | TODO | TDD Red, check field-level errors in response | |
62
+ | T-026 | Write integration test: POST with missing required field → 422 | TODO | TDD Red | |
63
+ | T-027 | Implement controller to pass all 4 integration tests | TODO | All tests Green | |
64
+
65
+ ## Phase 5 — [Wiring]
66
+
67
+ | ID | Task | Status | Acceptance Criteria | Notes |
68
+ |---|---|---|---|---|
69
+ | T-028 | Register `Prisma[Entity]Repository` in DI container | TODO | Container resolves `I[Entity]Repository` correctly | |
70
+ | T-029 | Register `Create[Entity]UseCase` in DI container | TODO | Use case receives dependencies via DI | |
71
+ | T-030 | Register route: `POST /api/v1/[resource]` | TODO | Route exists in router, calls controller | |
72
+ | T-031 | Run full test suite — all pass | TODO | Zero failing tests, coverage >= 99% | |
73
+ | T-032 | Run agentic-linter — no boundary violations | TODO | `dependency-cruiser` or `madge --circular` output clean | |
74
+ | T-033 | Run typecheck — zero errors | TODO | `tsc --noEmit` clean | |
75
+ | T-034 | Run lint — zero errors | TODO | `eslint` or `pint` clean | |
76
+ | T-035 | Manual smoke test: full create [entity] flow | TODO | Feature works end-to-end in development environment | |
77
+
78
+ ---
79
+
80
+ ## Blocked Tasks
81
+
82
+ <!-- Document why a task is blocked and what unblocks it -->
83
+
84
+ | Task ID | Blocked by | Since | Unblocked when |
85
+ |---|---|---|---|
86
+ | [T-XXX] | [reason / pending human decision] | [date] | [what needs to happen] |
87
+
88
+ ---
89
+
90
+ ## Progress Summary
91
+
92
+ ```
93
+ Total tasks: [35]
94
+ TODO: [35]
95
+ IN_PROGRESS: [0]
96
+ DONE: [0]
97
+ BLOCKED: [0]
98
+
99
+ Phase 1: 0/6 complete
100
+ Phase 2: 0/7 complete
101
+ Phase 3: 0/7 complete
102
+ Phase 4: 0/7 complete
103
+ Phase 5: 0/8 complete
104
+ ```
@@ -0,0 +1,18 @@
1
+ # System Traceability Matrix
2
+
3
+ **Project**: [Project Name]
4
+ **Last Updated**: [YYYY-MM-DD]
5
+
6
+ | Req ID | Requirement Summary | Priority | Design Component | Implementation File(s) | Test Case ID | Status |
7
+ |---|---|---|---|---|---|---|
8
+ | REQ-001 | User must be able to login via Email/Pass | High | AuthController | `src/auth/login.ts` | `TEST-AUTH-001` | ✅ Pass |
9
+ | REQ-002 | Password must be hashed (bcrypt) | Critical | AuthMiddleware | `src/auth/utils.ts` | `TEST-AUTH-002` | ⚠️ WIP |
10
+ | REQ-003 | Failed login attempts > 5 locks account | Medium | RateLimiter | `src/middleware/rate-limit.ts` | *Missing* | ❌ Fail |
11
+
12
+ ## Legend
13
+ - **Req ID**: Unique identifier from PRD.
14
+ - **Status**:
15
+ - ✅ Pass: Implemented & Verified.
16
+ - ⚠️ WIP: In Progress.
17
+ - ❌ Fail: Implemented but failing verification.
18
+ - ⚪ Pending: Not started.
@@ -0,0 +1,46 @@
1
+ # Whiteboard & Spatial Design Template
2
+
3
+ **Purpose:** A conceptual mapping worksheet for agents to structure node-and-edge relationships *before* invoking spatial drawing tools (Miro, Draw.io). This prevents hallucinated coordinates and spaghetti logic.
4
+
5
+ ---
6
+
7
+ ## 1. Diagram Metadata
8
+ * **Diagram Name**: `[e.g., Auth Flow Context]`
9
+ * **Target MCP Platform**: `[Miro | Draw.io | SVG Render]`
10
+ * **Diagram Type**: `[C4 Container | User Journey | Wireframe | Sequence]`
11
+ * **Scale / Canvas Size**: `[e.g., 1920x1080]`
12
+
13
+ ## 2. Global Styling Preferences
14
+ * **Primary Color**: `[e.g., #0052CC (Blue)]`
15
+ * **Secondary Color**: `[e.g., #FF5630 (Red)]`
16
+ * **Font Family**: `[e.g., Inter, Arial]`
17
+ * **Shape Style**: `[Rounded rectangle / circle / cylinder (for DBs)]`
18
+
19
+ ## 3. Nodes (Entities)
20
+ List all entities that need to be drawn. **Crucial:** Approximate the (X, Y) layout to prevent overlaps.
21
+
22
+ | Node ID | Label / Text | Shape Type | Approx X | Approx Y | Notes / Security Level |
23
+ | :--- | :--- | :--- | :--- | :--- | :--- |
24
+ | `UX_1` | User/Customer | Person | 100 | 500 | Public Actor |
25
+ | `API_1` | API Gateway | RoundRect | 500 | 500 | VPC Ingress |
26
+ | `SVC_1` | Auth Service | RoundRect | 900 | 400 | Intranet |
27
+ | `DB_1` | Auth PostgreSQL | Cylinder | 1300 | 400 | High Security - Redact Strings |
28
+ | `SVC_2` | Payment Service| RoundRect | 900 | 600 | Intranet |
29
+ | `API_2` | Stripe API | Cloud | 1500 | 600 | External Service |
30
+
31
+ ## 4. Edges (Relationships)
32
+ Define how the nodes connect.
33
+
34
+ | Source ID | Target ID | Line Style | Arrow | Label (Action) |
35
+ | :--- | :--- | :--- | :--- | :--- |
36
+ | `UX_1` | `API_1` | Solid | End | 1. Sends login credentials |
37
+ | `API_1` | `SVC_1` | Solid | End | 2. Forwards payload |
38
+ | `SVC_1` | `DB_1` | Solid | End | 3. Validates hash |
39
+ | `API_1` | `SVC_2` | Solid | End | 4. Initiates checkout |
40
+ | `SVC_2` | `API_2` | Dashed | End | 5. Charges card (Async) |
41
+
42
+ ## 5. Execution Pre-Flight Checklist
43
+ - [ ] Nodes are spaced adequately (min 300px horizontal gap).
44
+ - [ ] Secrets and PII are redacted from all node texts.
45
+ - [ ] Cloud providers (AWS, Azure, GCP) use their standard icons if supported.
46
+ - [ ] Read-only connections are marked as dashed lines; write/execute as solid lines.
@@ -0,0 +1,38 @@
1
+ # Database Schema Documentation
2
+ <!-- Physical database schema documentation -->
3
+ <!-- Updated by: db-migration.skill -->
4
+ <!-- Read by: data-engineering.skill, data-governance.skill -->
5
+
6
+ ---
7
+
8
+ ## Overview
9
+ **Database Engine**: [PostgreSQL 16 / MySQL 8 / etc.]
10
+ **Migration Tool**: [Prisma / Flyway / Alembic / etc.]
11
+ **Last Updated**: [YYYY-MM-DD]
12
+
13
+ ## Tables
14
+
15
+ ### `[table_name]`
16
+ [Brief description of what this table represents]
17
+
18
+ | Column | Type | Constraints | Description |
19
+ |---|---|---|---|
20
+ | `id` | UUID | PRIMARY KEY, Default: uuid_generate_v4() | Unique identifier |
21
+ | `created_at` | TIMESTAMP | NOT NULL, Default: NOW() | Creation timestamp |
22
+ | `updated_at` | TIMESTAMP | NOT NULL, Default: NOW() | Last update timestamp |
23
+ | `[column]` | [type] | [constraints] | [description] |
24
+
25
+ **Indexes**:
26
+ - `idx_[table]_[column]` on `([column])`
27
+
28
+ **Relations**:
29
+ - Belongs to `[other_table]` via `[foreign_key]`
30
+
31
+ ---
32
+
33
+ ## Enum Types
34
+ ### `[enum_name]`
35
+ - `[VALUE_1]`
36
+ - `[VALUE_2]`
37
+
38
+ ---
@@ -0,0 +1,44 @@
1
+ # Data Pipeline Design: [Pipeline Name]
2
+
3
+ **Frequency**: [Real-time / Hourly / Daily]
4
+ **Source**: [Source System]
5
+ **Destination**: [Warehouse Table]
6
+ **Owner**: [Team Name]
7
+
8
+ ## 1. Overview
9
+ [Description of what data is moving and why.]
10
+
11
+ ## 2. Data Flow
12
+ - **Ingestion**: [Kafka Topic / S3 Landing Zone / API Pull]
13
+ - **Transformation**: [Spark Job / dbt Model / SQL Stored Proc]
14
+ - **Loading**: [Append / Merge / Overwrite]
15
+
16
+ ## 3. Schema
17
+ ### Source Schema
18
+ ```json
19
+ { "id": "int", "event_time": "timestamp", ... }
20
+ ```
21
+
22
+ ### Target Schema (Warehouse)
23
+ ```sql
24
+ CREATE TABLE marts.dim_customers (
25
+ customer_sk STRING,
26
+ ...
27
+ )
28
+ ```
29
+
30
+ ## 4. Data Quality & Validation
31
+ - **Freshness**: Data must arrive within [X] minutes.
32
+ - **Completeness**: [Check: row_count > 0]
33
+ - **Uniqueness**: [Check: id is unique]
34
+ - **Handling Bad Data**: [Dead Letter Queue / Drop / Alert]
35
+
36
+ ## 5. Privacy & Governance
37
+ - **PII Fields**: [email, phone, ip_address]
38
+ - **Masking Strategy**: [SHA256 Hash / Drop / Tokenize]
39
+ - **Retention**: [X Days/Years]
40
+
41
+ ## 6. Orchestration
42
+ - **Trigger**: [Schedule / Event]
43
+ - **Dependencies**: [Upstream DAGs]
44
+ - **Retries**: [3 retries, 5m delay]
@@ -0,0 +1,52 @@
1
+ # Semantic Web & Ontology Design Template
2
+
3
+ **Domain / Subject Area:** [Domain Name]
4
+ **Date:** [YYYY-MM-DD]
5
+ **Architect / Agent:** [Agent Name]
6
+ **Base Namespace URI:** `http://example.org/ontology/[domain]#`
7
+
8
+ ## 1. Domain Overview
9
+ [Describe the business domain being modeled. E.g., This ontology models the relationships between employees, departments, and corporate assets to facilitate a unified knowledge graph.]
10
+
11
+ ## 2. Core Concepts (Classes / OWL:Class)
12
+ | Class Name | Description | Superclass (Parent) |
13
+ | :--- | :--- | :--- |
14
+ | `Employee` | A person working for the company | `Person (foaf:Person)` |
15
+ | `Department` | A structural division of the company | `Organization (schema:Organization)` |
16
+ | `Asset` | A physical or digital resource | `Thing (owl:Thing)` |
17
+
18
+ ## 3. Relationships (Object Properties / OWL:ObjectProperty)
19
+ | Property URI | Domain (Subject) | Range (Object) | Description | Inverse Property |
20
+ | :--- | :--- | :--- | :--- | :--- |
21
+ | `worksFor` | `Employee` | `Department` | Links an employee to their dept. | `hasEmployee` |
22
+ | `manages` | `Employee` | `Department` | Indicates dept. leadership | `managedBy` |
23
+ | `assignedTo` | `Asset` | `Employee` | Shows asset ownership | `ownsAsset` |
24
+
25
+ ## 4. Attributes (Datatype Properties / OWL:DatatypeProperty)
26
+ | Property URI | Domain (Subject) | Data Type | Description |
27
+ | :--- | :--- | :--- | :--- |
28
+ | `employeeId` | `Employee` | `xsd:string` | Unique identifier |
29
+ | `hireDate` | `Employee` | `xsd:date` | Date of joining |
30
+ | `budget` | `Department` | `xsd:decimal`| Annual fiscal allocation |
31
+
32
+ ## 5. Existing Ontology Reuse (External Namespaces)
33
+ *Do not reinvent the wheel. Map internal concepts to global standards.*
34
+ - `foaf:` (Friend of a Friend) - *Used for Person definitions.*
35
+ - `schema:` (Schema.org) - *Used for general organization logic.*
36
+ - `dc:` (Dublin Core) - *Used for document metadata.*
37
+
38
+ ## 6. Logic & Rules (Reasoning)
39
+ - **Transitivity**: E.g., If `AssetA` is part of `AssetB` (hasPart), and `AssetB` is part of `AssetC`, then `AssetA` is part of `AssetC`.
40
+ - **Disjointness**: E.g., `Employee` and `Asset` are defined as `owl:disjointWith` (An entity cannot be both).
41
+
42
+ ## 7. Sample RDF Output (Turtle Format)
43
+ ```turtle
44
+ @prefix ex: <http://example.org/ontology/corp#> .
45
+ @prefix foaf: <http://xmlns.com/foaf/0.1/> .
46
+
47
+ ex:JohnDoe a ex:Employee, foaf:Person ;
48
+ ex:employeeId "E12345" ;
49
+ ex:worksFor ex:EngineeringDept .
50
+
51
+ ex:EngineeringDept a ex:Department .
52
+ ```
@@ -0,0 +1,43 @@
1
+ # IEEE, ACM & ISO Engineering Standards Review
2
+
3
+ **Project/System Name:** [System Name]
4
+ **Target Standard(s):** [e.g., ISO/IEC 12207, IEEE 42010, ACM Ethics]
5
+ **Date:** [YYYY-MM-DD]
6
+ **Auditing Agent:** [Agent Name]
7
+
8
+ ## 1. Architecture Description Verification (ISO/IEC/IEEE 42010)
9
+ *Evaluates if the architecture is formally documented according to global engineering standards.*
10
+
11
+ | Requirement | Evidence in Project | Status (Pass/Fail) |
12
+ | :--- | :--- | :--- |
13
+ | **Stakeholders Identified** | [Who cares about this architecture?] | |
14
+ | **Concerns Documented** | [What are the NFRs, risks, and goals?] | |
15
+ | **Viewpoints Selected** | [e.g., Logical, Physical, Process views] | |
16
+ | **Views Created** | [Are the diagrams present that conform to the Viewpoints?] | |
17
+ | **Rationale Documented** | [Are ADRs stored locally? See `adr-writer.skill.md`] | |
18
+
19
+ ## 2. Software Life Cycle Processes (ISO/IEC/IEEE 12207)
20
+ *Evaluates if the SDLC is mature, predictable, and measurable.*
21
+
22
+ - **Requirements Analysis**: Are requirements unambiguously documented? (SWEBOK KA: Software Requirements)
23
+ - **Software Construction**: Is there a defined coding standard applied via CI/CD linting? (SWEBOK KA: Software Construction)
24
+ - **Software Configuration Management**: Are all artifacts (code, docs, tests) version-controlled? (SWEBOK KA: SCM)
25
+ - **Software Quality**: Is test-driven development or high-coverage test automation enforced? (SWEBOK KA: Software Quality)
26
+
27
+ ## 3. ACM Code of Ethics and Professional Conduct
28
+ *The moral and ethical implications of the software.*
29
+
30
+ ### 3.1 Contribute to Society and Human Well-being
31
+ - Does the system respect the rights of all end-users? [Evaluate accessibility and inclusion]
32
+ - Does the software algorithm minimize bias? [Identify any ML/AI decision-making logic]
33
+
34
+ ### 3.2 Avoid Harm
35
+ - **Data Privacy**: Are user telemetry and PII securely hashed/encrypted? [Check against `privacy-data-protection.skill.md`]
36
+ - **System Failure Contingency**: If this system goes offline, what is the human impact? [Evaluate failover states]
37
+
38
+ ### 3.3 Honor Confidentiality
39
+ - Does the system employ Principle of Least Privilege (PoLP) for internal access?
40
+
41
+ ## 4. Specific Technical Standards (If Applicable)
42
+ - **IEEE 754 (Floating-Point Arithmetic)**: [If building a financial or scientific system, verify that decimal rounding is not prone to floating-point truncation errors. Use `BigDecimal` or equivalent safe types.]
43
+ - **IEEE 1012 (Verification and Validation)**: [Is there a formal Traceability Matrix linking Code -> Tests -> Requirements?]
@@ -0,0 +1,53 @@
1
+ # FHIR & Health Data Integration Template
2
+
3
+ **System Name:** [Name of the Health App / Integration]
4
+ **FHIR Version:** [e.g., R4 (Current Stable)]
5
+ **Date:** [YYYY-MM-DD]
6
+ **Architect / Agent:** [Agent Name]
7
+
8
+ ## 1. Integration Objective
9
+ [Describe what clinical data is being moved, and why. e.g., "Pulling lab results from an Epic EHR to display in a patient-facing mobile application."]
10
+
11
+ ## 2. Resource Mapping
12
+ *Map internal app data models to standard FHIR resources.*
13
+
14
+ | Internal Data Entity | FHIR Resource | Supported Search Parameters | Profile / Implementation Guide |
15
+ | :--- | :--- | :--- | :--- |
16
+ | User Profile | `Patient` | `_id`, `name`, `birthdate` | US Core Patient |
17
+ | Doctor Visit | `Encounter` | `patient`, `date` | Standard R4 |
18
+ | Lab Result | `Observation` | `patient`, `category=laboratory` | US Core Laboratory Result |
19
+ | Prescription | `MedicationRequest` | `patient`, `status` | Standard R4 |
20
+
21
+ ## 3. Communication Patterns
22
+ - [ ] **RESTful API**: Standard synchronous CRUD operations over HTTP.
23
+ - [ ] **Subscriptions (Webhooks)**: Asynchronous notifications when a resource changes (e.g., an EHR pinging your app when a new lab result is ready).
24
+ - [ ] **Messaging / Bulk Data**: Managing gigabytes of population health data via NDJSON (Flat FHIR).
25
+
26
+ ## 4. Security & Compliance (SMART on FHIR)
27
+ - **Authentication**: OAuth2.0 standard flow.
28
+ - **Authorization Scopes**: [Define exact clinical scopes required, e.g., `patient/Observation.read`, `patient/Patient.read`. Do not use wildcard `*` scopes.]
29
+ - **Audit Logging**: [Describe how access to PHI is logged and retained for 7 years to meet HIPAA/GDPR requirements.]
30
+
31
+ ## 5. Terminology & Coding Systems
32
+ *Clinical data relies on standard vocabularies.*
33
+ - **Diagnoses / Conditions**: ICD-10 or SNOMED CT
34
+ - **Lab Tests / Observations**: LOINC
35
+ - **Medications**: RxNorm (US) or SNOMED (International)
36
+
37
+ ## 6. Sample Payload (Mock Data)
38
+ ```json
39
+ {
40
+ "resourceType": "Patient",
41
+ "id": "example-1",
42
+ "active": true,
43
+ "name": [
44
+ {
45
+ "use": "official",
46
+ "family": "Smith",
47
+ "given": [ "John" ]
48
+ }
49
+ ],
50
+ "gender": "male",
51
+ "birthDate": "1970-01-01"
52
+ }
53
+ ```
@@ -0,0 +1,45 @@
1
+ # Global Standards & Public-Sector Audit Template
2
+
3
+ **Project/System Name:** [System Name]
4
+ **Target Sector/Deployment:** [e.g., EU Gov, UN NGO, Public Enterprise]
5
+ **Date:** [YYYY-MM-DD]
6
+ **Auditor / Agent:** [Agent Name]
7
+
8
+ ## 1. United Nations Sustainable Development Goals (SDGs)
9
+ *How does this software impact the broader global community?*
10
+
11
+ | SDG Mandate | Software Application / Output | Compliance Check |
12
+ | :--- | :--- | :--- |
13
+ | **Goal 9: Industry & Infrastructure** | [Does the software provide open APIs? Is it resilient to internet outages?] | [Pass/Fail] |
14
+ | **Goal 10: Reduced Inequalities** | [Does the UI adhere to WCAG 2.1 AA+? Is there multi-language support?] | [Pass/Fail] |
15
+ | **Goal 12: Responsible Consumption**| [Has a Green Software SCI report been generated? See Green Tech skill] | [Pass/Fail] |
16
+
17
+ ## 2. ITU-T Telecommunication Standards
18
+ *Verify protocols that cross international borders.*
19
+
20
+ - **X.509 (PKI / Security)**:
21
+ - Are all TLS certificates using currently approved cyphers (e.g., no SHA-1 signatures)? [Yes/No]
22
+ - Is mutual TLS (mTLS) required for inter-service communication? [Yes/No]
23
+ - **E.164 (Numbering)**:
24
+ - Are all database columns storing phone numbers enforcing E.164 format (e.g., `+447123456789`)? [Yes/No]
25
+ - **H-Series / Audio-Visual**:
26
+ - [Specify codecs used if manipulating media files (e.g., H.265/HEVC)]
27
+
28
+ ## 3. Global Open Source (OSI & OpenSSF)
29
+ *Verify the supply chain and legal standing of the software.*
30
+
31
+ ### 3.1 License Compatibility (OSI Approved)
32
+ - **Primary Codebase License**: [e.g., Apache 2.0 / Proprietary]
33
+ - **Dependency Risk**: Are there any strict Copyleft dependencies (e.g., AGPLv3) compiled into this proprietary codebase that could force open-sourcing the parent project? [Yes/No/Mitigated]
34
+
35
+ ### 3.2 Supply-Chain Levels for Software Artifacts (SLSA)
36
+ - **Source Build**: Is the build process fully scripted and running on a hardened CI/CD runner? (SLSA L1/L2)
37
+ - **Provenance**: Does the build system generate an unforgeable attestation statement? (SLSA L3)
38
+ - **Two-Person Review**: Is branch protection enabled requiring multiple approvals before merging to Main? [Yes/No]
39
+
40
+ ## 4. International Privacy Addendum
41
+ - Has the architecture been reviewed against the strictest common denominators for global privacy?
42
+ - GDPR (European Union)
43
+ - CCPA (California)
44
+ - HIPAA (US Healthcare) if applicable
45
+ *Note: If specific regional compliance is needed, invoke the `compliance-review` skill.*
@@ -0,0 +1,59 @@
1
+ # Industrial IoT (IIoT) & Telemetry Architecture Template
2
+
3
+ **System/Factory:** [Factory or System Name]
4
+ **Date:** [YYYY-MM-DD]
5
+ **Architect / Agent:** [Agent Name]
6
+ **Throughput Target:** [e.g., 50,000 messages/sec]
7
+
8
+ ## 1. Network Topology (Purdue Model)
9
+ *Map the physical deployment levels and the protocols crossing boundaries.*
10
+
11
+ ### Operational Technology (OT) Layer (Levels 0-2)
12
+ - **PLCs/Sensors**: [e.g., Siemens S7, Modbus RTU, IO-Link]
13
+ - **Local Protocol**: [e.g., OPC UA, Ethernet/IP, Profinet]
14
+ - **Data Collection Rate**: [e.g., 100ms polling]
15
+
16
+ ### Edge / Fog Layer (Level 3)
17
+ - **Edge Gateway Hardware**: [e.g., IPC, Cisco IE, Raspberry Pi Compute]
18
+ - **Edge Processing**: [e.g., Protocol Translation (OPC UA -> MQTT), Data Aggregation, Edge ML Inference]
19
+ - **Local Historian**: [Is there a fallback time-series DB if cloud goes offline? e.g., InfluxDB Edge]
20
+
21
+ ### IT / Cloud Layer (Levels 4-5)
22
+ - **Cloud Broker**: [e.g., AWS IoT Core, Azure IoT Hub, HiveMQ]
23
+ - **Ingestion Protocol**: [e.g., MQTT over TLS 1.2]
24
+
25
+ ## 2. Topic Architecture (MQTT)
26
+ *Define the structured payload topics for the broker.*
27
+
28
+ **Standard Topic Format**: `[Namespace]/[Site]/[Area]/[AssetGroup]/[Asset]/[Topic]`
29
+
30
+ | Topic Example | Publisher | Subscriber(s) | QoS | Description |
31
+ | :--- | :--- | :--- | :--- | :--- |
32
+ | `acme/plant_1/line_a/pump/102/telemetry` | Edge Gateway | Cloud DB, Alert Engine | `1` | Real-time sensor metrics (Vibration, Temp) |
33
+ | `acme/plant_1/line_a/pump/102/command` | Cloud App | Edge Gateway | `1` | Start/Stop control signals (Extreme Caution) |
34
+ | `acme/plant_1/+/+/+/alarms` | Edge Gateway | Cloud Alert Engine | `2` | High-priority fault notifications |
35
+
36
+ ## 3. Payload Schema (JSON Snippet)
37
+ *Standardized edge payload combining timestamps, metadata, and sensor values.*
38
+ ```json
39
+ {
40
+ "timestamp": "2026-03-01T14:05:01.332Z",
41
+ "asset_id": "pump-102",
42
+ "site_id": "plant_1",
43
+ "telemetry": {
44
+ "vibration_hz": 45.2,
45
+ "temperature_c": 72.1,
46
+ "rpm": 1450
47
+ },
48
+ "status": "active"
49
+ }
50
+ ```
51
+
52
+ ## 4. Security Enforcement (Edge-to-Cloud)
53
+ - **Authentication**: [e.g., X.509 Device Certificates minted by AWS IoT]
54
+ - **Authorization**: [e.g., IoT Policies restricting publish access strictly to the assigned asset Topic tree]
55
+ - **Encryption**: Over-the-wire encryption via TLS 1.2.
56
+
57
+ ## 5. Data Storage Strategy
58
+ - **Hot Data (0-30 days)**: [e.g., Time-Series Database (InfluxDB) for fast dashboard querying]
59
+ - **Cold Data (30+ days)**: [e.g., S3 Glacier / Parquet for ML model training]
@@ -0,0 +1,50 @@
1
+ # Telecom Network & API Architecture Template
2
+
3
+ **System/Project Name:** [e.g., 5G IoT Fleet Provisioning]
4
+ **Layer:** [OSS, BSS, or Network Exposure]
5
+ **Date:** [YYYY-MM-DD]
6
+ **Architect / Agent:** [Agent Name]
7
+
8
+ ## 1. Architectural Overview
9
+ [Describe the business intent of the integration. e.g., "Allowing an enterprise fleet management system to dynamically request higher 5G bandwidth (QoD) for autonomous trucks."]
10
+
11
+ ## 2. Standards & API Mapping
12
+
13
+ ### 2.1 TM Forum Open Digital Architecture (ODA)
14
+ *Identify the ODA Functional Block this systems resides in (e.g., Core Commerce, Production, Intelligence).*
15
+
16
+ | Business Function | Required TMF Open API | Direction | Payload Type |
17
+ | :--- | :--- | :--- | :--- |
18
+ | Product Catalog Sync | `TMF620 - Product Catalog` | Consumer | JSON/REST |
19
+ | New SIM Activation | `TMF622 - Product Order` | Provider | JSON/REST |
20
+ | Billing / Usage | `TMF635 - Usage Management` | Provider | JSON/REST |
21
+
22
+ ### 2.2 Network Exposure (GSMA CAMARA)
23
+ *Which native network capabilities are exposed to third parties?*
24
+
25
+ | Network Capability | CAMARA API | Justification |
26
+ | :--- | :--- | :--- |
27
+ | Priority Bandwidth | Quality on Demand (QoD) | Guarantee latency for drone control |
28
+ | Geo-Fencing | Device Location | Verify device is inside the factory premises |
29
+ | Anti-Fraud | SIM Swap | Ensure the SIM wasn't hijacked before an auth event |
30
+
31
+ ### 2.3 IoT / Devices (GSMA Standards)
32
+ - [ ] Physical SIM (UICC)
33
+ - [ ] eSIM / eUICC Consumer (SGP.22)
34
+ - [ ] eSIM / eUICC M2M or IoT (SGP.02 / SGP.32)
35
+ *Integration Point*: [e.g., SM-DP+ (Subscription Manager Data Preparation) for over-the-air profile downloads.]
36
+
37
+ ## 3. Communication & Security
38
+
39
+ ### API Gateway / Service Mesh
40
+ - **Authentication**: [e.g., OAuth2 via OpenID Connect (OIDC)]
41
+ - **API Monetization**: [How are these API calls billed? e.g., Apigee Monetization limits]
42
+ - **Throttling/Quotas**: [Critical: Define strict limits to prevent core network signaling storms.]
43
+
44
+ ### Data Privacy (CPNI / GDPR)
45
+ - [Detail the data masking techniques for PII and CPNI (Customer Proprietary Network Information) before data hits the analytics data lake.]
46
+
47
+ ## 4. Deployment Strategy (NFV/SDN)
48
+ - [ ] Bare Metal
49
+ - [ ] Containerized Network Function (CNF) - *Deployed on Kubernetes*
50
+ - [ ] Virtualized Network Function (VNF) - *Deployed on OpenStack/VMware*
@@ -0,0 +1,48 @@
1
+ # System Benchmark Report
2
+
3
+ **Date:** [YYYY-MM-DD]
4
+ **Environment:** [Staging / Production Clone]
5
+ **Tools Used:** [k6 / Artillery / Jmeter]
6
+ **Tester:** [Agent Name / Human]
7
+
8
+ ## 1. Executive Summary
9
+ > One-line verdict: [PASS / FAIL / WARN]
10
+ > Summary of key findings...
11
+
12
+ ## 2. Test Configuration
13
+ * **Target URL/Service:** `[URL]`
14
+ * **Duration:** `[Time]`
15
+ * **Virtual Users (VUs):** `[Count]`
16
+ * **Ramp-up Pattern:** `[Description]`
17
+
18
+ ## 3. Results Summary
19
+
20
+ | Metric | Target (NFR) | Measured | Status |
21
+ |---|---|---|---|
22
+ | **Avg Throughput** | 1000 RPS | [Value] | ✅/❌ |
23
+ | **Peak Throughput** | 1500 RPS | [Value] | ✅/❌ |
24
+ | **Latency p95** | < 200ms | [Value] | ✅/❌ |
25
+ | **Latency p99** | < 500ms | [Value] | ✅/❌ |
26
+ | **Error Rate** | < 0.1% | [Value] | ✅/❌ |
27
+ | **CPU Usage (Peak)** | < 80% | [Value] | ✅/❌ |
28
+ | **Memory Leak?** | No | [Yes/No] | ✅/❌ |
29
+
30
+ ## 4. Bottleneck Analysis
31
+ * **Database:** [Locks, Slow Queries, Connection Pool...]
32
+ * **Application:** [GC pauses, Event Loop lag, Thread exhaustion...]
33
+ * **Network:** [Bandwidth, Latency, Timeout...]
34
+ * **Dependencies:** [3rd party API limits...]
35
+
36
+ ## 5. Resilience Observations
37
+ *(If Chaos testing was performed)*
38
+ * **Scenario:** [e.g., Kill DB Master]
39
+ * **Recovery Time (RTO):** [Seconds]
40
+ * **Data Loss (RPO):** [Records]
41
+
42
+ ## 6. Recommendations
43
+ 1. [Action Item 1]
44
+ 2. [Action Item 2]
45
+ 3. [Action Item 3]
46
+
47
+ ## 7. Evidence
48
+ > [Attach Screenshots / Log Snippets / Grafana Links]
@@ -0,0 +1,41 @@
1
+ # Capacity & Scaling Plan
2
+
3
+ **Service**: [Name]
4
+ **Date**: [YYYY-MM-DD]
5
+ **Author**: [Name]
6
+
7
+ ## 1. Current Baseline
8
+ | Metric | Peak Value | Average | Notes |
9
+ |---|---|---|---|
10
+ | RPM | 5,000 | 1,200 | Peak at 9am EST |
11
+ | Latency p95 | 350ms | 150ms | |
12
+ | CPU Usage | 65% | 20% | |
13
+ | RAM Usage | 2GB | 1.8GB | High constant memory |
14
+ | DB Connections | 85 | 40 | Limit is 100 |
15
+
16
+ ## 2. Growth Forecast
17
+ **Scenario**: [e.g., Black Friday, New Feature Launch]
18
+ **Expected Multiplier**: [e.g., 3x Traffic]
19
+
20
+ | Metric | Projected Peak | Capacity Limit | Status |
21
+ |---|---|---|---|
22
+ | RPM | 15,000 | 20,000 (Load Tested) | ✅ Safe |
23
+ | DB Connections | 255 | 100 | ❌ **CRITICAL** |
24
+
25
+ ## 3. Bottleneck Analysis
26
+ - **Primary Bottleneck**: Database Connection Limit.
27
+ - **Secondary Bottleneck**: Memory (JVM Heap is tight).
28
+
29
+ ## 4. Mitigation Plan
30
+ 1. **Immediate**: Implement PgBouncer/RDS Prxoy to pool connections. Target: Support 1000 client conns multiplexed to 100 DB conns.
31
+ 2. **Scale Up**: Increase App Server memory to 4GB to prevent OOM.
32
+ 3. **Scale out**: Increase Read Replicas from 1 to 2.
33
+
34
+ ## 5. Cost Impact
35
+ - Previous Monthly: $500
36
+ - New Monthly: $850 (+70%)
37
+ - Justification: Loss of service during lunch would cost ~$5k/min.
38
+
39
+ ## 6. Sign-off
40
+ - [ ] Engineering Lead
41
+ - [ ] SRE Lead