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,542 @@
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 (REQUIRED VARIABLES)
10
+ > **ACTION REQUIRED**: Replace all `[PLACEHOLDER: ...]` values below with your specific stack.
11
+
12
+ ```yaml
13
+ project_name: "[PLACEHOLDER: My Project]"
14
+ description: "[PLACEHOLDER: One sentence about what this project does]"
15
+ repo_url: "[PLACEHOLDER: https://github.com/org/repo]"
16
+
17
+ runtime: "[PLACEHOLDER: Node.js 22 | PHP 8.3 | Python 3.12 | Go 1.22]"
18
+ language: "[PLACEHOLDER: TypeScript 5.x | PHP | Python | Go]"
19
+ framework: "[PLACEHOLDER: Fastify | Laravel | FastAPI | Gin]"
20
+ package_manager: "[PLACEHOLDER: pnpm | npm | yarn | composer | pip | go mod]"
21
+
22
+ database: "[PLACEHOLDER: PostgreSQL 16 | MySQL 8 | MongoDB 7 | SQLite]"
23
+ orm: "[PLACEHOLDER: Prisma | Eloquent | SQLAlchemy | GORM]"
24
+ cache: "[PLACEHOLDER: Redis | Memcached | none]"
25
+
26
+ deployment_target: "[PLACEHOLDER: Docker/K8s | Vercel | AWS Lambda | VPS]"
27
+ ci_cd: "[PLACEHOLDER: GitHub Actions | GitLab CI | CircleCI]"
28
+ ```
29
+
30
+ ---
31
+
32
+ ## 2. Operational Commands
33
+
34
+ > These are the EXACT commands agents must use. No approximations.
35
+ > Wrong: "run tests". Right: the exact command below.
36
+
37
+ ```bash
38
+ # Install dependencies
39
+ install: "[PLACEHOLDER: pnpm install | composer install | pip install -r requirements.txt]"
40
+
41
+ # Start development server
42
+ dev: "[PLACEHOLDER: pnpm dev | php artisan serve | python -m uvicorn main:app --reload]"
43
+
44
+ # Run ALL tests (must pass before any PR)
45
+ test: "[PLACEHOLDER: pnpm test | php artisan test | pytest | go test ./...]"
46
+
47
+ # Run tests with coverage report
48
+ test_coverage: "[PLACEHOLDER: pnpm test --coverage | php artisan test --coverage | pytest --cov]"
49
+
50
+ # Run specific test file
51
+ test_single: "[PLACEHOLDER: pnpm vitest run src/path/to/file.test.ts]"
52
+
53
+ # Build for production
54
+ build: "[PLACEHOLDER: pnpm build | composer install --no-dev | go build ./...]"
55
+
56
+ # Type checking (must pass before any PR)
57
+ typecheck: "[PLACEHOLDER: pnpm tsc --noEmit | phpstan analyse --level=9 | mypy .]"
58
+
59
+ # Linting (must pass before any PR)
60
+ lint: "[PLACEHOLDER: pnpm eslint . | pint | ruff check .]"
61
+
62
+ # Formatting
63
+ format: "[PLACEHOLDER: pnpm prettier --write . | pint | ruff format .]"
64
+
65
+ # Security scan (dependency audit)
66
+ security_scan: "[PLACEHOLDER: pnpm audit | composer audit | pip-audit | snyk test]"
67
+
68
+ # Database migrations
69
+ migrate: "[PLACEHOLDER: pnpm prisma migrate dev | php artisan migrate | alembic upgrade head]"
70
+
71
+ # Generate API docs
72
+ docs: "[PLACEHOLDER: pnpm typedoc | php artisan scribe:generate]"
73
+ ```
74
+
75
+ ---
76
+
77
+ ## 3. Architecture Rules
78
+
79
+ > These rules are enforced by the agentic-linter skill on every PR.
80
+ > Violations must be fixed before merging.
81
+
82
+ ### Layer Definitions
83
+
84
+ ```
85
+ [PLACEHOLDER — adapt to your architecture pattern]
86
+
87
+ <!-- OPTIONAL: Architecture Examples -> Document layer mappings (e.g., Domain -> Application -> Adapters -> Infrastructure) -->
88
+ ```
89
+
90
+ ### Forbidden Patterns
91
+
92
+ ```
93
+ # NEVER do these:
94
+ - Direct database access from controllers (use use-cases / actions)
95
+ - Business logic in views or API response formatters
96
+ - Circular imports between any two modules
97
+ - Importing framework-specific code in domain layer
98
+ - Hardcoded configuration values (use env vars + config files)
99
+ - [PLACEHOLDER: add project-specific forbidden patterns]
100
+ ```
101
+
102
+ ### Directory Purpose Map
103
+
104
+ ```
105
+ [PLACEHOLDER: Document what each top-level directory is for]
106
+
107
+ <!-- OPTIONAL: Directory Map Example -> e.g., src/ -> src code, tests/ -> test suites, docs/ -> Architectural info -->
108
+ ```
109
+
110
+ ---
111
+
112
+ ## 4. Code Style & Patterns
113
+
114
+ <!-- OPTIONAL: Code Style Specifics -> Document naming conventions, OOP vs Functional, Error handling, State management, API response format, Import styles -->
115
+ ---
116
+
117
+ ## 5. Workflow for Agents — Review-Driven Development
118
+
119
+ Agents MUST follow this order; skipping steps is forbidden. Keep `agents/memory/` current at
120
+ every task (episodic, semantic, AUDIT_LOG, CONTINUITY, PROJECT_STATE, RESUME_POINTER), and consult
121
+ `agents/{skills,guides,templates}/` for relevant capabilities at each step.
122
+
123
+ **CRITICAL MANDATES (always apply):**
124
+
125
+ - **Optimal skill/guide/MCP selection** — analyze the task and select (or ask the user to confirm) the best skills/guides/templates; never default to generic execution when a specialized one exists. Recommend enabling any MCP server that would materially help.
126
+ - **Cost & budget by default** — minimize tokens/context/API cost; never use swarms or SOTA models for simple work, and **ask the human before any expensive/SOTA/high-cost approach** (with a one-line cost-benefit). Four levers (`guides/ops/cost-optimization.md`): prompt caching (stable context first), context budgeting (load minimum, prefer `context_cost: low`), model tiering (`gabbe route`), batching. Never weaken the gates, the 10-phase SDLC, or HITL to save cost.
127
+ - **Spec-driven (first-class)** — `spec → evals → test → code`, never code-first. Non-trivial features start from an **EARS** spec (`product/spec-writer.skill`, `templates/product/SPEC_TEMPLATE.md`, `guides/planning/product-requirements.md`); keep a **golden thread** (requirement → spec → test → code → audit). No requirement without a test (Article I); resolve ambiguity in the spec via `clarify.skill`.
128
+ - **Observability (first-class)** — every run/decision/model+tool call is traced with token usage + **per-step cost attribution** (`core/audit-trail.skill`, `core/agent-analytics.skill`; OTel GenAI conventions `gen_ai.usage.*`; span tree root→plan→discover→execute→retrieve). Redact content by default (Article IV); `AUDIT_LOG.md` is authoritative without the CLI.
129
+ - **Human–agent collaboration (manager, not operator)** — the human delegates → observes → intervenes on exceptions. Keep three questions always answerable: **Purpose** (scope/non-goals via spec), **Transparency** (legible reasoning/tools/cost via observability), **Control** (pause/correct/approve via HITL). Prefer an async, observable surface; "done" only when all three hold (`guides/principles/human-agent-collaboration.md`).
130
+
131
+ ### Step 0 — Preflight & Clarify (before anything else)
132
+ ```
133
+ Run preflight.skill as the FIRST action of every session and every major task:
134
+ 1. Auto-checks: integrity-check (fast) → confirm memory + working tree are coherent.
135
+ 2. Load index SUMMARIES (not bodies): agents/{skills,guides,templates,personas}/00-index.md
136
+ → know what capabilities exist before choosing generically.
137
+ 3. Load memory headers with decay-aware priming (PROJECT_STATE, CONTINUITY, latest snapshot).
138
+ 4. Surface cost posture: GABBE_AUTONOMY (ask|auto|hybrid, default hybrid) + remaining budget.
139
+ 5. Recommend the OPTIMAL set for the task (skills/guides/persona/MCP), ranked by
140
+ relevance × (1/context_cost); pick a reasoning pattern proportionate to task + budget.
141
+ 6. Flag new/changed capabilities since last preflight (defer adoption to update-scan.skill).
142
+ 7. End by invoking clarify.skill → ask the focused batch of clarifying questions
143
+ (and "questions you should ask me") before proceeding.
144
+ Do not begin implementation until blocking questions are answered, unless the autonomy
145
+ posture is `auto` AND the task is cheap AND reversible.
146
+ ```
147
+
148
+ ### Step 1 — Load Context (every session start)
149
+ ```
150
+ 1. Read this AGENTS.md completely
151
+ 2. Read CONSTITUTION.md if it exists
152
+ 3. Read the relevant task from project/TASKS.md (if project/TASKS.md exists)
153
+ 4. If agents/memory/PROJECT_STATE.md exists: read it (understand current SDLC phase)
154
+ 5. If agents/memory/CONTINUITY.md exists: read it (understand past failures to avoid)
155
+ ```
156
+
157
+ ### Step 2 — Plan Before Coding
158
+ ```
159
+ Before touching any file, write a brief implementation plan.
160
+
161
+ - What files will you create or modify?
162
+ - What is the expected behavior change?
163
+ - What tests will you write?
164
+ - Does this change affect any architecture boundaries?
165
+ - Are there any knowledge gaps? (If yes -> invoke knowledge-gap.skill)
166
+ For complex tasks: write PLAN.md or use PLAN_TEMPLATE.md
167
+
168
+ ```
169
+
170
+ ### Step 3 — Test First (TDD Red Phase)
171
+ ```
172
+ Write the failing test BEFORE writing implementation code.
173
+ <!-- OPTIONAL: Detailed TDD Red -> The test MUST fail (Red). Do not implement features not covered by a test -->
174
+ ```
175
+
176
+ ### Step 4 — Implement (TDD Green Phase)
177
+ ```
178
+ Write the minimal code to make the failing test pass.
179
+ <!-- OPTIONAL: Detailed TDD Green -> Do not add features not covered by a failing test -->
180
+ ```
181
+
182
+ ### Step 5 — Verify (must all pass before marking done)
183
+ ```
184
+ Run: [test command] -> must pass
185
+ Run: [typecheck command] -> must pass
186
+ Run: [lint command] -> must pass
187
+ <!-- OPTIONAL: Deep Verification -> E.g. Run agentic-linter to enforce boundaries -->
188
+ ```
189
+
190
+ ### Step 6 — Refactor
191
+ ```
192
+ Improve code quality while keeping all tests green.
193
+ <!-- OPTIONAL: Refactoring Metrics -> E.g. Complexity < 10, no duplication > 3 -->
194
+ ```
195
+
196
+ ### Step 7 — Log & Complete
197
+ ```
198
+ Write entry to agents/memory/AUDIT_LOG.md
199
+ Update task status in project/TASKS.md to DONE
200
+ Refresh agents/memory/RESUME_POINTER.md (state-preserve.skill) — keep the
201
+ "next action" current so any future session resumes losslessly
202
+ <!-- OPTIONAL: High-Level Orchestration -> E.g. sdlc-checkpoint.skill -> mark phase done -->
203
+ ```
204
+
205
+ > **State preservation is continuous, not just at Step 7.** Per `state-preserve.skill`
206
+ > and §13, save incrementally after every meaningful step and flush a full snapshot
207
+ > before budget/time runs out — assume a cutoff can happen at any moment.
208
+
209
+ ---
210
+
211
+ ## 6. Governance & Security
212
+
213
+ ### 🛡️ Mandatory Security & Guardrails
214
+ Agents MUST adhere to the **Security & Guardrails** section appended to the bottom of whatever skill they are currently executing. Bypassing these skill-specific guardrails is strictly forbidden.
215
+
216
+ ### Forbidden Actions (agents must never do these without explicit human approval)
217
+ ```
218
+ - Commit .env files or any file containing secrets
219
+ - Push directly to main/master branch
220
+ - Change CI/CD pipeline configuration
221
+ - Modify CONSTITUTION.md
222
+ - Switch to a different library/framework than what's defined in Project Identity
223
+ - Make breaking API changes
224
+ - Add new environment variables without documenting them
225
+ - Disable or modify linting/testing rules
226
+ - Grant elevated permissions or bypass authentication
227
+ - [PLACEHOLDER: add project-specific forbidden actions]
228
+ ```
229
+
230
+ ### Secrets Policy
231
+ ```
232
+ All secrets MUST be in environment variables.
233
+ Local dev: .env file (always in .gitignore)
234
+ CI/CD: GitHub Secrets / GitLab CI Variables / AWS Secrets Manager
235
+ Never hardcode API keys, passwords, tokens, or connection strings.
236
+ Use: [PLACEHOLDER: dotenv | .env.vault | AWS Secrets Manager | HashiCorp Vault]
237
+ ```
238
+
239
+ ### PR Format (Conventional Commits)
240
+ ```
241
+ Format: <type>(<scope>): <subject>
242
+
243
+ Types: feat | fix | docs | style | refactor | test | chore | perf | sec | deps
244
+ Scope: module or layer name (optional)
245
+
246
+ <!-- OPTIONAL: Commit Examples -> e.g. feat(auth): add OAuth2 login -->
247
+
248
+ PR body must include:
249
+ - What changed and why
250
+ - Test coverage for the change
251
+ - Breaking changes (if any)
252
+ - Security implications (if any)
253
+ ```
254
+
255
+ ### Quality Gates (all must pass before PR merges)
256
+ ```
257
+ <!-- OPTIONAL: Quality Gates Specifics -> Document testing, linting, code coverage >99%, CI integration gates -->
258
+ ```
259
+
260
+ ---
261
+
262
+ ## 7. Research Policy
263
+
264
+ Agents must use authoritative sources. Never guess or hallucinate.
265
+
266
+ ### Source Tiers (in order of trust)
267
+ ```
268
+ <!-- OPTIONAL: Source Tiers -> Tier 1: Official docs/Specs. Tier 2: Academic. Tier 3: Verified blogs. Avoid: Reddit/SO. -->
269
+ ```
270
+
271
+ ### Research Gate -- mandatory before:
272
+ ```
273
+ - Using any library not in existing package.json / composer.json
274
+ - Calling any API method not confirmed in official docs
275
+ - Implementing any security mechanism or cryptographic approach
276
+ - Interpreting any regulatory requirement (GDPR, OWASP, HIPAA)
277
+ ```
278
+
279
+ ### When to invoke research.skill
280
+ ```
281
+ "I'm not sure about X" -> knowledge-gap.skill -> research.skill -> confirm before coding
282
+ If library version not found in official docs -> do NOT assume behavior -> report to human
283
+ Use Context-7 MCP for library docs (prevents hallucinated deprecated API usage)
284
+ ```
285
+
286
+ ---
287
+
288
+ ## 8. Self-Healing Policy
289
+
290
+ Agents may autonomously fix failures up to 5 attempts.
291
+
292
+ ### What agents may self-heal (no human approval needed):
293
+ ```
294
+ - Type errors and lint errors
295
+ - Test assertion updates when spec changed
296
+ - Deprecated API calls (found via Context-7 MCP)
297
+ - Dependency version bumps (patch/minor versions only)
298
+ - Import path corrections
299
+ - Formatting and code style issues
300
+ ```
301
+
302
+ ### What requires human decision:
303
+ ```
304
+ - Architecture or library changes
305
+ - Breaking API changes (any consumer affected)
306
+ - Security-affecting changes (auth, permissions, encryption)
307
+ - Major version dependency bumps
308
+ - Any modification to CONSTITUTION.md
309
+ - Any change to CI/CD pipelines
310
+ - Any change that removes or weakens a security control
311
+ ```
312
+
313
+ ### Self-Heal Escalation Protocol
314
+ After 5 failed attempts, agent MUST:
315
+ ```
316
+
317
+ 1. STOP all autonomous action
318
+ 2. Create structured escalation report:
319
+ - Error description
320
+ - All 5 attempts made and their outcomes
321
+ - Research findings
322
+ - Recommended human decision
323
+ 3. Write to AUDIT_LOG.md
324
+ 4. Wait for human response before continuing
325
+
326
+ ```
327
+
328
+ ### Self-Evolving Policy (within cost + permission bounds)
329
+ The system may keep itself current and improve (new/better skills, tools, MCPs, models) via
330
+ `update-scan.skill` — but only inside hard bounds (full detail in that skill):
331
+ - **Allowed** (gated by `GABBE_AUTONOMY` + budget): adopt a cheaper/better reversible+validated tool/model; import a vetted external skill (validated first); refine prompts/personas from **successful** trajectories only.
332
+ - **Always needs human approval** (even under `auto`): anything expensive/SOTA/irreversible, externally-sourced runnable code, or any change to protected files.
333
+ - **Guardrails:** misaligned-replay guard (never learn from failed runs); protected files (never auto-edit build/IaC/CI/dependency manifests outside the self-heal allowlist); policy-as-code self-enforcement with every adoption/rejection logged to `AUDIT_LOG.md`; prefer canary + rollback, version evolved components.
334
+
335
+ ---
336
+
337
+ ## 9. Human-in-the-Loop Triggers
338
+
339
+ The agent MUST stop and ask the human when encountering:
340
+
341
+ ```
342
+ ALWAYS pause and ask:
343
+ - Any breaking change to a public API
344
+ - Ambiguous requirements (multiple valid interpretations)
345
+ - Security trade-offs (convenience vs security)
346
+ - Budget or scope changes
347
+ - Regulatory requirement interpretation (GDPR, HIPAA, etc.)
348
+ - Architectural change (new service, new database, library switch)
349
+ - Any discovered vulnerability that requires feature disablement
350
+ - "I've tried 5 times and cannot fix this" (see Self-Healing Policy)
351
+ - Any expensive / SOTA-model / irreversible action — even under GABBE_AUTONOMY=auto
352
+ - Adopting a new tool, model, or externally-sourced skill (see update-scan / skills-registry)
353
+ - [PLACEHOLDER: add project-specific escalation triggers]
354
+
355
+ <!-- OPTIONAL: Escalation Format -> Detail issue, options considered, and recommendation -->
356
+ ```
357
+
358
+ **Clarify at every major step (not just at session start).** Per `clarify.skill`, the agent
359
+ estimates its own uncertainty before each major step and asks a focused batch of clarifying
360
+ questions (≈3–6, highest-impact first) whenever interpretation is ambiguous, a decision input is
361
+ missing, retrieval/verification failed, or the action is expensive/irreversible. The amount of
362
+ questioning scales with the `GABBE_AUTONOMY` posture (ask → clarify freely; hybrid → clarify on
363
+ real ambiguity; auto → silent for cheap/reversible work but always pause for the cases above).
364
+ Record assumed defaults in `agents/memory/AUDIT_LOG.md` so silence is informed, not a guess.
365
+
366
+ ---
367
+
368
+ ## 10. Tool-Specific Overrides
369
+
370
+ ### Claude Code (claude.ai/code, Claude Code CLI)
371
+ ```
372
+ - Skills: Use slash commands matching skill names (e.g., /tdd-cycle, /code-review)
373
+ - Memory: Use TodoWrite tool for task tracking
374
+ - Hooks: Check .claude/settings.json for hook configuration
375
+ - Context: This AGENTS.md is symlinked to .claude/CLAUDE.md
376
+ ```
377
+
378
+ ### Cursor
379
+ ```
380
+ - Context: This AGENTS.md is symlinked to .cursorrules
381
+ - Skills: Reference skill files directly in conversation
382
+ - Agent mode: @workspace for codebase-wide context
383
+ ```
384
+
385
+ ### GitHub Copilot
386
+ ```
387
+ - Context: Instructions from .github/copilot-instructions.md (symlinked)
388
+ - Skills: Reference skills/ directory files in comments or conversation
389
+ ```
390
+
391
+ ### Gemini CLI
392
+ ```
393
+ - Context: This AGENTS.md is symlinked to .gemini/settings.json (instructions field) + GEMINI.md
394
+ - Skills: Symlinked to .agent/skills/ -- invoke by trigger keywords
395
+ - MCP: Configure .gemini/mcp_config.json using templates/core/MCP_CONFIG_TEMPLATE.json
396
+ ```
397
+
398
+ ### Google Antigravity
399
+ ```
400
+ - Context: Reads the root AGENTS.md (priority AGENTS.md → GEMINI.md → defaults, v1.20.3+)
401
+ - Skills: Emitted to .agents/skills/<slug>/SKILL.md (agentskills.io standard)
402
+ - Models: Picks up CLAUDE.md when running a Claude model — same project context
403
+ ```
404
+
405
+ ### OpenCode (local-first)
406
+ ```
407
+ - Context: Reads the root AGENTS.md + an opencode.json `instructions` array
408
+ - Skills: Emitted to .agents/skills/<slug>/SKILL.md (agentskills.io standard)
409
+ ```
410
+
411
+ ### Zed / Continue / Roo Code / Kilo Code
412
+ ```
413
+ - Context: Read the root AGENTS.md (agents.md standard); Zed also via .rules,
414
+ Continue via .continue/rules/, Roo via .roo/rules/, Kilo via .kilocode/rules/
415
+ - Skills: Reference agents/skills/ directly, or the universal .agents/skills/ tree
416
+ ```
417
+
418
+ ---
419
+
420
+ ## 11. Monorepo Support
421
+
422
+ For monorepos, this root AGENTS.md applies globally.
423
+ Package-level AGENTS.md files override root for that package's scope.
424
+
425
+ ```
426
+ <!-- OPTIONAL: Monorepo Setup Example -> Add AGENTS.md per package to override root settings -->
427
+ ```
428
+
429
+ Agent context priority: Package AGENTS.md > Root AGENTS.md
430
+
431
+ ---
432
+
433
+ ## 12. References
434
+
435
+ **Discover skills via the index — `agents/skills/00-index.md` is the canonical catalog**: native
436
+ skill menus (e.g. Claude Code) may truncate large collections by token budget, so always consult
437
+ the index to find any skill, then read its full file before use. Per-tool skill locations: see §10.
438
+
439
+ ```
440
+ Project law: agents/CONSTITUTION.md
441
+ Skills (canonical): agents/skills/00-index.md (master: agents/skills/**)
442
+ Guides: agents/guides/00-index.md
443
+ Templates: agents/templates/00-index.md
444
+ Personas (Loki): agents/personas/00-index.md (36 roles)
445
+ Brain patterns: agents/skills/brain/README.md
446
+ Quick reference: docs/QUICK_GUIDE.md
447
+ Project memory: agents/memory/{PROJECT_STATE,CONTINUITY,AUDIT_LOG,RESUME_POINTER}.md
448
+ ```
449
+
450
+ ---
451
+
452
+ ## 13. Session & Continuity
453
+
454
+ Every session, agents MUST:
455
+
456
+ ```
457
+ START of session:
458
+ 1. Read this AGENTS.md
459
+ 2. Read agents/memory/RESUME_POINTER.md (the lifeline — current task + NEXT ACTION)
460
+ 3. Read agents/memory/PROJECT_STATE.md (if exists) -> understand current state
461
+ 4. Read agents/memory/CONTINUITY.md (if exists) -> understand past failures
462
+ 5. Load latest agents/memory/episodic/SESSION_SNAPSHOT/ (if exists)
463
+ 6. If resuming: use session-resume.skill for full recovery
464
+ 7. Run integrity-check.skill before starting new work on existing code
465
+
466
+ CONTINUOUSLY — never lose progress (state-preserve.skill; assume a cutoff at any moment):
467
+ - After each meaningful step: refresh RESUME_POINTER.md (current task + precise NEXT ACTION)
468
+ and append the outcome to AUDIT_LOG.md.
469
+ - Pre-exhaustion flush: when budget/tokens/turns run low or before a long/irreversible action,
470
+ write a FULL snapshot FIRST (RESUME_POINTER, then snapshot/PROJECT_STATE/CONTINUITY).
471
+ - On-disk Markdown memory must always suffice for a fresh agent to resume losslessly.
472
+
473
+ PORTABLE — switch coding agent or LLM anytime (state-portability.skill):
474
+ DEHYDRATE (state_export.sh → STATE_HANDOFF.md + a lossless bundle) and HYDRATE in the
475
+ destination agent (state_import.sh), then run session-resume + preflight. Memory + instructions
476
+ + state are a fully compatible export/import. Never export secrets; merge (don't clobber) on import.
477
+
478
+ END of session:
479
+ 1. Update project/TASKS.md with current status of all in-progress tasks
480
+ 2. Write session summary to agents/memory/episodic/ (DECISION_LOG_TEMPLATE.md)
481
+ 3. Update agents/memory/PROJECT_STATE.md with current SDLC phase
482
+ 4. Write all decisions/outcomes to agents/memory/AUDIT_LOG.md
483
+ 5. Update agents/memory/CONTINUITY.md with lessons learned
484
+ 6. Create SDLC checkpoint if a phase was completed
485
+ 7. If stopping mid-task: note exactly where you stopped and why (RESUME_POINTER)
486
+ ```
487
+
488
+ ---
489
+
490
+ ## 14. Project-Specific Rules
491
+
492
+ ```
493
+ [PLACEHOLDER: Add any additional project-specific rules, constraints, or context here.]
494
+
495
+ <!-- OPTIONAL: Examples -> e.g. "API consumed by mobile, 30-day deprecation", "no hardcoded i18n strings" -->
496
+ ```
497
+
498
+ ### Per-project policy: `project/gabbe.config.json` (optional)
499
+ A runtime-agnostic policy file the agent reads to tune itself to this project —
500
+ autonomy posture, budgets, model tiers, enabled MCPs, skill registries, and
501
+ protected files. Copy `docs/gabbe.config.example.json` to
502
+ `project/gabbe.config.json` and edit. The agent
503
+ applies it via `coordination/self-optimize.skill`; the optional `gabbe` CLI
504
+ surfaces it via `gabbe/config.py` (`GABBE_AUTONOMY`, `GABBE_PROJECT_CONFIG`).
505
+ Precedence for autonomy: env `GABBE_AUTONOMY` > config `autonomy` > `hybrid`.
506
+ See `docs/SCHEMA.md` → *Project policy config*.
507
+
508
+ ---
509
+
510
+ # GABBE CLI Workflows (Optional)
511
+
512
+ > **Complete reference**: See `agents/guides/ops/gabbe-cli-workflows.md` for full details.
513
+ >
514
+ > **This section is optional.** The GABBE CLI provides platform controls (budget, audit, replay, escalation) but is NOT required. Agents can fully operate via markdown inference without it.
515
+
516
+ ### Core CLI Integration
517
+ See `agents/guides/ops/gabbe-cli-workflows.md` for standard CLI workflows: Init, Sync, Verify, Status, Route, Forecast, and Brain execution controls. (Note: The GABBE CLI is an optional experimental tool; agents can fully rely on markdown inference execution otherwise).
518
+
519
+ ---
520
+
521
+ # Loki & Brain — Agentic Orchestration
522
+
523
+ Two optional orchestration modes (both run purely via Markdown inference; the `gabbe`
524
+ CLI is optional). Full definitions live in the skills — this is only a pointer (avoid
525
+ restating them here, to prevent drift):
526
+
527
+ - **🧠 Brain Mode** (`brain/brain-mode.skill.md`) — the Strategist (System 2): meta-cognitive
528
+ planner/router/optimizer (Active Inference + dynamic cost routing). Trigger: `gabbe brain activate`, `supermode`.
529
+ - **⚡ Loki Mode** (`brain/loki-mode.skill.md`) — the Executor (System 1): the deterministic
530
+ 10-phase SDLC (S01→S10) with human-in-the-loop gates. Trigger: `loki`, `orchestrate`.
531
+
532
+ Brain Mode **wraps** Loki: it receives the request, routes by complexity/budget, runs Loki for
533
+ the SDLC, and monitors — intervening if cost spikes, errors loop, or requirements drift. Both use
534
+ the same operating spine in §5/§13 (preflight → clarify → act → state-preserve → final-review).
535
+
536
+ ---
537
+
538
+ *Last updated: [DATE]*
539
+ *GABBE Kit version: 0.9.6*
540
+ *This file is maintained by the team and updated when project conventions change.*
541
+
542
+ ---