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,38 @@
1
+ # Guide: Cryptography & Secrets Management (2025)
2
+ <!-- Encryption, Hashing, Key Management, TLS -->
3
+
4
+ ---
5
+
6
+ ## 1. Data in Transit
7
+ All network communication must be encrypted.
8
+
9
+ - **Standard**: TLS 1.3 is mandatory for all external traffic. TLS 1.2 is the absolute minimum acceptable fallback.
10
+ - **Internal Traffic**: Use mTLS (Mutual TLS) within service meshes (e.g., Istio, Linkerd) so internal services authenticate each other.
11
+ - **HSTS**: Always return `Strict-Transport-Security` headers to force browsers to use HTTPS.
12
+
13
+ ## 2. Data at Rest (Encryption)
14
+ Encrypt sensitive data before storing it in databases or file systems.
15
+
16
+ - **Symmetric Encryption**: Use **AES-256-GCM** or **ChaCha20-Poly1305**. Both provide authenticated encryption (detects tampering).
17
+ - **Asymmetric Encryption**: Use **RSA-2048** (or higher) or Elliptic Curve Cryptography (**ECC**, e.g., Ed25519) for key exchange or digital signatures.
18
+ - **Database level**: Utilize provider-level Transparent Data Encryption (TDE) for full disk encryption, plus application-level encryption for highly sensitive column data (e.g., SSNs, medical data).
19
+
20
+ ## 3. Hashing (Passwords & Integrity)
21
+ Hashing is one-way. You cannot decrypt a hash.
22
+
23
+ - **Passwords**: Use **Argon2id**. If Argon2 is unavailable, use **Bcrypt** (work factor 12+). NEVER use MD5 or SHA-1 for passwords.
24
+ - **Salts**: A unique, random salt must be generated for every password.
25
+ - **Data Integrity**: Use **SHA-256** or **SHA-3** to verify file/message integrity.
26
+
27
+ ## 4. Secrets Management
28
+ API keys, database credentials, and certificates are secrets.
29
+
30
+ - **NEVER hardcode secrets in source code**.
31
+ - **NEVER commit `.env` files** containing real secrets to version control. Use `.env.example` as a template.
32
+ - **Storage**: Use dedicated secret managers (AWS Secrets Manager, HashiCorp Vault, Azure Key Vault, Google Secret Manager).
33
+ - **Access**: Applications should retrieve secrets dynamically at startup or runtime via IAM roles/identities, not hardcoded bootstrap tokens.
34
+ - **Rotation**: Design systems to support zero-downtime automated secret rotation.
35
+
36
+ ## 5. Random Number Generation
37
+ - **CSPRNG**: Always use Cryptographically Secure Pseudo-Random Number Generators (e.g., `/dev/urandom`, `crypto.randomBytes()`, `secrets` module in Python) for tokens, keys, and session IDs.
38
+ - Never use standard `Math.random()` or `rand()` for security purposes.
@@ -0,0 +1,41 @@
1
+ # Guide: Privacy & Data Protection (2025)
2
+ <!-- GDPR, CCPA, PII Handling, Data Minimization -->
3
+
4
+ ---
5
+
6
+ ## 1. Principles of Data Protection
7
+ Adhere to the core principles established by global privacy frameworks (GDPR, CCPA/CPRA, HIPAA).
8
+
9
+ ### Data Minimization
10
+ - **Rule**: Only collect data you absolutely need for the specific feature you are building.
11
+ - **Action**: Do not add "just in case" fields to user profiles (e.g., collecting Birth Date when only Age > 18 verification is needed).
12
+
13
+ ### Purpose Limitation
14
+ - **Rule**: Data collected for Purpose A cannot be used for Purpose B without explicit consent.
15
+ - **Action**: Ensure database models map data to specific user consents.
16
+
17
+ ### Privacy by Design
18
+ - **Rule**: Privacy is not an afterthought. It is embedded into the architecture.
19
+ - **Action**: Default user settings should be the most privacy-friendly option (e.g., opt-in instead of opt-out tracking).
20
+
21
+ ## 2. Handling PII (Personally Identifiable Information)
22
+ PII directly or indirectly identifies a human being (Name, Email, IP Address, Location, Device ID).
23
+
24
+ - **Logging**: **NEVER log PII**. Configure loggers to scrub emails, passwords, SSNs, and tokens before they hit stdout or centralized logging (Datadog/Splunk).
25
+ - **Encryption**: Encrypt highly sensitive PII (SSN, medical status, precise location) at the application level before writing to the database.
26
+ - **Searchability**: Encrypted PII is hard to search. Consider "Blind Indexing" (storing a deterministic hash of the data alongside the encrypted data) to allow equality searches without revealing the plaintext.
27
+
28
+ ## 3. Data Subject Rights
29
+ Your architecture must support these rights programmatically:
30
+
31
+ - **Right to Access/Portability**: Users must be able to download their data in a machine-readable format (JSON, CSV).
32
+ - **Right to Erasure (Right to be Forgotten)**: Define a clear "Hard Delete" vs "Soft Delete" policy. When a user requests deletion, PII must be scrubbed from backups within the legal time frame (usually 30 days).
33
+ - *Pattern*: Instead of deleting the relational row (which breaks foreign keys), overwrite PII fields with nulls or random UUIDs, leaving the anonymous usage data intact entirely.
34
+
35
+ ## 4. Anonymization & Pseudonymization
36
+ - **Anonymization**: Irreversible removal of PII. The data can no longer be linked to an individual. Useful for analytics.
37
+ - **Pseudonymization**: Replacing PII with an artificial identifier (e.g., substituting user ID `123` with a random hash in analytics events). Retains statistical value while protecting identity.
38
+
39
+ ## 5. Third-Party Sharing
40
+ - Validate the privacy posture of external APIs. When sending user data to Stripe, Segment, or LLMs, ensure strict Data Processing Agreements (DPAs) are in place.
41
+ - **LLMs**: Never send raw PII to public AI models (like OpenAI consumer APIs). Use Enterprise tiers with zero-retention policies or scrub PII locally before sending prompts.
@@ -0,0 +1,43 @@
1
+ # Guide: Secure Architecture & Zero Trust
2
+ <!-- Defense in Depth, Micro-segmentation, Least Privilege -->
3
+
4
+ ---
5
+
6
+ ## 1. Zero Trust Architecture (ZTA)
7
+ "Never trust, always verify."
8
+
9
+ - **The Old Perimeter Model**: A firewall protects the outside; everything inside the network is trusted. (Obsolete, highly vulnerable to lateral movement).
10
+ - **Zero Trust**: No network is implicitly trusted.
11
+ - Every user, device, and application must authenticate.
12
+ - Every connection is encrypted (mTLS).
13
+ - Access policies are dynamic, based on context (location, device health, anomalies).
14
+
15
+ ## 2. Principle of Least Privilege (PoLP)
16
+ Entities should only have the exact permissions necessary to perform their required tasks, and no more.
17
+
18
+ - **Databases**: The web application should not connect to the database as the `root` or `postgres` user. Create specific roles for read/write.
19
+ - **Cloud IAM**: Microservices must run using dedicated IAM roles (e.g., AWS Task Roles) rather than sharing long-lived broad credentials.
20
+ - **Containers**: Run Docker containers as non-root users (`USER 1000:1000` in Dockerfile). Drop unnecessary Linux capabilities.
21
+
22
+ ## 3. Defense in Depth
23
+ Implement overlapping layers of security. If one fails, another catches the breach.
24
+
25
+ 1. **Edge**: WAF (Web Application Firewall), DDoS protection, Cloudflare.
26
+ 2. **Network**: VPCs, private subnets, strict Security Groups / Network Policies.
27
+ 3. **Application**: Input validation, parameterized queries, rate limiting.
28
+ 4. **Data**: Field-level encryption, KMS, backups.
29
+ 5. **Monitoring**: Intrustion Detection Systems (IDS), audit logging, SIEM alerts.
30
+
31
+ ## 4. Secure Development Lifecycle (SDLC)
32
+ Shift security to the "Left" (early in the process).
33
+
34
+ - **SAST**: Static Application Security Testing (e.g., Semgrep, SonarQube) in CI pipelines to catch hardcoded secrets or bad patterns.
35
+ - **SCA**: Software Composition Analysis (e.g., Dependabot, Snyk) to block vulnerable open-source libraries.
36
+ - **DAST**: Dynamic Application Security Testing to scan running applications for vulnerabilities.
37
+
38
+ ## 5. Supply Chain Security
39
+ Modern apps use thousands of dependencies. You must protect the build pipeline.
40
+
41
+ - **Dependency Pinning**: Lock all dependency versions (e.g., `package-lock.json`, `requirements.txt`).
42
+ - **Reproducible Builds**: Given the same source code, the build process should always produce the exact same binary artifact.
43
+ - **Provenance**: Sign your Docker images and artifacts (e.g., Sigstore/Cosign) to prove they were generated by your trustworthy CI/CD system and not tampered with.
@@ -0,0 +1,46 @@
1
+ # Guide: Threat Modeling
2
+ <!-- STRIDE, Attack Trees, Risk Assessment -->
3
+
4
+ ---
5
+
6
+ ## 1. What is Threat Modeling?
7
+ Threat modeling is a structured process for identifying and mitigating security vulnerabilities during the architectural design phase *before* a single line of code is written.
8
+
9
+ **The Four Questions:**
10
+ 1. What are we building? (Data Flow Diagrams)
11
+ 2. What can go wrong? (STRIDE Methodology)
12
+ 3. What are we going to do about it? (Mitigations)
13
+ 4. Did we do a good enough job? (Validation)
14
+
15
+ ## 2. The STRIDE Methodology
16
+ Use STRIDE to systematically identify threats across your architecture components.
17
+
18
+ | Threat | Definition | Security Property Violated | Mitigation Example |
19
+ |---|---|---|---|
20
+ | **S**poofing | Pretending to be someone else. | Authentication | TLS, Strong Passwords, MFA, JWT. |
21
+ | **T**ampering | Modifying data maliciously. | Integrity | Hashing, Digital Signatures, Immutable Logs, TLS. |
22
+ | **R**epudiation | Denying an action took place. | Non-repudiation | Secure Audit Logs, Digital Signatures. |
23
+ | **I**nformation Disclosure | Exposing exact data to unauthorized eyes. | Confidentiality | Encryption at rest/transit, RBAC. |
24
+ | **D**enial of Service | Making the system unavailable. | Availability | Rate Limiting, WAF, Auto-scaling, Caching. |
25
+ | **E**levation of Privilege | Gaining permissions you shouldn't have. | Authorization | Principle of Least Privilege, Strict Input Validation. |
26
+
27
+ ## 3. How to Conduct a Threat Modeling Session
28
+ Best done collaboratively during Phase 0 (Planning/Design).
29
+
30
+ 1. **Draw the Diagram**: Create a Data Flow Diagram (DFD) showing External Entities, Processes, Data Stores, and Trust Boundaries (e.g., the line between public internet and internal VPC).
31
+ 2. **Brainstorm**: Walk through each component and data flow. Apply STRIDE.
32
+ * "Can an attacker *Tamper* with the data while it flows from the API Gateway to the Auth Microservice?"
33
+ 3. **Log Threats**: Record findings in an Agile backlog or a Threat Register.
34
+ 4. **Prioritize**: Use DREAD or CVSS to rank threats based on Risk (Likelihood * Impact).
35
+
36
+ ## 4. Attack Trees
37
+ For complex critical systems, use Attack Trees to model how an attacker might achieve a specific goal.
38
+
39
+ - **Root Node**: The ultimate attacker goal (e.g., "Steal Customer Database").
40
+ - **Leaf Nodes**: The methods to achieve it (e.g., "SQL Injection", "Phishing an Admin", "Finding unencrypted backup on S3").
41
+ - This helps visualize the easiest path for an attacker and prioritize mitigations for those specific leaves.
42
+
43
+ ## 5. Integrating with AI Agents
44
+ When generating architecture using AI:
45
+ - Always prompt the agent to explicitly list STRIDE threats for any proposed design.
46
+ - Example Prompt: "Generate a C4 container diagram for this feature, and identify the top 3 STRIDE threats crossing the major Trust Boundaries."
@@ -0,0 +1,48 @@
1
+ # Audit Log — [PROJECT_NAME]
2
+ <!-- APPEND ONLY — never modify or delete existing entries -->
3
+ <!-- Updated by: audit-trail.skill, orch-coordinator, sdlc-checkpoint.skill -->
4
+ <!-- Read by: session-resume.skill, orch-coordinator, humans -->
5
+
6
+ **Format version**: 1.0
7
+ **Log started**: [YYYY-MM-DD]
8
+ **Project**: [PROJECT_NAME]
9
+
10
+ ---
11
+
12
+ ## Action Type Reference
13
+
14
+ | Type | Description |
15
+ |---|---|
16
+ | `LOKI_INIT` | Loki Mode initialized for a new project |
17
+ | `SESSION_START` | New session beginning |
18
+ | `SESSION_END` | Session ending |
19
+ | `PHASE_TRANSITION` | Entering or completing an SDLC phase |
20
+ | `CHECKPOINT_SAVED` | SESSION_SNAPSHOT written |
21
+ | `TASK_DONE` | Task completed (T-NNN) |
22
+ | `TASK_BLOCKED` | Task blocked after self-heal exhausted |
23
+ | `TASK_UNBLOCKED` | Blocked task resumed after human decision |
24
+ | `QUALITY_GATE` | orch-judge quality gate result |
25
+ | `SECURITY_FINDING` | ops-security finding logged |
26
+ | `ADR_CREATED` | Architecture Decision Record created |
27
+ | `DECISION` | Significant decision made |
28
+ | `HUMAN_ESCALATION` | Human decision requested |
29
+ | `HUMAN_DECISION` | Human decision received and applied |
30
+ | `SELF_HEAL_ATTEMPT` | Self-heal iteration (attempt N of 5) |
31
+ | `SELF_HEAL_RESOLVED` | Self-heal succeeded |
32
+ | `RESEARCH_FINDING` | orch-researcher found authoritative fact |
33
+ | `ERROR` | Unexpected error encountered |
34
+ | `ROLLBACK` | Rollback executed |
35
+
36
+ ---
37
+
38
+ ## Log Entries
39
+
40
+ <!-- Each entry format:
41
+ | [ISO 8601 UTC] | [SESSION_ID] | [Actor] | [Type] | [Description] | [Outcome] | [References] |
42
+ -->
43
+
44
+ | Timestamp | Session | Actor | Type | Description | Outcome | References |
45
+ |---|---|---|---|---|---|---|
46
+ | [YYYY-MM-DDTHH:MM:SSZ] | [S001] | loki-mode | `LOKI_INIT` | Audit log initialized for [PROJECT_NAME] | OK | — |
47
+
48
+ <!-- Append new entries below this line. Never edit rows above. -->
@@ -0,0 +1,49 @@
1
+ # CONTINUITY — Project Failure Memory
2
+ <!-- Checked EVERY session start (RARV Reason Phase — mandatory) -->
3
+ <!-- Prevents agents from repeating past failed approaches -->
4
+ <!-- Append new entries. Never delete. Mark RESOLVED if superseded. -->
5
+
6
+ ---
7
+
8
+ ## How to Use This File
9
+
10
+ During RARV Reason phase, EVERY agent MUST:
11
+ 1. Scan this file for entries related to the current module or operation
12
+ 2. If relevant entry found → apply the recorded resolution WITHOUT rediscovering
13
+ 3. After a novel failure is resolved → add an entry here
14
+
15
+ Entry format:
16
+ ```
17
+ ### [Module/Area] — [Short description]
18
+ **Failed approach**: [what was tried]
19
+ **Why it failed**: [root cause]
20
+ **Resolution**: [what actually worked]
21
+ **Date**: [YYYY-MM-DD]
22
+ **Status**: ACTIVE | RESOLVED (superseded by entry #N)
23
+ ```
24
+
25
+ ---
26
+
27
+ ## Entries
28
+
29
+ *(Empty — add entries as failures are encountered and resolved)*
30
+
31
+ <!-- Example entry (delete this comment when real entries are added):
32
+
33
+ ### Auth Module — JWT token refresh race condition
34
+ **Failed approach**: Checking token expiry in middleware and refreshing inline
35
+ **Why it failed**: Concurrent requests both see expired token, both refresh, second refresh invalidates first
36
+ **Resolution**: Refresh tokens via dedicated /api/v1/auth/refresh endpoint with mutex lock in Redis
37
+ **Date**: 2026-01-15
38
+ **Status**: ACTIVE
39
+ -->
40
+
41
+ ---
42
+
43
+ ## Quick Reference — Common Failure Patterns to Avoid
44
+
45
+ *(Populated as project matures — move crystallized patterns here)*
46
+
47
+ | Pattern | Area | What to avoid | What to do instead |
48
+ |---------|------|---------------|-------------------|
49
+ | *(none yet)* | | | |
@@ -0,0 +1,134 @@
1
+ # Project State — Master SDLC Tracker
2
+ <!-- Updated by: orch-coordinator, sdlc-checkpoint.skill -->
3
+ <!-- Read by: session-resume.skill, loki-mode.skill, orch-planner -->
4
+ <!-- This is the single source of truth for current project position -->
5
+
6
+ ---
7
+
8
+ ## Project Identity
9
+
10
+ | Field | Value |
11
+ |---|---|
12
+ | **Project Name** | [PROJECT_NAME] |
13
+ | **Repository** | [git remote URL] |
14
+ | **Started** | [YYYY-MM-DD] |
15
+ | **Last Updated** | [YYYY-MM-DD HH:MM UTC] |
16
+ | **Updated by** | [agent/human] |
17
+
18
+ ---
19
+
20
+ ## Current SDLC Phase
21
+
22
+ | Field | Value |
23
+ |---|---|
24
+ | **Current Phase** | NOT_STARTED |
25
+ | **Phase Status** | — |
26
+ | **Phase Started** | — |
27
+ | **Blocking Issues** | None |
28
+
29
+ ### Phase Legend
30
+ ```
31
+ NOT_STARTED → Project initialized but no phase begun
32
+ S01_REQUIREMENTS → PRD and EARS requirements in progress
33
+ S02_DESIGN → Architecture and ADRs in progress
34
+ S03_SPEC → Technical specification in progress
35
+ S04_TASKS → Task decomposition in progress
36
+ S05_IMPLEMENTATION → Engineering execution in progress
37
+ S06_TESTING → Quality gates and coverage validation
38
+ S07_SECURITY → Security review
39
+ S08_REVIEW → Human code review
40
+ S09_STAGING → Staging deployment and smoke tests
41
+ S10_PRODUCTION → Production deployment
42
+ COMPLETE → Project delivered
43
+ ```
44
+
45
+ ---
46
+
47
+ ## Phase Gate Status
48
+
49
+ | Phase | Status | Completed | Approver |
50
+ |---|---|---|---|
51
+ | S01 Requirements | NOT_STARTED | — | Human |
52
+ | S02 Architecture | NOT_STARTED | — | Human |
53
+ | S03 Specification | NOT_STARTED | — | prod-tech-lead |
54
+ | S04 Tasks | NOT_STARTED | — | orch-planner |
55
+ | S05 Implementation | NOT_STARTED | — | orch-planner |
56
+ | S06 Testing | NOT_STARTED | — | orch-judge |
57
+ | S07 Security | NOT_STARTED | — | ops-security |
58
+ | S08 Human Review | NOT_STARTED | — | Human |
59
+ | S09 Staging | NOT_STARTED | — | ops-devops |
60
+ | S10 Production | NOT_STARTED | — | Human |
61
+
62
+ ---
63
+
64
+ ## Task Summary
65
+
66
+ | Metric | Value |
67
+ |---|---|
68
+ | **Total Tasks** | 0 (project/tasks.md not yet created) |
69
+ | **TODO** | 0 |
70
+ | **IN_PROGRESS** | 0 |
71
+ | **DONE** | 0 |
72
+ | **BLOCKED** | 0 |
73
+ | **Completion %** | 0% |
74
+
75
+ ---
76
+
77
+ ## Artifact Status
78
+
79
+ | Artifact | Status | Location |
80
+ |---|---|---|
81
+ | PRD.md | NOT_CREATED | docs/requirements/PRD.md |
82
+ | EARS_REQUIREMENTS.md | NOT_CREATED | docs/requirements/ |
83
+ | PLAN.md | NOT_CREATED | PLAN.md |
84
+ | C4_ARCHITECTURE.md | NOT_CREATED | docs/architecture/ |
85
+ | SPEC.md | NOT_CREATED | SPEC.md |
86
+ | project/tasks.md | NOT_CREATED | project/tasks.md |
87
+ | openapi.yaml | NOT_CREATED | docs/api/ |
88
+ | SECURITY_CHECKLIST.md | NOT_CREATED | — |
89
+
90
+ ---
91
+
92
+ ## Quality Gate Status
93
+
94
+ | Gate | Last Run | Result | Issues |
95
+ |---|---|---|---|
96
+ | Gate 1 — Lint | Never | — | — |
97
+ | Gate 2 — Types | Never | — | — |
98
+ | Gate 3 — Coverage | Never | — | — |
99
+ | Gate 4 — Integration | Never | — | — |
100
+ | Gate 5 — Security | Never | — | — |
101
+ | Gate 6 — Complexity | Never | — | — |
102
+ | Gate 7 — EARS | Never | — | — |
103
+
104
+ ---
105
+
106
+ ## Active Blockers
107
+
108
+ *(None)*
109
+
110
+ ---
111
+
112
+ ## Pending Human Decisions
113
+
114
+ *(None)*
115
+
116
+ ---
117
+
118
+ ## Next Actions
119
+
120
+ 1. Run `setup-context.sh` to configure tool symlinks
121
+ 2. Fill in AGENTS.md for this specific project
122
+ 3. Invoke `prod-pm` (or `spec-writer.skill`) to create PRD.md
123
+ 4. Get human approval on PRD before proceeding to S02
124
+
125
+ ---
126
+
127
+ ## Memory Pointers
128
+
129
+ | Memory Layer | File | Status |
130
+ |---|---|---|
131
+ | Episodic | agents/memory/episodic/ | Empty — add DECISION_LOG entries |
132
+ | Semantic | agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md | Empty — populate as research accumulates |
133
+ | Continuity | agents/memory/CONTINUITY.md | Empty — populate as failures occur |
134
+ | Audit | agents/memory/AUDIT_LOG.md | Initialized |
@@ -0,0 +1,15 @@
1
+ # RESUME_POINTER (the lifeline — keep this current at all times)
2
+
3
+ > Written FIRST on every save by `core/state-preserve.skill`, read FIRST on resume
4
+ > by `core/session-resume.skill`. If an agent is cut off (tokens/time/crash), a fresh
5
+ > agent continues from the NEXT ACTION below. Never let this go stale while working.
6
+
7
+ - Updated: [ISO timestamp]
8
+ - Current task: [task id / one-line]
9
+ - SDLC phase: [S0X or —]
10
+ - Last completed step: [what just finished + commit hash if any]
11
+ - NEXT ACTION: [the precise next step a new agent should take]
12
+ - Open questions (blocking): [list or none]
13
+ - Working assumptions: [list]
14
+ - Files touched this session (not yet committed): [list]
15
+ - How to verify current state: [test/lint command]
@@ -0,0 +1,104 @@
1
+ # Decision Log — Session [SESSION_ID]
2
+ <!-- Episodic memory: per-session log of decisions, actions, and outcomes -->
3
+ <!-- Append entries as you work. Never edit past entries. -->
4
+ <!-- Store file as: agents/memory/episodic/YYYY-MM-DD_S[SESSION_NUM].md -->
5
+
6
+ ---
7
+
8
+ ## Session Header
9
+
10
+ | Field | Value |
11
+ |---|---|
12
+ | **Session ID** | [YYYY-MM-DD-HH-MM or sequential number] |
13
+ | **Date** | [YYYY-MM-DD] |
14
+ | **Started by** | [agent persona or human] |
15
+ | **SDLC Phase at Start** | [S01-S10 or COMPLETE] |
16
+ | **Tasks at Start** | [T-NNN (IN_PROGRESS), T-NNN (BLOCKED), ...] |
17
+ | **Goal for this Session** | [one sentence: what we're trying to accomplish] |
18
+
19
+ ---
20
+
21
+ ## Decision Log Entries
22
+
23
+ <!-- Format: append one block per significant decision or action -->
24
+ <!-- Minimum: log every SDLC phase change, blocked task, architecture decision, human input -->
25
+
26
+ ---
27
+
28
+ ### Entry 001
29
+
30
+ | Field | Value |
31
+ |---|---|
32
+ | **Timestamp** | [HH:MM UTC] |
33
+ | **Actor** | [agent persona / human] |
34
+ | **Action Type** | [DECISION / TASK_DONE / TASK_BLOCKED / RESEARCH / ESCALATION / ARCHITECTURE / HUMAN_INPUT / PHASE_TRANSITION] |
35
+ | **Subject** | [one sentence: what was decided/done/found] |
36
+ | **Rationale** | [why this decision was made] |
37
+ | **Outcome** | [PASS / FAIL / PENDING / DEFERRED] |
38
+ | **References** | [project/tasks.md#T-NNN, ADR-001, SPEC.md#section, etc.] |
39
+
40
+ ---
41
+
42
+ ### Entry 002
43
+
44
+ | Field | Value |
45
+ |---|---|
46
+ | **Timestamp** | [HH:MM UTC] |
47
+ | **Actor** | [agent persona / human] |
48
+ | **Action Type** | [DECISION / TASK_DONE / TASK_BLOCKED / RESEARCH / ...] |
49
+ | **Subject** | |
50
+ | **Rationale** | |
51
+ | **Outcome** | |
52
+ | **References** | |
53
+
54
+ <!-- Add more entries as needed -->
55
+
56
+ ---
57
+
58
+ ## Failed Experiments (worth recording in CONTINUITY.md)
59
+
60
+ <!-- List approaches that didn't work — transfer these to CONTINUITY.md at session end -->
61
+
62
+ | What was tried | Why it failed | What to do instead |
63
+ |---|---|---|
64
+ | [e.g., Used library X] | [Conflicted with Y because Z] | [Use library W instead] |
65
+
66
+ ---
67
+
68
+ ## Research Findings (worth recording in semantic/)
69
+
70
+ <!-- List authoritative facts discovered — transfer to agents/memory/semantic/ at session end -->
71
+
72
+ | Finding | Source (Tier 1/2) | Relevance |
73
+ |---|---|---|
74
+ | [e.g., Prisma cursor pagination requires `skip: 1`] | [Prisma official docs v5.x] | [Used in T-045 pagination feature] |
75
+
76
+ ---
77
+
78
+ ## Session Summary
79
+
80
+ | Field | Value |
81
+ |---|---|
82
+ | **Tasks Completed** | [T-NNN, T-NNN, ...] |
83
+ | **Tasks Blocked** | [T-NNN (reason), ...] |
84
+ | **SDLC Phase at End** | [S01-S10 or COMPLETE] |
85
+ | **Key Decisions Made** | [bullet summary] |
86
+ | **Transferred to CONTINUITY.md** | [Yes/No — list entries] |
87
+ | **Transferred to semantic/** | [Yes/No — list entries] |
88
+ | **Human Escalations Raised** | [count + ticket references] |
89
+ | **Next Session Start Point** | [what to do first next session] |
90
+
91
+ ---
92
+
93
+ ## Handoff Notes
94
+
95
+ <!-- What the NEXT session/agent needs to know to continue without context loss -->
96
+
97
+ ```
98
+ State at handoff:
99
+ - Current task: [T-NNN — description]
100
+ - Why stopped: [session ended / context limit / blocked]
101
+ - Critical context: [anything the next agent MUST know before starting]
102
+ - Don't repeat: [approaches already tried and failed]
103
+ - Human input pending: [questions/decisions waiting for human]
104
+ ```