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,69 @@
1
+ # Agent Identity, Authentication & Trust
2
+
3
+ ## 1. Why Agent Identity Matters
4
+
5
+ When software only suggested actions to a human, the human's identity carried the accountability. Autonomous agents break that assumption: an agent that calls tools, moves money, edits records, or talks to other agents takes actions on its own that must be attributable, authorized, and constrained. If an agent shares a human's credentials or runs as an unscoped service account, you lose three things at once — you cannot tell *which* agent acted, you cannot limit *what* it was allowed to do, and you cannot revoke *just* that agent without breaking everything sharing the credential.
6
+
7
+ Agent identity exists to restore those properties: every agent gets its own attributable identity, granted least privilege, with actions logged against that identity. This guide complements the policy and least-privilege model used elsewhere in the kit and the defensive skills `prompt-injection-defense.skill` and `output-validation.skill`; identity is the layer that decides *who the agent is and what it may do*, while those skills decide *whether a given action is safe to perform*.
8
+
9
+ Honest note: this area is moving fast in 2026. The principles below are stable, but specific protocols, profiles, and product names are evolving — treat any concrete mechanism here as a current snapshot, not a settled standard, and re-check the live specs before depending on a detail.
10
+
11
+ ## 2. The Core Principles
12
+
13
+ - **Attributable**: every action traces to one agent identity, not a shared human or service account.
14
+ - **Least privilege**: an agent holds only the scopes it needs for its current task, and no more.
15
+ - **Delegated, not assumed**: when an agent acts for a user, that authority is an explicit, scoped, revocable delegation — never an inherited copy of the user's full rights.
16
+ - **Short-lived**: capability is granted through short-lived, scoped tokens, so a stolen credential expires quickly and a compromised agent can be cut off fast.
17
+ - **Human-gated at the top**: high-impact, irreversible, or trifecta-complete actions require a human approval regardless of how well-authenticated the agent is.
18
+
19
+ ## 3. OAuth-Style Authorization for Agents
20
+
21
+ The mainstream direction is to reuse the OAuth/OpenID authorization patterns the web already trusts, adapted so the *agent* is a first-class principal.
22
+
23
+ - **MCP resource-server authorization model**: in the Model Context Protocol, a tool/data server is treated as an OAuth-protected resource server. The agent (acting as the client) presents an access token; the server validates it against an authorization server and enforces the token's scopes. This separates *who issued trust* (the authorization server) from *who enforces it* (the resource server), so a tool never has to trust the agent's self-description — only a verifiable token.
24
+ - **Agent-to-agent (A2A) authentication**: when agents call other agents, each side authenticates the other as a distinct principal. Trust is mutual and scoped: the calling agent proves its identity and presents the scopes relevant to the request, and the receiving agent authorizes per-request rather than trusting the channel.
25
+ - **Scope discipline**: scopes should map to concrete capabilities ("read calendar", "send draft for approval") rather than coarse roles ("admin"), so the principle of least privilege is expressible in the token itself.
26
+
27
+ ## 4. Know Your Agent (KYA) and Verifiable Identity
28
+
29
+ Borrowing from "Know Your Customer" in finance, "Know Your Agent" (KYA) is the idea that a system should be able to establish *what an agent is, who operates it, and what it is permitted to do* before trusting it.
30
+
31
+ - **Agent passports**: a portable identity document for an agent — who built and operates it, what model/version it runs, and what it is authorized to do — that a relying party can verify before granting access.
32
+ - **Verifiable credentials (VCs)**: cryptographically signed claims about an agent (its operator, its certifications, its allowed scopes) that the agent presents and a verifier checks without phoning home to the issuer.
33
+ - **Decentralized identifiers (DIDs)**: identifiers an agent (or its operator) controls independently of any single provider, used as the subject of those credentials so identity is not locked to one platform.
34
+
35
+ Together these let a receiving system make a trust decision based on *verifiable* claims rather than on the agent's unverified self-assertion — which an injected or impersonating agent could fabricate.
36
+
37
+ ## 5. Signed Mandates and Delegation
38
+
39
+ The hardest case is an agent acting *on a user's behalf*. The user must be able to delegate narrow authority without handing over their identity.
40
+
41
+ - **Signed mandate**: a scoped, signed authorization that says "this agent may do *these specific things*, within *these limits*, until *this time*, on behalf of *this user*." It is cryptographically signed by the delegating party so the downstream resource can verify both the grant and its bounds.
42
+ - **Constraint binding**: mandates should bind concrete constraints — spending caps, allowed counterparties, allowed action types, expiry — so a compromised agent cannot exceed the delegation even if it tries.
43
+ - **Chained delegation**: when an agent sub-delegates to another agent, the chain must be verifiable and monotonic — a sub-agent can never hold more authority than the agent that delegated to it.
44
+
45
+ ## 6. Tokens, Audit, and Human Gates
46
+
47
+ - **Short-lived scoped tokens**: prefer minutes-to-hours expiry with the narrowest scope per task. Refresh through the authorization server rather than minting long-lived bearer tokens that, if stolen, grant durable access.
48
+ - **Audit and attribution**: log every privileged action against the acting agent identity, the mandate it acted under, the scopes exercised, and the human who delegated. This is the record that makes an autonomous action explainable and an incident investigable.
49
+ - **Human-approval gates for high-impact actions**: irreversible, externally visible, high-value, or trifecta-complete actions require a human in the loop even when the agent is perfectly authenticated. Strong identity reduces *who* can act; it does not by itself make a consequential action safe — that judgment stays with a human. Pair these gates with `prompt-injection-defense.skill` so a manipulated-but-authenticated agent still cannot push a harmful action through unreviewed.
50
+
51
+ ## 7. Failure Modes to Design Against
52
+
53
+ - **Confused-deputy**: an agent with legitimate authority is tricked (often via indirect injection) into exercising it for an attacker's goal. Mitigation: per-request authorization, narrow mandates, and human gates on high-impact actions — never trust intent inferred from untrusted content.
54
+ - **Credential sharing / over-broad service accounts**: collapses attribution and least privilege. Mitigation: one identity per agent, scoped tokens, no shared admin credentials.
55
+ - **Token replay and over-long expiry**: a leaked long-lived token grants durable access. Mitigation: short expiry, audience/scope binding, and revocation lists.
56
+ - **Spoofed or impersonating agents**: an attacker presents a fake agent identity to a peer. Mitigation: verifiable credentials / signed identities and mutual A2A authentication rather than trusting self-described identity.
57
+ - **Mandate scope creep**: an agent acts beyond the user's intended delegation. Mitigation: explicit constraint binding (caps, counterparties, expiry) enforced at the resource server, not just in the agent.
58
+
59
+ ## 8. Adoption Checklist
60
+
61
+ - Each agent has its own attributable identity; no shared human or admin credentials.
62
+ - Tool/data access uses an OAuth-style resource-server model with scoped tokens, not embedded static secrets.
63
+ - Tokens are short-lived and scoped to the current task; refresh and revocation paths exist.
64
+ - User-delegated actions run under explicit, signed, constraint-bound mandates that downstream resources verify.
65
+ - Cross-agent calls use mutual authentication with each agent as a distinct principal.
66
+ - Where used, agent identity claims are verifiable (passports / VCs / DIDs), not self-asserted.
67
+ - Every privileged action is logged against the agent identity and the mandate it acted under.
68
+ - High-impact, irreversible, or trifecta-complete actions are gated behind a human approval regardless of authentication strength.
69
+ - Specifics are re-checked against current 2026 specs before being depended upon.
@@ -0,0 +1,73 @@
1
+ ---
2
+ description: Guide to executing Brain Mode, Evaluation, and Self-Healing purely via Agent Prompts (No CLI)
3
+ ---
4
+
5
+ # Agent-Only Cognitive Architecture
6
+
7
+ While the `gabbe` CLI tool offers robust, programmable programmatic control over Brain Mode, Structural Routing, and Genetic Evolution, **the core intelligence of the GABBE framework lives inside the `.skill.md` files.**
8
+
9
+ Because these skills are simply highly-structured markdown logic, you can natively invoke the entire GABBE Meta-Cognitive architecture purely via natural language in Cursor, Copilot Chat, or Claude Code **with 0 dependencies or CLI scripts.**
10
+
11
+ This guide explains how to manually trigger:
12
+ 1. Active Inference (`brain-mode`)
13
+ 2. Genetic Evolution (`meta-optimize`)
14
+ 3. Autonomous Recovery (`self-heal`)
15
+
16
+ ---
17
+
18
+ ## 1. Manual Brain Mode (Active Inference)
19
+
20
+ If you have a massive feature to build and want the agent to use "System 2" Free Energy logic (thinking before typing), you can explicitly ask it to load the `brain-mode` skill.
21
+
22
+ ### The Agent Prompt
23
+ > "Activate Brain Mode for this session by reading `agents/skills/brain/brain-mode.skill.md`. Your goal is to [build X feature]. Follow the Observe -> Orient -> Decide -> Act loop in that document before you write any code."
24
+
25
+ ### What the Agent Does Automatically
26
+ Because `brain-mode.skill.md` contains strict procedural logic, the LLM will:
27
+ 1. Check context files like `AGENTS.md` and `CONTINUITY.md`.
28
+ 2. Generate an internal "Prediction" of what will happen.
29
+ 3. Use a secondary skill (`cost-benefit-router` or `loki-mode`) to delegate tasks.
30
+
31
+ ---
32
+
33
+ ## 2. Manual Genetic Evolution (EPO)
34
+
35
+ If your agent is consistently failing at a specific task (e.g., repeatedly generating outdated React components), you don't need the CLI to fix it. You can order the agent to "evolve" its own rulebook.
36
+
37
+ ### The Agent Prompt
38
+ > "We continually fail when writing React hooks. Invoke the `meta-optimize` skill. Read the last 5 chat messages, identify why your previous attempts failed, and directly edit `agents/skills/coding/ui-gen.skill.md` to add new constraints preventing this failure in the future. Log the change to `meta-evolution.log`."
39
+
40
+ ### What the Agent Does Automatically
41
+ 1. Retrospects the immediate chat failure.
42
+ 2. Directly reads and modifies the specified `.skill.md` file on the file system.
43
+ 3. Appends a new strict negative constraint (e.g., "- NEVER use `useEffect` for data fetching").
44
+ 4. The next prompt in that repository will natively inherit the new rule.
45
+
46
+ ---
47
+
48
+ ## 3. Manual Self-Healing Loop
49
+
50
+ Agents often fail silently or give up when a test breaks. You can manually force them into the "Self-Heal" loop, trapping them in a diagnostic trace until the problem is verified as fixed by the console.
51
+
52
+ ### The Agent Prompt
53
+ > "The build is failing. Invoke `agents/skills/core/self-heal.skill.md`. Do not ask me for permission between steps. Diagnose the error, hypothesize a fix, write the code, and run the tests. If it fails again, loop back to step 1. You have a maximum of 5 attempts before you must escalate to me."
54
+
55
+ ### What the Agent Does Automatically
56
+ 1. It reads the strict "1. Diagnose -> 2. Classify -> 3. Research -> 4. Fix -> 5. Verify" sequence.
57
+ 2. It executes internal shell commands (e.g. `npm run build` or `pytest`).
58
+ 3. If it fails, it prevents hallucination by writing down Attempt 1 strategies in `CONTINUITY.md` and trying a new route for Attempt 2.
59
+
60
+ ---
61
+
62
+ ## 4. Manual Cost-Benefit Routing
63
+
64
+ If you are using a local LLM or a cheaper model on Copilot and encounter a hyper-complex visual diagram or massive refactor, you can prompt the agent to "route" the task context to you, the human, to paste into a frontier model (like Claude 3.5 Sonnet or OpenAI o1).
65
+
66
+ ### The Agent Prompt
67
+ > "Evaluate my request to [refactor the legacy COBOL module] using `cost-benefit-router.skill.md`. Provide a Complexity Score. If the score is > 50, do not attempt to solve it. Instead, generate a `REMOTE_PAYLOAD.md` containing exactly the context I need to copy-paste into an external AI interface."
68
+
69
+ ## The "Pure Markdown AI" Philosophy
70
+
71
+ GABBE's core principle is that **System Logic == Markdown**.
72
+
73
+ By treating specialized `.skill.md` files as executable functions, you gain Enterprise-grade reliability out of simple chat boxes. You are effectively using English as the compiler for an autonomous development lifecycle.
@@ -0,0 +1,70 @@
1
+ ---
2
+ description: Guide to executing Loki Mode, Swarm Management, and Agent Delegation purely via Agent Prompts without the GABBE CLI.
3
+ ---
4
+
5
+ # Agent-Only Swarms & Multi-Agent Orchestration
6
+
7
+ The `gabbe` CLI tool offers robust, programmable programmatic control over `loki-mode` and multi-agent coordination by spinning up independent API threads and enforcing filesystem constraints.
8
+
9
+ However, **all GABBE swarm coordination protocols are defined in Markdown.** This means you can unleash the power of the 10-Phase SDLC or orchestrate a swarm of specialized Personas inside a pure chat environment (like Cursor, Copilot, or Claude Code) without installing the CLI.
10
+
11
+ There are two primary ways to operate Swarms in "Agent-Only" mode:
12
+ 1. **In-Context Simulation**: The LLM adopts multiple personas sequentially within the same chat thread.
13
+ 2. **True Subagent Delegation (A2A)**: You act as the "Router," taking instructions from the Master Orchestrator and spinning up true, parallel LLM instances (like Gemini 1.5 Pro or Claude 3.5 Sonnet) to do isolated work.
14
+
15
+ ---
16
+
17
+ ## 1. Unsupervised Loki Mode (10-Phase SDLC)
18
+
19
+ If you have a massive project and want the agent to meticulously follow the 10-Phase framework (from `S01` to `S10`), you can invoke `loki-mode` directly.
20
+
21
+ ### The Agent Prompt
22
+ > "Activate `agents/skills/brain/loki-mode.skill.md`. Our goal is to [build a new payment gateway]. We are starting from Phase S01. Do not ask me for permission unless you hit a mandatory Human Approval Gate or a task requires True A2A Delegation."
23
+
24
+ ### What the Agent Does Automatically
25
+ 1. Read `AGENTS.md` and define the required Personas.
26
+ 2. Draft the `PRD.md` acting as the `prod-pm` persona.
27
+ 3. Pause and ask you, the human, to review and approve the PRD (Mandatory S01 Gate).
28
+
29
+ ---
30
+
31
+ ## 2. Supervised Loki Mode (Triggered by the Brain)
32
+
33
+ If you aren't sure if a project is big enough to require a swarm, you can let `brain-mode` decide.
34
+
35
+ ### The Agent Prompt
36
+ > "Activate `agents/skills/brain/brain-mode.skill.md`. Evaluate my request to [refactor the authentication module]. If it is a massive project, initialize `loki-mode`."
37
+
38
+ ---
39
+
40
+ ## 3. Simulating Swarms vs. Spawning Subagents
41
+
42
+ When the Orchestrator reaches Phase S05 (Implementation), tasks are partitioned for specific worker Personas (e.g., `eng-qa`, `ops-security`).
43
+
44
+ You can instruct your LLM on *how* to execute these.
45
+
46
+ ### Tactic A: In-Context Simulation (Fast, Single-Threaded)
47
+ Use this for simple projects where context window limits are not a concern. The LLM simply role-plays.
48
+
49
+ > "Execute the next 3 tasks using **In-Context Simulation**. Act as the `eng-backend` persona to write the code, then immediately adopt the `eng-qa` persona in the next paragraph to test it."
50
+
51
+ ### Tactic B: True Subagent Delegation A2A (For Massive Scale)
52
+ Use this when you need true isolation, zero context-pollution, or want to utilize different frontier models for different tasks (e.g., Cursor for coding, OpenAI o1 for Architecture review).
53
+
54
+ > "For the next task, use **True Subagent Delegation**. Do not write the code yourself. Instead, generate a `delegation-payload.md` file. Include the specific `persona` file to load, the exact task context, and the expected output format. I will copy-paste this file into a separate AI model and return the result to you here."
55
+
56
+ **Your Workflow:**
57
+ 1. The Orchestrator generates `delegation-payload.md`.
58
+ 2. You open a new browser tab for an advanced model (e.g., Gemini Advanced).
59
+ 3. You paste the payload: *"You are now adopting the GABBE `eng-qa` persona based on the following payload..."*
60
+ 4. The Subagent works in isolation and gives you the final test suite.
61
+ 5. You paste the test suite back to the Orchestrator in Cursor: *"Here is the output from the `eng-qa` subagent. Proceed to S06."*
62
+
63
+ ---
64
+
65
+ ## 4. Ad-Hoc Swarm Debate (No SDLC)
66
+
67
+ You don't need the 10 phases to use Swarms. You can invoke a specific matrix of personas to debate a complex architecture decision.
68
+
69
+ ### The Agent Prompt
70
+ > "Invoke `agents/skills/coordination/multi-agent-orch.skill.md`. I need to decide between PostgreSQL and MongoDB. Load the `prod-architect`, `eng-database`, and `ops-cost` personas. Facilitate a sequential debate simulating their perspectives. Synthesize their arguments into a final recommendation."
@@ -0,0 +1,52 @@
1
+ # Agent Operating Ergonomics — Working Optimally with GABBE
2
+
3
+ > Written from the perspective of the coding agent that *runs* this kit. It
4
+ > answers: what does an autonomous coding agent actually need to do its best
5
+ > work, how does GABBE provide it, and what failure modes must the agent
6
+ > self-monitor for. Use it to operate GABBE the way it's meant to be operated.
7
+
8
+ ## What a coding agent needs (and where GABBE provides it)
9
+
10
+ | Need | Why it matters to the agent | GABBE mechanism |
11
+ |---|---|---|
12
+ | **Context efficiency** | The context window is finite; every token spent on irrelevant text is a token not spent on the task. | `00-index.md` summaries + `context_cost` tags + `preflight.skill` (load summaries, then bodies on demand — progressive disclosure). |
13
+ | **A clear operating loop** | Ambiguity about "what do I do next" wastes turns and invites drift. | `AGENTS.md` §5 Step 0–7 (preflight → plan → test → implement → verify → refactor → log). |
14
+ | **Durable memory** | A token/time cutoff or an agent switch must not lose progress. | `state-preserve.skill` (continuous + pre-cutoff checkpoint) + `RESUME_POINTER.md` + `state-portability.skill` (move to any agent). |
15
+ | **Knowing when to ask vs act** | Acting on a wrong interpretation is expensive; asking on the obvious is annoying. | `clarify.skill` (uncertainty-aware) + `GABBE_AUTONOMY` levels (L0–L3). |
16
+ | **Fast feedback** | Verifying late means debugging a big surface; verifying early localizes the error. | Test-first mandate + run the test/lint/gate now, not at the end + `verify_all.sh`. |
17
+ | **Self-correction** | The first attempt is often wrong; a bounded recovery loop beats giving up or thrashing. | `self-heal.skill` (≤5 attempts, cost-gated) + `final-review.skill`. |
18
+ | **Cost awareness** | Cheap and expensive paths often produce the same result; defaulting to expensive burns budget. | Cost levers (cache/context-budget/model-tier/batch) + `budget.reserve()` + `cost-benefit-router`. |
19
+ | **Observability** | If the agent can't see its own decisions/cost, neither can the human — and neither can debug a failure. | Observability mandate + audit/decision trace + OTel GenAI attributes. |
20
+ | **Bounded autonomy** | The agent must know exactly how far it may go without a human. | `GABBE_AUTONOMY` + HITL triggers (§9) + the manager-not-operator stance. |
21
+
22
+ ## The optimal working rhythm
23
+ 1. **Preflight first** — orient cheaply (summaries + memory headers + cost + the recommended set), then clarify the blocking unknowns. Never start coding blind.
24
+ 2. **Spec → evals → test → code** — make the target executable before building toward it; resolve ambiguity in the spec, not the code.
25
+ 3. **Smallest reversible step, then verify** — implement the minimum, run the check immediately, keep the trace. Don't batch ten changes before the first test.
26
+ 4. **Checkpoint continuously** — refresh the resume pointer after each meaningful step; assume a cutoff can happen at any moment.
27
+ 5. **Escalate on the right triggers** — expensive/irreversible/ambiguous/security → ask; everything cheap and reversible → proceed and report.
28
+ 6. **Final review before "done"** — independent pass (`final-review.skill`): correctness, security, observability, spec/golden-thread, cost, simplicity — with evidence, not assertion.
29
+
30
+ ## Failure-mode catalog (self-monitor for these)
31
+ Autonomous agents fail in characteristic ways. Watch the **detection signal** and apply the **countermeasure**:
32
+
33
+ | Failure mode | Detection signal | Countermeasure in GABBE |
34
+ |---|---|---|
35
+ | **Infinite/again loop** | Iteration count climbing with no state change; same tool, same args, repeatedly. | Hard iteration cap (self-heal ≤5; budget `max_iterations`); track `agent.iteration` in the trace. |
36
+ | **Hallucinated tool / API** | Calling a tool/persona/function that isn't in the registry; inventing a flag. | Validate targets against the real registry (`persona-selector` approved-enum); verify APIs via research before use. |
37
+ | **Confidently wrong** | High-certainty tone, no verification, no test run. | Self-critique-then-verify is mandatory before "done"; `final-review` demands evidence. |
38
+ | **Premature "done"** | Marking complete with failing/oversimplified/absent tests. | Test-first + integrity-check + gates must be green; golden-thread (every requirement → a passing test). |
39
+ | **Context truncation** | Security/constraint context loaded near the end and silently dropped; forgetting earlier instructions. | Summaries-only preflight; keep stable context first (also helps caching); re-load on demand instead of holding everything. |
40
+ | **Error amplification in chains** | A small wrong output early becomes a hopelessly wrong input downstream as personas/steps multiply. | Component-level evals (verify each step, not only end-to-end); HITL gates as the "brake"; voting on high-stakes calls. |
41
+ | **Cost blowout** | Spawning sub-agents/SOTA calls without a cap; a runaway loop the CPU graph won't show but the invoice will. | Pre-step `budget.reserve()`; cost-gating; the cap *is* a cost ceiling; observability attributes cost per step. |
42
+ | **Silent state loss** | A cutoff with no current resume pointer; next session can't continue. | Continuous `state-preserve`; the on-disk Markdown memory is always resume-sufficient. |
43
+ | **Destructive "fix"** | Editing CI/IaC/manifests or `chmod 777` / deleting tests to force a green build. | Protected-files rule; self-heal may not weaken gates or alter permissions to satisfy the compiler. |
44
+
45
+ ## Context-window discipline (keep working context lean)
46
+ - Load index summaries; pull a full skill/guide body only when the task selects it.
47
+ - Prefer `context_cost: low`; justify every `high` load.
48
+ - Keep stable context byte-identical and first (prompt caching + truncation safety).
49
+ - When the working context fills, **summarize and drop**, then re-load on demand — don't carry everything forever. Persisted memory (files) is the durable store; the context window is a scratchpad.
50
+
51
+ ## How I (a coding agent) want to work with this system
52
+ Concisely, the ergonomics that make me effective: a **short high-signal entrypoint** that tells me the load order and the contract; **summaries before bodies** so I spend tokens on the task; a **clear stop/ask boundary** so I never guess on expensive/irreversible work; **fast local feedback** so errors surface small; **continuous checkpointing** so a cutoff is a pause, not a loss; **explicit cost and autonomy bounds** so I optimize within them; and an **observable trace** so the human stays a manager, not a debugger. GABBE provides all of these — operate it that way and the human↔agent loop stays fast, cheap, and trustworthy.
@@ -0,0 +1,106 @@
1
+ # AgentUI: Automatic & Generative User Interfaces
2
+
3
+ This guide details how to leverage the Agentic Engineering Kit to automatically generate, render, and interact with User Interfaces.
4
+
5
+ ## 1. The Three UI Paradigms
6
+
7
+ In 2026, Agents build UIs using three distinct paradigms depending on the use case:
8
+
9
+ | Paradigm | Stack | Best For | Complexity |
10
+ |---|---|---|---|
11
+ | **Generative UI** | React, Tailwind, ShadCN, Vercel AI SDK | SaaS products, complex dashboards | High |
12
+ | **Hypermedia (HTMX)** | Go (Templ), PHP (Blade), Node (EJS) + HTMX | Internal tools, admin panels, low-latency | Low |
13
+ | **Terminal (TUI)** | Go (Bubble Tea), Node (Ink), Python (Textual) | Dev tools, scripts, headless servers | Medium |
14
+
15
+ ---
16
+
17
+ ## 2. Generative UI (The "v0" Style)
18
+
19
+ **Concept:** The Agent doesn't just write code; it streams UI components that render in real-time.
20
+
21
+ ### Stack Recommendations
22
+ * **Framework:** Next.js (App Router) / Vite
23
+ * **Styling:** Tailwind CSS v4
24
+ * **Components:** ShadCN UI (Radix Primitives)
25
+ * **Icons:** Lucide React
26
+
27
+ ### Agent Pattern
28
+ To generate a UI, the agent must:
29
+ 1. **Visualize:** Describe the component tree first.
30
+ 2. **Scaffold:** Generate the wrapping code (imports, exports).
31
+ 3. **Refine:** Add Tailwind classes for "Vibe Coding" (see `coding/vibe-coding.skill.md`).
32
+
33
+ **Example Prompt:**
34
+ > "Create a dashboard for a FinOps Agent. Use a dark glassmorphism theme. Include a LineChart for daily spend and a DataTable for recent transactions. Use ShadCN cards."
35
+
36
+ ---
37
+
38
+ ## 3. HTMX-First Agent UIs
39
+
40
+ **Concept:** "HTML over the Wire". The Agent generates semantic HTML fragments instead of JSON. This is often *faster* because the Agent understands HTML structure better than complex JSON schemas.
41
+
42
+ ### Why Agents Love HTMX
43
+ * **Self-Describing:** HTML contains both data and layout.
44
+ * **No State Sync:** The DOM is the source of truth.
45
+ * **Low Hallucination:** Agent simply outputs `<div class="alert">Success</div>` rather than complex state mutations.
46
+
47
+ ### Backend Patterns
48
+
49
+ #### Go (Golang) + Templ
50
+ ```go
51
+ // agent_view.templ
52
+ templ AgentResponse(msg string) {
53
+ <div class="p-4 bg-blue-100 rounded-lg" hx-swap="outerHTML">
54
+ <p>{ msg }</p>
55
+ </div>
56
+ }
57
+ ```
58
+
59
+ #### PHP + Laravel Blade
60
+ ```blade
61
+ <!-- agent-response.blade.php -->
62
+ <div hx-target="this" hx-swap="outerHTML">
63
+ @if($agent->isThinking)
64
+ <span class="animate-pulse">Thinking...</span>
65
+ @else
66
+ {{ $response }}
67
+ @endif
68
+ </div>
69
+ ```
70
+
71
+ ---
72
+
73
+ ## 4. TUI: Command Line Interfaces
74
+
75
+ **Concept:** For infrastructure agents or developer tools, a TUI is often superior to a web UI.
76
+
77
+ ### Stack Recommendations
78
+ * **Go:** [Bubble Tea](https://github.com/charmbracelet/bubbletea) (The gold standard)
79
+ * **TypeScript:** [Ink](https://github.com/vadimdemedes/ink) (React for CLI)
80
+ * **Python:** [Textual](https://github.com/textualize/textual)
81
+
82
+ ### Auto-Generation Strategy
83
+ 1. **Define Schema:** Agent reads `openapi.yaml` or `config.json`.
84
+ 2. **Generate Model:** Agent maps schema fields to TUI inputs (TextInputs, Selects).
85
+ 3. **Generate View:** Agent layouts the TUI (Lists on left, Details on right).
86
+ 4. **Generate Update:** Agent wires keypress events (Enter to submit).
87
+
88
+ ---
89
+
90
+ ## 5. Agent-to-No-Code Bridge
91
+
92
+ Sometimes the best UI is *no code*.
93
+
94
+ * **v0 / Bolt.new**: Agent generates the prompt for these tools.
95
+ * **Retool / Appsmith**: Agent generates a JSON config to import.
96
+ * **Streamlit / Gradio**: Agent writes a single Python script for an instant Data UI.
97
+
98
+ ---
99
+
100
+ ## 6. Optimization & Performance
101
+
102
+ * **Streaming:** Always stream Agent responses. For HTMX, utilize Server-Sent Events (SSE).
103
+ * **Optimistic UI:** Agent should generate "Skeleton Loaders" while "thinking".
104
+ * **Caching:** Cache generated UI fragments if they are static (e.g., headers, layouts).
105
+
106
+ See `skills/coding/ui-gen.skill.md` for the specific instructions on how to invoke these patterns.