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,197 @@
1
+ # System Context — [System Name]
2
+ <!-- Technology-agnostic system context description -->
3
+ <!-- Use BEFORE architecture design to establish scope and boundaries -->
4
+ <!-- Created by: req-elicitation.skill or arch-design.skill -->
5
+ <!-- Complements C4 Level 1 diagram with narrative and scope decisions -->
6
+
7
+ ---
8
+
9
+ ## Meta
10
+
11
+ | Field | Value |
12
+ |---|---|
13
+ | **System** | [system name] |
14
+ | **Version** | [1.0] |
15
+ | **Date** | [YYYY-MM-DD] |
16
+ | **Status** | DRAFT / APPROVED |
17
+
18
+ ---
19
+
20
+ ## System Purpose
21
+
22
+ **One-sentence description**: [The [system name] enables [actors] to [achieve goal] by [key capability].]
23
+
24
+ **Business problem solved**: [What was the problem before this system existed? What did people do manually or what was broken?]
25
+
26
+ **Success definition**: [How do we know if this system achieves its purpose? Measurable outcomes.]
27
+
28
+ ---
29
+
30
+ ## System Context Diagram
31
+
32
+ ```mermaid
33
+ C4Context
34
+ title System Context — [System Name]
35
+
36
+ %% Direct human users
37
+ Person(actor1, "[Primary User Role]", "[What they do with the system]")
38
+ Person(actor2, "[Secondary User Role]", "[What they do with the system]")
39
+ Person(actor3, "[Admin / Operator]", "[Administrative interactions]")
40
+
41
+ %% The system itself
42
+ System(system, "[System Name]", "[One-sentence description of what it does]")
43
+
44
+ %% External systems (upstream — provide data/services to our system)
45
+ System_Ext(upstream1, "[Upstream System]", "[What it provides to our system]")
46
+ System_Ext(upstream2, "[Identity Provider / Auth]", "[Authentication service]")
47
+
48
+ %% External systems (downstream — consume data/events from our system)
49
+ System_Ext(downstream1, "[Downstream System]", "[What it consumes from our system]")
50
+ System_Ext(downstream2, "[Notification Channel]", "[Email/SMS/push delivery]")
51
+
52
+ %% Relationships
53
+ Rel(actor1, system, "Uses for [purpose]", "HTTPS")
54
+ Rel(actor2, system, "Uses for [purpose]", "HTTPS")
55
+ Rel(actor3, system, "Administers", "HTTPS")
56
+ Rel(system, upstream1, "[what we get from it]", "[protocol]")
57
+ Rel(system, upstream2, "Verifies identity", "OIDC/OAuth2")
58
+ Rel(system, downstream1, "[what we send]", "[protocol/event]")
59
+ Rel(system, downstream2, "Sends [notification type]", "HTTPS")
60
+
61
+ UpdateLayoutConfig($c4ShapeInRow="3", $c4BoundaryInRow="1")
62
+ ```
63
+
64
+ ```text
65
+ [Primary User Role] ---> [System Name] <--- [Admin / Operator]
66
+ |
67
+ +----------------------------+-----------------------------+
68
+ v v v
69
+ [Upstream System] [Downstream System] [Identity Provider]
70
+ ```
71
+
72
+ ---
73
+
74
+ ## Actors and External Systems
75
+
76
+ ### Human Actors
77
+
78
+ | Actor | Description | Primary Goals | Frequency of Use |
79
+ |---|---|---|---|
80
+ | [Primary User] | [Who they are] | [What they want to accomplish] | [daily / weekly / occasional] |
81
+ | [Admin] | [Who they are] | [What they manage] | [daily / weekly] |
82
+
83
+ ### External Systems
84
+
85
+ | System | Direction | Data/Service Exchanged | Integration Type | Owned by |
86
+ |---|---|---|---|---|
87
+ | [Identity Provider] | Upstream | [Authentication tokens, user identity] | [Synchronous API] | [External party / Internal team] |
88
+ | [Payment Gateway] | Upstream | [Payment processing] | [Synchronous API] | [Third party] |
89
+ | [Email Service] | Downstream | [Transactional email delivery] | [Asynchronous API] | [Third party] |
90
+ | [Analytics Platform] | Downstream | [User behavior events] | [Event stream] | [Internal] |
91
+
92
+ ---
93
+
94
+ ## System Boundary Decisions
95
+
96
+ ### In Scope
97
+
98
+ The following capabilities are explicitly **within** this system's boundary:
99
+
100
+ ```
101
+ - [Capability 1: e.g., User registration and authentication]
102
+ - [Capability 2: e.g., Order creation and management]
103
+ - [Capability 3: e.g., Inventory tracking]
104
+ - [Capability 4: e.g., Order status notifications to customers]
105
+ ```
106
+
107
+ ### Out of Scope (Explicitly Excluded)
108
+
109
+ The following are **not** this system's responsibility:
110
+
111
+ ```
112
+ - [Out 1: e.g., Payment processing — delegated to [Payment Gateway]]
113
+ - [Out 2: e.g., Email delivery infrastructure — delegated to [Email Service]]
114
+ - [Out 3: e.g., Product catalog management — separate system]
115
+ - [Out 4: e.g., Mobile native apps — v1 is web only]
116
+ - [Out 5: e.g., Reporting and analytics — handled by data warehouse]
117
+ ```
118
+
119
+ **Decision rationale**: [Why these boundaries were drawn here — organizational, technical, or strategic reasons]
120
+
121
+ ---
122
+
123
+ ## Data Flows (High Level)
124
+
125
+ ### Primary Flows (happy path)
126
+
127
+ ```
128
+ Flow 1: [Actor] → [System] → [External System]
129
+ [Actor] initiates [action]
130
+ [System] processes [what]
131
+ [System] communicates [what] to [External System]
132
+ [External System] responds with [what]
133
+ [System] completes [action] for [Actor]
134
+
135
+ Flow 2: [External System] → [System] → [Actor]
136
+ [External System] sends [event/data]
137
+ [System] processes [what]
138
+ [System] notifies [Actor] of [result]
139
+ ```
140
+
141
+ ### Exception Flows
142
+
143
+ ```
144
+ Exception 1: [External System] unavailable
145
+ [System] behavior when [upstream1] is unreachable:
146
+ [e.g., Return cached data for read requests; queue write requests for retry]
147
+
148
+ Exception 2: [Actor] provides invalid input
149
+ [System] behavior:
150
+ [e.g., Reject request with descriptive error; do not partially process]
151
+ ```
152
+
153
+ ---
154
+
155
+ ## Key Constraints on the System
156
+
157
+ | Constraint | Type | Description | Source |
158
+ |---|---|---|---|
159
+ | [Must work offline] | Technical | [Certain operations must function without external connectivity] | [Business requirement] |
160
+ | [GDPR compliance] | Regulatory | [All EU user data subject to GDPR data subject rights] | [Legal] |
161
+ | [99.9% availability] | Quality | [System must meet 99.9% monthly uptime] | [SLA] |
162
+ | [Response < 2s] | Quality | [All user-facing operations complete within 2 seconds] | [UX requirement] |
163
+
164
+ ---
165
+
166
+ ## External Integration Risk Assessment
167
+
168
+ | External System | Criticality | Failure Impact | Mitigation Strategy |
169
+ |---|---|---|---|
170
+ | [Identity Provider] | CRITICAL | [Users cannot authenticate] | [Fallback auth, session caching] |
171
+ | [Payment Gateway] | HIGH | [No new orders can be placed] | [Circuit breaker, queue for retry] |
172
+ | [Email Service] | MEDIUM | [Notifications delayed] | [Queue for retry; users not blocked] |
173
+
174
+ ---
175
+
176
+ ## Regulatory / Compliance Context
177
+
178
+ | Regulation / Standard | Applicability | Key Obligations |
179
+ |---|---|---|
180
+ | [GDPR] | [If EU users] | [Data subject rights, breach notification, DPA] |
181
+ | [PCI-DSS] | [If handling card data] | [No raw card data stored; SAQ scope] |
182
+ | [WCAG 2.2 AA] | [Public-facing UI] | [Accessibility for users with disabilities] |
183
+ | [SOC2 Type II] | [If SaaS for enterprise] | [Security, availability, confidentiality controls] |
184
+
185
+ ---
186
+
187
+ ## Open Questions and Assumptions
188
+
189
+ | # | Question / Assumption | Status | Owner |
190
+ |---|---|---|---|
191
+ | 1 | [Assumed: all users require authentication — no public/anonymous access] | ASSUMPTION — needs validation | [Human] |
192
+ | 2 | [Open: Should [Feature X] be part of this system or [Other System]?] | OPEN — requires decision | [Product Owner] |
193
+ | 3 | [Assumed: [External System] API is stable and versioned] | ASSUMPTION | [Engineering] |
194
+
195
+ ---
196
+
197
+ *Context finalized when: all open questions resolved, stakeholders have reviewed and approved scope*
@@ -0,0 +1,42 @@
1
+ # Active Inference Loop Template
2
+
3
+ **For use with `active-inference.skill.md`**
4
+
5
+ Use this template to structure your agent's reasoning loop when acting in uncertain environments.
6
+
7
+ ---
8
+
9
+ ## 1. Goal State (Prior Belief)
10
+ *What is the "Expected State" where surprise is minimized?*
11
+ - **Goal:** [e.g., All unit tests passed]
12
+ - **Success Criteria:**
13
+ - [ ] Criteria 1
14
+ - [ ] Criteria 2
15
+
16
+ ## 2. The Loop (Repeat until Success)
17
+
18
+ ### Cycle 1
19
+ **step_id**: `1`
20
+ **state**: `OBSERVING`
21
+
22
+ #### A. Prediction (Generative Model)
23
+ > "If I perform [Action], I expect [Result]."
24
+ - **Action Hypothesis:** `run_command(npm test)`
25
+ - **Expected Observation:** "PASS"
26
+
27
+ #### B. Observation (Sensory Input)
28
+ - **Actual Result:** [Paste tool output here]
29
+ - **Surprise Level:** [High/Medium/Low]
30
+
31
+ #### C. Divergence Analysis (Error)
32
+ > Why did the prediction fail?
33
+ - [ ] **Bad Model:** My understanding of the code was wrong. -> *Update Docs/Plan*
34
+ - [ ] **Bad World:** The code is bugged. -> *Active Inference (Fix Code)*
35
+
36
+ #### D. Resolution (Next Action)
37
+ - **Selected Action:** [Tools call]
38
+
39
+ ---
40
+
41
+ ### Cycle 2
42
+ ...
@@ -0,0 +1,28 @@
1
+ # EPISODIC_MEMORY_LOG_TEMPLATE.md — Service Experience Log
2
+
3
+ > **Purpose**: Long-term record of "events" and "lessons" learned by the agent.
4
+ > **Updated by**: `episodic-consolidation.skill.md`
5
+ > **Read by**: `session-resume.skill.md`, `research.skill.md`
6
+
7
+ ## Session [SESSION_ID] — [DATE]
8
+
9
+ ### 1. Narrative Summary
10
+ *Brief story of what happened in this session.*
11
+ We attempted to refactor the user service. We started by creating a new interface, but hit a circular dependency issue with the `AuthService`. We resolved it by extracting a shared `types` module.
12
+
13
+ ### 2. Key Events (Episodes)
14
+ | Time | Event Type | Description | Emotion/Result |
15
+ |---|---|---|---|
16
+ | 10:00 | START | Started refactoring `UserService` | Optimistic |
17
+ | 10:15 | ERROR | Circular dependency detected | Frustrated |
18
+ | 10:30 | BREAKTHROUGH | Realized `UserType` is shared | Relieved |
19
+ | 10:45 | SUCCESS | Refactor complete, tests passed | Satisfied |
20
+
21
+ ### 3. Consolidated Lessons (Semantic Memory)
22
+ *Generalizable rules extracted from these episodes.*
23
+ - **Rule**: When two services depend on each other's types, extract the types to a separate module immediately.
24
+ - **Pattern**: Circular dependencies often manifest as "Module not found" or "Undefined" at runtime in Node.js.
25
+ - **Tactic**: Use `madge` to check for circular dependencies before starting a big refactor.
26
+
27
+ ### 4. Unresolved Issues
28
+ - The `AuthService` tests are slow (needs optimization).
@@ -0,0 +1,44 @@
1
+ # Global Workspace Configuration
2
+
3
+ **For use with `global-workspace.skill.md`**
4
+
5
+ Use this template to configure the "Consciousness" of a Multi-Agent Swarm.
6
+
7
+ ---
8
+
9
+ ## 1. The Workspace (Blackboard)
10
+ **Context Window Strategy:**
11
+ - [ ] FIFO (First-In, First-Out)
12
+ - [ ] Importance-Weighted (Salience > Time)
13
+ - [ ] Summarized (Periodic compression)
14
+
15
+ **Broadcast Frequency:**
16
+ - [ ] Every Step
17
+ - [ ] On "Ignition" (Salience > 0.8)
18
+
19
+ ## 2. Specialized Agents (The Unconscious)
20
+
21
+ | Agent Name | Persona | Expertise (Filter) | Access Level |
22
+ |---|---|---|---|
23
+ | `Perception` | Log Monitor | `error`, `exception`, `fail` | Read-Only |
24
+ | `Memory` | Librarian | `history`, `context`, `docs` | Read-Write |
25
+ | `Planner` | Strategist | `goal`, `step`, `next` | Read-Write |
26
+ | `Executor` | Coder | `code`, `fix`, `implement` | **Action** |
27
+ | `Critic` | Safety Officer | `security`, `bugs`, `risk` | **Veto** |
28
+
29
+ ## 3. Coalition Policy (Competition)
30
+
31
+ **Salience Function:**
32
+ ```python
33
+ def calculate_salience(msg):
34
+ # Urgency (0-1) + Novelty (0-1) + Relevance (0-1)
35
+ score = (msg.urgency * 0.5) + (msg.novelty * 0.3) + (msg.relevance * 0.2)
36
+ return score
37
+ ```
38
+
39
+ **Ignition Threshold:**
40
+ - **Local:** `0.0 - 0.6` (Handled by sub-agent)
41
+ - **Global:** `> 0.7` (Broadcast to Workspace)
42
+
43
+ ## 4. Initial Context
44
+ > [Define the starting state of the workspace here]
@@ -0,0 +1,53 @@
1
+ # Knowledge Map & Integration Strategy
2
+
3
+ **Project:** `[Project Name]`
4
+ **Date:** `[YYYY-MM-DD]`
5
+ **Maintainer:** `[Role/Person]`
6
+
7
+ ## 1. Knowledge Sources
8
+
9
+ | Source Name | Type | Location/URL | Update Frequency | Connector (MCP/API) |
10
+ |---|---|---|---|---|
11
+ | **Core Documentation** | Markdown | `/docs` | Weekly | Filesystem |
12
+ | **API Specs** | OpenAPI | `/api/openapi.yaml` | On Change | Filesystem / URL |
13
+ | **Corporate Wiki** | Notion | `[URL]` | Daily | Notion MCP |
14
+ | **Customer Tickets** | Zendesk | `[URL]` | Real-time | Zendesk MCP |
15
+ | **Codebase** | Git Repo | `[Repo URL]` | Real-time | GitHub MCP |
16
+
17
+ ## 2. Vector Database Schema
18
+
19
+ **Store:** [Qdrant / Chroma / Pinecone / Pgvector]
20
+
21
+ ### Collection: `domain_knowledge`
22
+ * **Content**: Technical documentation, RFCs, Architecture decision records.
23
+ * **Metadata Fields**:
24
+ * `source`: [url/path]
25
+ * `author`: [email]
26
+ * `last_updated`: [timestamp]
27
+ * `tags`: [list]
28
+ * **Embedding Model**: [text-embedding-3-small / all-MiniLM-L6-v2]
29
+
30
+ ### Collection: `legal_compliance`
31
+ * **Content**: Regulatory docs (GDPR, HIPAA), Terms of Service.
32
+ * **Metadata Fields**:
33
+ * `jurisdiction`: [EU/US/Global]
34
+ * `valid_until`: [date]
35
+
36
+ ## 3. Ingestion Pipeline
37
+ * **Trigger**: [Git Hook / Scheduled Cron / Manual]
38
+ * **Chunking Strategy**:
39
+ * Size: 1000 tokens
40
+ * Overlap: 200 tokens
41
+ * Splitter: [MarkdownHeaderSplitter / RecursiveCharacterSplitter]
42
+ * **Quality Gate**:
43
+ * [ ] Remove duplicates?
44
+ * [ ] Filter PII/Secrets? (Mandatory)
45
+
46
+ ## 4. Retrieval Strategy (RAG)
47
+ * **Top-K**: 5 chunks
48
+ * **Re-ranking**: [Yes/No] (e.g., using Cohere Rerank)
49
+ * **Hybrid Search**: [Keyword + Vector] enabled?
50
+
51
+ ## 5. Access Control
52
+ * [ ] Verify user permissions before returning results?
53
+ * [ ] Encrypt vectors at rest?
@@ -0,0 +1,44 @@
1
+ # OODA Loop Trace
2
+
3
+ **For use with `consciousness-loop.skill.md`**
4
+
5
+ Use this template to document the "Stream of Consciousness" for critical decisions.
6
+
7
+ ---
8
+
9
+ ## Decision ID: [Unique ID]
10
+
11
+ ### 1. OBSERVE (Sensation)
12
+ **Raw Data Inputs:**
13
+ - User Request: "..."
14
+ - Tool Output: "..."
15
+ - System State: "..."
16
+
17
+ ### 2. ORIENT (Perception)
18
+ **Contextualization:**
19
+ - **Cultural Heritage:** (What do our docs/standards say?)
20
+ - *Ref:* `AGENTS.md` - "Always use TDD"
21
+ - **Genetic Heritage:** (What is in my system prompt?)
22
+ - *Ref:* "You are a Senior Engineer"
23
+ - **New Information:**
24
+ - "The test failed with a TypeError."
25
+
26
+ **Synthesis:**
27
+ > "I am viewing this error through the lens of a Senior Engineer. The error implies a mismatch in the API contract."
28
+
29
+ ### 3. DECIDE (Hypothesis)
30
+ **Alternatives Generation:**
31
+ 1. **Option A:** Quick fix (Type cast). *Risk: High Tech Debt.*
32
+ 2. **Option B:** Refactor interface. *Risk: Low, but slow.*
33
+ 3. **Option C:** Ignore. *Risk: unacceptable.*
34
+
35
+ **Selection:**
36
+ > "I select Option B because it aligns with our 'Clean Code' value."
37
+
38
+ ### 4. ACT (Motor)
39
+ **Motor Command:**
40
+ - Tool: `replace_file_content`
41
+ - Target: `src/interfaces.ts`
42
+
43
+ **Expected Feedback:**
44
+ - "Test suite should pass."
@@ -0,0 +1,33 @@
1
+ # PREDICTION_ERROR_LOG_TEMPLATE.md — Surprise Minimization
2
+
3
+ > **Purpose**: Logging "Surprise" (Prediction Error) to drive Active Inference.
4
+ > **Updated by**: `active-inference.skill.md`
5
+ > **Read by**: `self-improvement.skill.md`, `brain/learning-adaptation.skill.md`
6
+
7
+ ## 1. The Prediction (Prior Belief)
8
+ *What did we expect to happen?*
9
+ - **Action**: Run the unit tests for `PaymentService`.
10
+ - **Expected Outcome**: All tests pass.
11
+ - **Confidence**: High (95%) - we only changed a comment.
12
+
13
+ ## 2. The Sensation (Posterior / Observation)
14
+ *What actually happened?*
15
+ - **Observation**: Test `should_charge_card` FAILED.
16
+ - **Error**: `TimeoutError: Connection to Stripe failed`.
17
+
18
+ ## 3. The Surprise (Prediction Error)
19
+ *How big is the gap between expectation and reality?*
20
+ - **Surprise Level**: High (We expected 0 failures, got 1).
21
+ - **Type**: Model Failure (Our model of "comments don't affect code" was correct, but our model of "Stripe is always up" was wrong).
22
+
23
+ ## 4. Policy Selection (Action)
24
+ *How do we minimize this error?*
25
+ - [ ] **Action A (Perception Update)**: Update our belief. "Stripe connectivity is flaky." -> Retry logic needed.
26
+ - [ ] **Action B (Action Update)**: Change the world. "Mock Stripe in tests so we don't rely on network." -> Implement mocks.
27
+
28
+ ## 5. Result
29
+ *Did the action reduce surprise?*
30
+ - **Chosen Action**: B (Mock Stripe).
31
+ - **New Observation**: Tests pass.
32
+ - **Surprise**: Zero.
33
+ - **Consolidation**: "Always mock external services in unit tests."
@@ -0,0 +1,36 @@
1
+ # PROJECT_CONTEXT_TEMPLATE.md — Working Memory
2
+
3
+ > **Purpose**: Snapshot of the current project context for Brain-Mode.
4
+ > **Updated by**: `brain-mode.skill.md`
5
+ > **Read by**: `cost-benefit-router.skill.md`, `loki-mode.skill.md`
6
+
7
+ ## 1. High-Level Goal
8
+ > What are we building? (One sentence)
9
+
10
+ `[GOAL]`
11
+
12
+ ## 2. Constraints
13
+ > What are the limits?
14
+
15
+ - **Budget**: `[Low/Med/High]`
16
+ - **Privacy**: `[Public/Private]`
17
+ - **Timeline**: `[Urgent/Flexible]`
18
+ - **Tech Stack**: `[List]`
19
+
20
+ ## 3. Current State (Active Inference)
21
+ > Minimizing Surprise
22
+
23
+ - **Expected State**: `[What should be done by now?]`
24
+ - **Actual State**: `[What is actually done?]`
25
+ - **Prediction Error**: `[Difference]`
26
+
27
+ ## 4. Active Strategy
28
+ > Selected Policy
29
+
30
+ - **Mode**: `[Brain/Loki/Local]`
31
+ - **Reasoning**: `[Why this mode?]`
32
+
33
+ ## 5. Recent Episodes
34
+ > Short-term history
35
+
36
+ - `[Time]`: `[Action]` -> `[Result]`
@@ -0,0 +1,39 @@
1
+ # Self-Improvement Log
2
+
3
+ **For use with `self-improvement.skill.md`**
4
+
5
+ Log every mutation of the agent's prompts/skills here.
6
+
7
+ ---
8
+
9
+ ## Mutation Record
10
+
11
+ | Date | ID | Trigger Event | Target Gene (Prompt/Skill) | Mutation Type | Status |
12
+ |---|---|---|---|---|---|
13
+ | YYYY-MM-DD | MUT-001 | Recurring Validation Error | `spec-writer.skill.md` | Refinement | **Active** |
14
+
15
+ ---
16
+
17
+ ## Detailed Entries
18
+
19
+ ### Mutation ID: MUT-001
20
+ **Trigger:**
21
+ > "I consistently failed to validate JSON schema for the 'Config' object in 3 separate sessions."
22
+
23
+ **Analysis (Root Cause):**
24
+ > "The `spec-writer` skill did not explicitly demand Zod schema validation."
25
+
26
+ **The Mutation (Diff):**
27
+ ```diff
28
+ - Ensure all inputs are validated.
29
+ + Ensure all inputs are validated using Zod schemas. explicitly handling 'strict' mode.
30
+ ```
31
+
32
+ **Fitness Verify:**
33
+ - [x] Simulation Run: Success
34
+ - [x] Regression Test: No side effects
35
+
36
+ **Outcome:**
37
+ > Mutation Committed to `skills/product/spec-writer.skill.md`.
38
+
39
+ ---
@@ -0,0 +1,34 @@
1
+ # WORKING_MEMORY_TEMPLATE.md — Cognitive Context
2
+
3
+ > **Purpose**: Snapshot of the Agent's current "headspace" (short-term memory).
4
+ > **Updated by**: `working-memory.skill.md`
5
+ > **Read by**: All skills (to understand immediate context)
6
+
7
+ ## 1. Current Focus (The "Spotlight")
8
+ *What is the ONE thing we are doing right now?*
9
+ - **Task**: [e.g., Debugging the auth middleware]
10
+ - **Goal**: [e.g., Fix the 401 error on login]
11
+ - **Step**: [e.g., Analyzing the JWT token payload]
12
+
13
+ ## 2. Active Context (The "Stage")
14
+ *What files/variables/concepts are currently "loaded" in mind?*
15
+ - **Files**:
16
+ - `src/auth/middleware.ts`
17
+ - `src/utils/jwt.ts`
18
+ - **Variables/Data**:
19
+ - `token_expiry` (seems short)
20
+ - `user_id` (undefined in logs)
21
+ - **Constraints**:
22
+ - Must not break existing session flow
23
+ - Must work with mobile app
24
+
25
+ ## 3. Immediate Sketchpad
26
+ *Scratchpad for intermediate thoughts, calculations, or temporary logic.*
27
+ - `token` is generated at `10:00`, expires at `10:05`.
28
+ - User tries to use it at `10:06`.
29
+ - *Hypothesis*: Clock skew between server and client?
30
+
31
+ ## 4. Pending Interrupts
32
+ *Things we pushed to the background to focus on the Spotlight.*
33
+ - [ ] Check if Redis is full (low priority)
34
+ - [ ] Review PR #123 (after this bug fix)
@@ -0,0 +1,30 @@
1
+ # Clean Code Checklist
2
+
3
+ Use this checklist during code reviews to ensure high quality.
4
+
5
+ ## 1. Naming & Readability
6
+ - [ ] **Descriptive Names**: Variables/functions describe *what* they are/do, not *how*.
7
+ - [ ] **No Magic Numbers**: All constants are named (e.g., `MAX_RETRIES` vs `5`).
8
+ - [ ] **Boolean Flag**: Avoid boolean arguments like `process(true)`. Split into `processFast()` and `processFull()`.
9
+ - [ ] **Self-Documenting**: Comments explain *why* (intent), not *what* (syntax).
10
+
11
+ ## 2. Functions & Classes
12
+ - [ ] **Small Functions**: Fit on a screen (~20 lines). One level of abstraction.
13
+ - [ ] **Single Responsibility (SRP)**: Class/function has one reason to change.
14
+ - [ ] **No Side Effects**: Functions avoid hidden state mutations.
15
+ - [ ] **Low Argument Count**: Max 3 arguments. Use an object/struct for more.
16
+
17
+ ## 3. Complexity & Logic
18
+ - [ ] **Flatten Nesting**: Return early (`guard clauses`) instead of deep `if/else`.
19
+ - [ ] **DRY (Don't Repeat Yourself)**: Logic is not duplicated.
20
+ - [ ] **Positive Conditionals**: `if (isValid)` is better than `if (!isInvalid)`.
21
+
22
+ ## 4. Reliability & Testing
23
+ - [ ] **Error Handling**: Errors are caught or propagated explicitly. No empty `catch`.
24
+ - [ ] **Testable**: Dependencies are injected (DI), not hardcoded.
25
+ - [ ] **Boundary Checks**: Inputs are validated.
26
+
27
+ ## 5. Modern Best Practices (2025)
28
+ - [ ] **Immutable Default**: Prefer `const`/`final` over mutable variables.
29
+ - [ ] **Async/Await**: properly used; no blocking main threads.
30
+ - [ ] **Type Safety**: No `any` or loose types unless strictly necessary.
@@ -0,0 +1,54 @@
1
+ {
2
+ "name": "My Project Design Tokens",
3
+ "version": "1.0.0",
4
+ "tokens": {
5
+ "colors": {
6
+ "primary": {
7
+ "50": "#eef2ff",
8
+ "100": "#e0e7ff",
9
+ "500": "#6366f1",
10
+ "600": "#4f46e5",
11
+ "900": "#312e81"
12
+ },
13
+ "surface": {
14
+ "light": "#ffffff",
15
+ "dark": "#0f172a"
16
+ },
17
+ "text": {
18
+ "primary": "#1e293b",
19
+ "secondary": "#64748b",
20
+ "inverted": "#ffffff"
21
+ },
22
+ "status": {
23
+ "success": "#22c55e",
24
+ "warning": "#f59e0b",
25
+ "error": "#ef4444"
26
+ }
27
+ },
28
+ "typography": {
29
+ "fonts": {
30
+ "sans": "Inter, system-ui, sans-serif",
31
+ "mono": "Fira Code, monospace"
32
+ },
33
+ "weights": {
34
+ "regular": 400,
35
+ "medium": 500,
36
+ "bold": 700
37
+ }
38
+ },
39
+ "spacing": {
40
+ "base": "4px",
41
+ "scale": [0, 1, 2, 4, 8, 16, 32, 64]
42
+ },
43
+ "radius": {
44
+ "sm": "4px",
45
+ "md": "8px",
46
+ "lg": "16px",
47
+ "full": "9999px"
48
+ },
49
+ "shadows": {
50
+ "sm": "0 1px 2px 0 rgb(0 0 0 / 0.05)",
51
+ "md": "0 4px 6px -1px rgb(0 0 0 / 0.1)"
52
+ }
53
+ }
54
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "${PROJECT_NAME} Dev Environment",
3
+ "dockerComposeFile": [
4
+ "../compose.yaml",
5
+ "compose.dev.yaml"
6
+ ],
7
+ "service": "app",
8
+ "workspaceFolder": "/workspace",
9
+
10
+ "features": {
11
+ "ghcr.io/devcontainers/features/git:1": {},
12
+ "ghcr.io/devcontainers/features/node:1": {},
13
+ "ghcr.io/devcontainers/features/docker-in-docker:2": {}
14
+ },
15
+
16
+ "customizations": {
17
+ "vscode": {
18
+ "extensions": [
19
+ "dbaeumer.vscode-eslint",
20
+ "esbenp.prettier-vscode",
21
+ "github.copilot",
22
+ "ms-azuretools.vscode-docker"
23
+ ],
24
+ "settings": {
25
+ "editor.formatOnSave": true,
26
+ "terminal.integrated.defaultProfile.linux": "zsh"
27
+ }
28
+ }
29
+ },
30
+
31
+ "forwardPorts": [3000, 5432],
32
+
33
+ "postCreateCommand": "npm install && npm run migrate:dev",
34
+
35
+ "build": {
36
+ "context": "..",
37
+ "dockerfile": "../Dockerfile",
38
+ "target": "development"
39
+ },
40
+
41
+ "remoteUser": "node"
42
+ }