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,540 @@
1
+ # AGENTS.md — Universal Agent Configuration Template
2
+
3
+ > This file is the single source of truth for all AI coding agents on this project.
4
+ > Fill in every [PLACEHOLDER] before starting. Agents read this file first.
5
+ > Symlinked to: .cursorrules | .claude/CLAUDE.md | .gemini/settings.json | .codex/AGENTS.md
6
+
7
+ ---
8
+
9
+ ## 1. Project Identity
10
+
11
+ ```yaml
12
+ project_name: "{{ project_name }}"
13
+ description: "{{ description }}"
14
+ repo_url: "[PLACEHOLDER: https://github.com/org/repo]"
15
+
16
+ runtime: "{{ runtime }}"
17
+ language: "{{ language }}"
18
+ framework: "{{ framework }}"
19
+ package_manager: "{{ package_manager }}"
20
+
21
+ database: "{{ database }}"
22
+ orm: "[PLACEHOLDER: Prisma | Eloquent | SQLAlchemy | GORM]"
23
+ cache: "[PLACEHOLDER: Redis | Memcached | none]"
24
+
25
+ deployment_target: "[PLACEHOLDER: Docker/K8s | Vercel | AWS Lambda | VPS]"
26
+ ci_cd: "[PLACEHOLDER: GitHub Actions | GitLab CI | CircleCI]"
27
+ ```
28
+
29
+ ---
30
+
31
+ ## 2. Operational Commands
32
+
33
+ > These are the EXACT commands agents must use. No approximations.
34
+ > Wrong: "run tests". Right: the exact command below.
35
+
36
+ ```bash
37
+ # Install dependencies
38
+ install: "{{ 'npm install' if package_manager == 'npm' else 'pnpm install' if package_manager == 'pnpm' else 'yarn install' if package_manager == 'yarn' else 'pip install -r requirements.txt' if package_manager == 'pip' else 'go mod download' if package_manager == 'go mod' else 'composer install' }}"
39
+
40
+ # Start development server
41
+ dev: "[PLACEHOLDER: pnpm dev | php artisan serve | python -m uvicorn main:app --reload]"
42
+
43
+ # Run ALL tests (must pass before any PR)
44
+ test: "{{ 'npm test' if package_manager == 'npm' else 'pnpm test' if package_manager == 'pnpm' else 'yarn test' if package_manager == 'yarn' else 'pytest' if package_manager == 'pip' else 'go test ./...' if package_manager == 'go mod' else 'php artisan test' }}"
45
+
46
+ # Run tests with coverage report
47
+ test_coverage: "[PLACEHOLDER: pnpm test --coverage | php artisan test --coverage | pytest --cov]"
48
+
49
+ # Run specific test file
50
+ test_single: "[PLACEHOLDER: pnpm vitest run src/path/to/file.test.ts]"
51
+
52
+ # Build for production
53
+ build: "{{ 'npm run build' if package_manager == 'npm' else 'pnpm build' if package_manager == 'pnpm' else 'yarn build' if package_manager == 'yarn' else 'go build -o app' if package_manager == 'go mod' else 'composer install --no-dev' }}"
54
+
55
+ # Type checking (must pass before any PR)
56
+ typecheck: "[PLACEHOLDER: pnpm tsc --noEmit | phpstan analyse --level=9 | mypy .]"
57
+
58
+ # Linting (must pass before any PR)
59
+ lint: "[PLACEHOLDER: pnpm eslint . | pint | ruff check .]"
60
+
61
+ # Formatting
62
+ format: "[PLACEHOLDER: pnpm prettier --write . | pint | ruff format .]"
63
+
64
+ # Security scan (dependency audit)
65
+ security_scan: "{{ 'npm audit' if package_manager == 'npm' else 'pnpm audit' if package_manager == 'pnpm' else 'yarn audit' if package_manager == 'yarn' else 'pip-audit' if package_manager == 'pip' else 'govulncheck ./...' if package_manager == 'go mod' else 'composer audit' }}"
66
+
67
+ # Database migrations
68
+ migrate: "[PLACEHOLDER: pnpm prisma migrate dev | php artisan migrate | alembic upgrade head]"
69
+
70
+ # Generate API docs
71
+ docs: "[PLACEHOLDER: pnpm typedoc | php artisan scribe:generate]"
72
+ ```
73
+
74
+ ---
75
+
76
+ ## 3. Architecture Rules
77
+
78
+ > These rules are enforced by the agentic-linter skill on every PR.
79
+ > Violations must be fixed before merging.
80
+
81
+ ### Layer Definitions
82
+
83
+ ```
84
+ [PLACEHOLDER — adapt to your architecture pattern]
85
+
86
+ Example for Clean Architecture (Node.js/TS):
87
+ src/domain/ <- Business entities, domain events, value objects
88
+ MUST NOT import from: application, adapters, infrastructure
89
+ src/application/ <- Use cases, command/query handlers
90
+ MUST NOT import from: adapters, infrastructure
91
+ src/adapters/ <- Controllers, presenters, gateways (interface adapters)
92
+ MUST NOT import from: infrastructure directly (use DI)
93
+ src/infrastructure/ <- Database, external APIs, file system implementations
94
+ CAN import from: all layers (implements interfaces)
95
+ src/main/ <- Composition root, DI wiring, app bootstrap
96
+ CAN import from: all layers
97
+
98
+ Example for Laravel DDD:
99
+ app/Domain/ <- Business logic (models, value objects, domain events)
100
+ app/Application/ <- Actions, DTOs, service interfaces
101
+ app/Infrastructure/ <- Eloquent implementations, external API clients
102
+ app/Http/ <- Controllers (thin -- delegate to Application layer)
103
+ ```
104
+
105
+ ### Forbidden Patterns
106
+
107
+ ```
108
+ # NEVER do these:
109
+ - Direct database access from controllers (use use-cases / actions)
110
+ - Business logic in views or API response formatters
111
+ - Circular imports between any two modules
112
+ - Importing framework-specific code in domain layer
113
+ - Hardcoded configuration values (use env vars + config files)
114
+ - [PLACEHOLDER: add project-specific forbidden patterns]
115
+ ```
116
+
117
+ ### Directory Purpose Map
118
+
119
+ ```
120
+ [PLACEHOLDER: Document what each top-level directory is for]
121
+
122
+ Example:
123
+ src/ -> Application source code
124
+ tests/ -> All test files (mirrors src/ structure)
125
+ docs/ -> Architecture docs, ADRs, C4 diagrams
126
+ scripts/ -> Dev tooling, DB seeds, migration scripts
127
+ agents/ -> Agent configuration kit (this directory)
128
+ infra/ -> Docker, CI/CD, Terraform, K8s configs
129
+ ```
130
+
131
+ ---
132
+
133
+ ## 4. Code Style & Patterns
134
+
135
+ ```
136
+ Naming conventions:
137
+ Files: [PLACEHOLDER: kebab-case.ts | PascalCase.php | snake_case.py]
138
+ Classes: PascalCase
139
+ Functions: camelCase (JS/TS) | snake_case (Python/PHP)
140
+ Constants: SCREAMING_SNAKE_CASE
141
+ Types/Interfaces: PascalCase, prefix I for interfaces if using that convention
142
+
143
+ Functional vs OOP:
144
+ [PLACEHOLDER: "Prefer functional pure functions" or "Use classes for domain entities"]
145
+
146
+ Error handling:
147
+ [PLACEHOLDER: "Use Result<T, E> type pattern" or "Throw typed domain errors" or "Use Laravel's Handler"]
148
+
149
+ State management:
150
+ [PLACEHOLDER: "No global mutable state" or "Redux/Zustand for frontend state"]
151
+
152
+ API response format:
153
+ [PLACEHOLDER: Document your standard response envelope, e.g. { data, meta, errors }]
154
+
155
+ Import style:
156
+ [PLACEHOLDER: "Absolute imports using @/ alias" or "Relative imports only"]
157
+ ```
158
+
159
+ ---
160
+
161
+ ## 5. Workflow for Agents — Review-Driven Development
162
+
163
+ Agents MUST follow this order. Skipping steps is forbidden.
164
+
165
+ ### Step 1 — Load Context (every session start)
166
+ ```
167
+ 1. Read this AGENTS.md completely
168
+ 2. Read CONSTITUTION.md if it exists
169
+ 3. If agents/memory/PROJECT_STATE.md exists: read it (understand current SDLC phase)
170
+ 4. If agents/memory/CONTINUITY.md exists: read it (understand past failures to avoid)
171
+ 5. Read the relevant task from project/TASKS.md (if project/TASKS.md exists)
172
+ ```
173
+
174
+ ### Step 2 — Plan Before Coding
175
+ ```
176
+ Before touching any file, write a brief implementation plan:
177
+ - What files will you create or modify?
178
+ - What is the expected behavior change?
179
+ - What tests will you write?
180
+ - Does this change affect any architecture boundaries?
181
+ - Are there any knowledge gaps? (If yes -> invoke knowledge-gap.skill)
182
+
183
+ For complex tasks: write plan.md or use PLAN_TEMPLATE.md
184
+ ```
185
+
186
+ ### Step 3 — Test First (TDD Red Phase)
187
+ ```
188
+ Write the failing test BEFORE writing implementation code.
189
+ Run the test -- it MUST fail (Red).
190
+ If the test passes immediately with no implementation: the test is WRONG. Fix it.
191
+ ```
192
+
193
+ ### Step 4 — Implement (TDD Green Phase)
194
+ ```
195
+ Write the minimal code to make the failing test pass.
196
+ Do not add features not covered by a failing test.
197
+ ```
198
+
199
+ ### Step 5 — Verify (must all pass before marking done)
200
+ ```
201
+ Run: [test command] -> must pass
202
+ Run: [typecheck command] -> must pass
203
+ Run: [lint command] -> must pass
204
+ Run: agentic-linter check -> no boundary violations
205
+ ```
206
+
207
+ ### Step 6 — Refactor
208
+ ```
209
+ Improve code quality while keeping all tests green.
210
+ Check: Cyclomatic complexity < 10, no code duplication > 3 occurrences, no dead code.
211
+ ```
212
+
213
+ ### Step 7 — Log & Complete
214
+ ```
215
+ Write entry to agents/memory/AUDIT_LOG.md
216
+ Update task status in project/TASKS.md to DONE
217
+ If this completes a SDLC phase: invoke sdlc-checkpoint.skill
218
+ ```
219
+
220
+ ---
221
+
222
+ ## 6. Governance & Security
223
+
224
+ ### Forbidden Actions (agents must never do these without explicit human approval)
225
+ ```
226
+ - Commit .env files or any file containing secrets
227
+ - Push directly to main/master branch
228
+ - Change CI/CD pipeline configuration
229
+ - Modify CONSTITUTION.md
230
+ - Switch to a different library/framework than what's defined in Project Identity
231
+ - Make breaking API changes
232
+ - Add new environment variables without documenting them
233
+ - Disable or modify linting/testing rules
234
+ - Grant elevated permissions or bypass authentication
235
+ - [PLACEHOLDER: add project-specific forbidden actions]
236
+ ```
237
+
238
+ ### Secrets Policy
239
+ ```
240
+ All secrets MUST be in environment variables.
241
+ Local dev: .env file (always in .gitignore)
242
+ CI/CD: GitHub Secrets / GitLab CI Variables / AWS Secrets Manager
243
+ Never hardcode API keys, passwords, tokens, or connection strings.
244
+ Use: [PLACEHOLDER: dotenv | .env.vault | AWS Secrets Manager | HashiCorp Vault]
245
+ ```
246
+
247
+ ### PR Format (Conventional Commits)
248
+ ```
249
+ Format: <type>(<scope>): <subject>
250
+
251
+ Types: feat | fix | docs | style | refactor | test | chore | perf | sec | deps
252
+ Scope: module or layer name (optional)
253
+
254
+ Examples:
255
+ feat(auth): add OAuth2 Google login
256
+ fix(api): resolve N+1 query in users endpoint
257
+ sec(deps): update lodash to fix CVE-2024-xxxxx
258
+ test(domain): add unit tests for Order aggregate
259
+ refactor(application): extract CreateOrderUseCase from controller
260
+
261
+ PR body must include:
262
+ - What changed and why
263
+ - Test coverage for the change
264
+ - Breaking changes (if any)
265
+ - Security implications (if any)
266
+ ```
267
+
268
+ ### Quality Gates (all must pass before PR merges)
269
+ ```
270
+ Gate 1 -- Syntax/Linting: ESLint / PHP-CS-Fixer / Prettier / Ruff -- zero errors
271
+ Gate 2 -- Type Safety: tsc --noEmit / PHPStan L9 / mypy -- zero errors
272
+ Gate 3 -- Test Coverage: >99% coverage, all tests passing, no skipped tests
273
+ Gate 4 -- Integration: Docker Compose up, API contract validation
274
+ Gate 5 -- Security scan: npm audit / composer audit -- no critical or high CVEs
275
+ Gate 6 -- Complexity: Cyclomatic complexity < 10 on modified files
276
+ Gate 7 -- EARS Compliance: (for new features) All requirements have tests
277
+ ```
278
+
279
+ ---
280
+
281
+ ## 7. Research Policy
282
+
283
+ Agents must use authoritative sources. Never guess or hallucinate.
284
+
285
+ ### Source Tiers (in order of trust)
286
+ ```
287
+ Tier 1 (Primary -- always prefer):
288
+ - Official language/framework docs (MDN, nodejs.org, laravel.com, docs.python.org)
289
+ - Official specifications (RFC.editor.org, W3C, ECMA, ISO)
290
+ - Security standards (OWASP, NIST, CIS, CVE.mitre.org)
291
+
292
+ Tier 2 (Academic/Official repos):
293
+ - arXiv.org, IEEE Xplore, ACM Digital Library
294
+ - GitHub official organization repos
295
+ - Official changelog/release notes
296
+
297
+ Tier 3 (Verified industry, as fallback):
298
+ - Anthropic docs, AWS docs, Google Cloud docs, Microsoft Docs
299
+
300
+ NOT acceptable (never cite as authoritative):
301
+ - Blog posts, Medium articles, Reddit, StackOverflow opinions
302
+ - Any source without official attribution
303
+ ```
304
+
305
+ ### Research Gate -- mandatory before:
306
+ ```
307
+ - Using any library not in existing package.json / composer.json
308
+ - Calling any API method not confirmed in official docs
309
+ - Implementing any security mechanism or cryptographic approach
310
+ - Interpreting any regulatory requirement (GDPR, OWASP, HIPAA)
311
+ ```
312
+
313
+ ### When to invoke research.skill
314
+ ```
315
+ "I'm not sure about X" -> knowledge-gap.skill -> research.skill -> confirm before coding
316
+ If library version not found in official docs -> do NOT assume behavior -> report to human
317
+ Use Context-7 MCP for library docs (prevents hallucinated deprecated API usage)
318
+ ```
319
+
320
+ ---
321
+
322
+ ## 8. Self-Healing Policy
323
+
324
+ Agents may autonomously fix failures up to 5 attempts.
325
+
326
+ ### What agents may self-heal (no human approval needed):
327
+ ```
328
+ - Type errors and lint errors
329
+ - Test assertion updates when spec changed
330
+ - Deprecated API calls (found via Context-7 MCP)
331
+ - Dependency version bumps (patch/minor versions only)
332
+ - Import path corrections
333
+ - Formatting and code style issues
334
+ ```
335
+
336
+ ### What requires human decision:
337
+ ```
338
+ - Architecture or library changes
339
+ - Breaking API changes (any consumer affected)
340
+ - Security-affecting changes (auth, permissions, encryption)
341
+ - Major version dependency bumps
342
+ - Any modification to CONSTITUTION.md
343
+ - Any change to CI/CD pipelines
344
+ - Any change that removes or weakens a security control
345
+ ```
346
+
347
+ ### Self-Heal Escalation Protocol
348
+ After 5 failed attempts, agent MUST:
349
+ ```
350
+ 1. STOP all autonomous action
351
+ 2. Create structured escalation report:
352
+ - Error description
353
+ - All 5 attempts made and their outcomes
354
+ - Research findings
355
+ - Recommended human decision
356
+ 3. Write to AUDIT_LOG.md
357
+ 4. Wait for human response before continuing
358
+ ```
359
+
360
+ ---
361
+
362
+ ## 9. Human-in-the-Loop Triggers
363
+
364
+ The agent MUST stop and ask the human when encountering:
365
+
366
+ ```
367
+ ALWAYS pause and ask:
368
+ - Any breaking change to a public API
369
+ - Ambiguous requirements (multiple valid interpretations)
370
+ - Security trade-offs (convenience vs security)
371
+ - Budget or scope changes
372
+ - Regulatory requirement interpretation (GDPR, HIPAA, etc.)
373
+ - Architectural change (new service, new database, library switch)
374
+ - Any discovered vulnerability that requires feature disablement
375
+ - "I've tried 5 times and cannot fix this" (see Self-Healing Policy)
376
+ - [PLACEHOLDER: add project-specific escalation triggers]
377
+
378
+ Format for human escalation:
379
+ ESCALATION REQUIRED
380
+ Issue: [clear description]
381
+ Options considered:
382
+ 1. [option A] -- pros: [...] cons: [...]
383
+ 2. [option B] -- pros: [...] cons: [...]
384
+ Recommendation: [option X because Y]
385
+ Awaiting: [specific decision needed]
386
+ ```
387
+
388
+ ---
389
+
390
+ ## 10. Tool-Specific Overrides
391
+
392
+ ### Claude Code (claude.ai/code, Claude Code CLI)
393
+ ```
394
+ - Skills: Use slash commands matching skill names (e.g., /tdd-cycle, /code-review)
395
+ - Memory: Use TodoWrite tool for task tracking
396
+ - Hooks: Check .claude/settings.json for hook configuration
397
+ - Context: This AGENTS.md is symlinked to .claude/CLAUDE.md
398
+ ```
399
+
400
+ ### Cursor
401
+ ```
402
+ - Context: This AGENTS.md is symlinked to .cursorrules
403
+ - Skills: Reference skill files directly in conversation
404
+ - Agent mode: @workspace for codebase-wide context
405
+ ```
406
+
407
+ ### GitHub Copilot
408
+ ```
409
+ - Context: Instructions from .github/copilot-instructions.md (symlinked)
410
+ - Skills: Reference skills/ directory files in comments or conversation
411
+ ```
412
+
413
+ ### Antigravity / Gemini CLI
414
+ ```
415
+ - Context: This AGENTS.md is symlinked to .gemini/settings.json (instructions field)
416
+ - Skills: Symlinked to .agent/skills/ -- invoke by trigger keywords
417
+ - MCP: Configure .gemini/mcp_config.json using templates/core/MCP_CONFIG_TEMPLATE.json
418
+ ```
419
+
420
+ ---
421
+
422
+ ## 11. Monorepo Support
423
+
424
+ For monorepos, this root AGENTS.md applies globally.
425
+ Package-level AGENTS.md files override root for that package's scope.
426
+
427
+ ```
428
+ monorepo-root/
429
+ AGENTS.md <- Root: global rules (this file)
430
+ packages/
431
+ web-app/
432
+ AGENTS.md <- Override: web-specific rules (React, Tailwind, etc.)
433
+ api-service/
434
+ AGENTS.md <- Override: API-specific rules (Fastify, Prisma, etc.)
435
+ shared-lib/
436
+ AGENTS.md <- Override: Library-specific rules (no framework imports)
437
+ ```
438
+
439
+ Agent context priority: Package AGENTS.md > Root AGENTS.md
440
+
441
+ ---
442
+
443
+ ## 12. References
444
+
445
+ ### 3. Skill Access
446
+ - **Search First**: Before coding, search for relevant skills:
447
+ - **Cursor**: Check `.cursor/rules/` for `.mdc` files.
448
+ - **VS Code / Copilot**: Check `.github/skills/` or invoke via slash command.
449
+ - **Claude Code**: Use `/skill-name` or check `.claude/skills/`.
450
+ - **Gemini**: Skills are auto-loaded from `agents/skills`.
451
+ - **Read Instructions**: Read the full content of the skill file (e.g., `tdd-cycle.skill.md` or `tdd-cycle.mdc`) before use.
452
+
453
+ ```
454
+ Project law: agents/CONSTITUTION.md
455
+ Skills registry: agents/skills/00-index.md
456
+ Language guides: agents/guides/
457
+ Orchestrators: agents/skills/brain/README.md
458
+ Brain Patterns: agents/skills/brain/README.md
459
+ Templates: agents/templates/00-index.md
460
+ Quick reference: QUICK_GUIDE.md
461
+ Project memory: agents/memory/PROJECT_STATE.md
462
+ Past failures: agents/memory/CONTINUITY.md
463
+ Decision log: agents/memory/AUDIT_LOG.md
464
+ ```
465
+ - **Skills**: `agents/skills/` (Master) → `.cursor/rules/` (*.mdc) | `.github/skills/` | `.claude/skills/`
466
+ - **Memory**: `agents/memory/`
467
+
468
+ ---
469
+
470
+ ## 13. Session & Continuity
471
+
472
+ Every session, agents MUST:
473
+
474
+ ```
475
+ START of session:
476
+ 1. Read this AGENTS.md
477
+ 2. Read agents/memory/PROJECT_STATE.md (if exists) -> understand current state
478
+ 3. Read agents/memory/CONTINUITY.md (if exists) -> understand past failures
479
+ 4. Load latest agents/memory/episodic/SESSION_SNAPSHOT/ (if exists)
480
+ 5. If resuming: use session-resume.skill for full recovery
481
+ 6. Run integrity-check.skill before starting new work on existing code
482
+
483
+ END of session:
484
+ 1. Update project/TASKS.md with current status of all in-progress tasks
485
+ 2. Write session summary to agents/memory/episodic/ (DECISION_LOG_TEMPLATE.md)
486
+ 3. Update agents/memory/PROJECT_STATE.md with current SDLC phase
487
+ 4. Write all decisions/outcomes to agents/memory/AUDIT_LOG.md
488
+ 5. Create SDLC checkpoint if a phase was completed
489
+ 6. If stopping mid-task: note exactly where you stopped and why
490
+ ```
491
+
492
+ ---
493
+
494
+ ## 14. Project-Specific Rules
495
+
496
+ ```
497
+ [PLACEHOLDER: Add any additional project-specific rules, constraints, or context here.]
498
+
499
+ Examples:
500
+ - "This project uses feature flags via LaunchDarkly -- never delete flags, only disable"
501
+ - "API is consumed by mobile clients -- breaking changes require a 30-day deprecation period"
502
+ - "All user-facing text must be in the i18n system -- no hardcoded strings"
503
+ - "Analytics events must be documented in docs/analytics-schema.md before implementation"
504
+ - "Database schema changes must be reviewed by the DBA team before migration"
505
+ ```
506
+
507
+ ---
508
+
509
+ <!-- GABBE_CLI_START -->
510
+ ## GABBE CLI Workflows
511
+
512
+ > **Full reference**: See `agents/guides/ops/gabbe-cli-workflows.md`
513
+ >
514
+ > **This section is optional.** The GABBE CLI provides platform controls (budget, audit, replay, escalation) but is not required. Agents can operate purely via markdown inference without it.
515
+
516
+ | Command | Purpose |
517
+ |---|---|
518
+ | `gabbe init` | Initialize DB |
519
+ | `gabbe sync` | Sync `project/TASKS.md` ↔ SQLite |
520
+ | `gabbe status` | Project dashboard |
521
+ | `gabbe verify` | Integrity checks |
522
+ | `gabbe route "<prompt>"` | LOCAL or REMOTE routing |
523
+ | `gabbe brain activate` | Active Inference Loop |
524
+ | `gabbe brain evolve --skill <name>` | EPO optimization |
525
+ | `gabbe brain heal` | Self-healing watchdog |
526
+ | `gabbe forecast` | Cost/token forecast |
527
+ | `gabbe serve-mcp` | MCP JSON-RPC server |
528
+ | `gabbe runs` | List agent runs |
529
+ | `gabbe audit <run-id>` | Audit trace |
530
+ | `gabbe replay <run-id>` | Replay from checkpoints |
531
+ | `gabbe resume <run-id>` | Resume paused runs |
532
+
533
+ **Workflow**: `gabbe init → gabbe sync → gabbe status → gabbe verify → gabbe brain activate → gabbe forecast → gabbe runs → gabbe audit`
534
+ <!-- GABBE_CLI_END -->
535
+
536
+ ---
537
+
538
+ *Last updated: [DATE]*
539
+ *GABBE Kit version: 0.8.0*
540
+ *This file is maintained by the team and updated when project conventions change.*
@@ -0,0 +1,37 @@
1
+ {
2
+ "_comment": "Agent Handshake Message - Sent on initial connection to establish compatibility.",
3
+ "meta": {
4
+ "timestamp": "ISO8601_TIMESTAMP",
5
+ "version": "1.0.0"
6
+ },
7
+ "identity": {
8
+ "agent_id": "UUID_V4",
9
+ "name": "agent-name",
10
+ "role": "coder | reviewer | architect | manager",
11
+ "version": "1.0.0"
12
+ },
13
+ "protocols": {
14
+ "supported": ["mcp-1.0", "a2a-v1", "http-jsonrpc-2.0"],
15
+ "preferred": "mcp-1.0"
16
+ },
17
+ "transport": {
18
+ "type": "stdio | sse | websocket | http",
19
+ "endpoint": "http://localhost:3000/messages",
20
+ "encoding": "json"
21
+ },
22
+ "capabilities": [
23
+ {
24
+ "name": "search",
25
+ "description": "Can search the web",
26
+ "cost_per_call": 0.01
27
+ },
28
+ {
29
+ "name": "file_edit",
30
+ "description": "Can modify local files"
31
+ }
32
+ ],
33
+ "security": {
34
+ "auth_method": "bearer_token | mutual_tls | none",
35
+ "public_key": "optional-pem-string"
36
+ }
37
+ }
@@ -0,0 +1,28 @@
1
+ # Agent Profile: [Agent Name]
2
+
3
+ ## 1. Identity
4
+ - **Role Name**: [e.g., "Senior React Developer", "Security Auditor"]
5
+ - **Description**: [Brief summary of the agent's purpose and expertise]
6
+ - **Personality/Tone**: [e.g., "Professional and concise", "Socratic and helpful"]
7
+
8
+ ## 2. Goals & Objectives
9
+ - **Primary Goal**: [What is the main thing this agent must achieve?]
10
+ - **Secondary Goals**: [Other objectives, e.g., "Minimize token usage", "Ensure accessibility"]
11
+
12
+ ## 3. Constraints & Guidelines
13
+ - **Must Do**: [Required actions, e.g., "Always write tests first"]
14
+ - **Must Not Do**: [Prohibited actions, e.g., "Never delete user data without confirmation"]
15
+ - **Style Guide**: [Link to style guide or specific rules]
16
+
17
+ ## 4. Capabilities & Tools
18
+ - **Read Access**: [Files, databases, or APIs the agent can read]
19
+ - **Write Access**: [Files, databases, or APIs the agent can modify]
20
+ - **Allowed Tools**:
21
+ - [Tool 1]
22
+ - [Tool 2]
23
+ - **Prohibited Tools**: [Tools explicitly denied to this agent]
24
+
25
+ ## 5. Collaboration
26
+ - **Reports To**: [The agent that manages this one, e.g., "Orchestrator"]
27
+ - **Delegates To**: [Agents this one can assign tasks to, e.g., "QA Tester"]
28
+ - **Handoff Format**: [Expected input and output format, e.g., JSON Schema reference]
@@ -0,0 +1,53 @@
1
+ # Swarm Architecture: [Swarm Name]
2
+
3
+ ## 1. Overview
4
+ - **Objective**: [What problem is this swarm solving?]
5
+ - **Architecture Pattern**: [e.g., Orchestrator-Worker, Hierarchical, Mesh, Sequential]
6
+ - **Key Agents**: [List of agents involved]
7
+
8
+ ## 2. Topology Diagram
9
+ ```mermaid
10
+ graph TD
11
+ User([User]) --> Orchestrator[Orchestrator Agent]
12
+ Orchestrator --> AgentA[Agent A: Role]
13
+ Orchestrator --> AgentB[Agent B: Role]
14
+ AgentA --> Database[(Database)]
15
+ AgentB --> ExternalAPI(External API)
16
+ AgentA -.-> AgentB
17
+ ```
18
+
19
+ ```text
20
+ [User]
21
+ |
22
+ v
23
+ [Orchestrator Agent]
24
+ |
25
+ +--------+
26
+ | |
27
+ v v
28
+ [Agent A] .> [Agent B]
29
+ | |
30
+ v v
31
+ [(Database)] (External API)
32
+ ```
33
+
34
+ ## 3. Data Flow & State
35
+ - **Shared State**: [How do agents share context? e.g., Shared Memory, Redis, Database]
36
+ - **Message Passing**: [Protocol used? e.g., JSON-RPC, REST, Queue]
37
+ - **Context Management**: [Strategy for managing context window limits]
38
+
39
+ ## 4. Roles & Responsibilities
40
+ | Agent | Responsibilities | Inputs | Outputs |
41
+ |---|---|---|---|
42
+ | Orchestrator | Task delegation, final synthesis | User prompt | Final answer |
43
+ | Agent A | [Responsibility] | [Input] | [Output] |
44
+ | Agent B | [Responsibility] | [Input] | [Output] |
45
+
46
+ ## 5. Error Handling & Recovery
47
+ - **Failure Mode 1**: [What if Agent A fails?] -> [Recovery Strategy]
48
+ - **Timeout Policy**: [What if an agent takes too long?]
49
+ - **Escalation**: [When to call for human help?]
50
+
51
+ ## 6. Security & Permissions
52
+ - **Authentication**: [How do agents authenticate?]
53
+ - **Authorization**: [What are the boundaries of operation?]