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,84 @@
1
+ #!/bin/sh
2
+ # state_export.sh — dehydrate GABBE working state into a portable, agent-agnostic
3
+ # bundle so the user can continue in ANY other coding agent or LLM.
4
+ #
5
+ # Produces:
6
+ # STATE_HANDOFF.md — one self-contained Markdown file (paste into any LLM)
7
+ # gabbe-state-<stamp>.tar.gz — lossless bundle (memory + tasks + config + instructions)
8
+ #
9
+ # Python-independent on purpose. The Markdown memory IS the state; this just
10
+ # packages it. Secrets are never exported (.env and friends are excluded).
11
+ #
12
+ # Usage: sh agents/scripts/state_export.sh [KIT_ROOT] [OUT_DIR]
13
+
14
+ set -eu
15
+
16
+ SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
17
+ KIT_ROOT=${1:-$(CDPATH= cd -- "$SCRIPT_DIR/../.." && pwd)}
18
+ OUT_DIR=${2:-$KIT_ROOT}
19
+ AGENTS_DIR="$KIT_ROOT/agents"
20
+ MEM_DIR="$AGENTS_DIR/memory"
21
+
22
+ # Timestamp: prefer a real clock, but stay deterministic-friendly if unavailable.
23
+ STAMP=$(date -u +%Y%m%dT%H%M%SZ 2>/dev/null || echo "export")
24
+ HANDOFF="$OUT_DIR/STATE_HANDOFF.md"
25
+ BUNDLE="$OUT_DIR/gabbe-state-$STAMP.tar.gz"
26
+
27
+ emit_file() {
28
+ # $1 = label, $2 = path
29
+ echo "## $1"
30
+ if [ -f "$2" ]; then
31
+ echo '```markdown'
32
+ cat "$2"
33
+ echo '```'
34
+ else
35
+ echo "_(not present)_"
36
+ fi
37
+ echo ""
38
+ }
39
+
40
+ KIT_VERSION=$(grep -o 'GABBE Kit version: [0-9.]*' "$AGENTS_DIR/CONSTITUTION.md" 2>/dev/null | head -1 | grep -o '[0-9.]*' || echo "unknown")
41
+ AUTONOMY="hybrid"
42
+ CFG="$KIT_ROOT/project/gabbe.config.json"
43
+ if [ -f "$CFG" ]; then
44
+ VAL=$(grep -o '"autonomy"[[:space:]]*:[[:space:]]*"[a-z]*"' "$CFG" 2>/dev/null | grep -o '[a-z]*"$' | tr -d '"' || true)
45
+ [ -n "${VAL:-}" ] && AUTONOMY="$VAL"
46
+ fi
47
+
48
+ # --- 1. STATE_HANDOFF.md (single portable file, any LLM can read) ---
49
+ {
50
+ echo "# STATE_HANDOFF — GABBE portable state"
51
+ echo "- Generated: $STAMP Kit version: $KIT_VERSION Autonomy: $AUTONOMY"
52
+ echo ""
53
+ echo "## How to continue (any agent or LLM)"
54
+ echo "1. Load agents/AGENTS.md (operating loop) and CONSTITUTION.md (project law)."
55
+ echo "2. Run session-resume.skill, then preflight.skill."
56
+ echo "3. Start from the NEXT ACTION in the RESUME POINTER below."
57
+ echo ""
58
+ emit_file "RESUME POINTER" "$MEM_DIR/RESUME_POINTER.md"
59
+ emit_file "PROJECT STATE" "$MEM_DIR/PROJECT_STATE.md"
60
+ emit_file "CONTINUITY (past failures to avoid)" "$MEM_DIR/CONTINUITY.md"
61
+ emit_file "OPEN TASKS" "$KIT_ROOT/project/TASKS.md"
62
+ SNAP_DIR="$MEM_DIR/episodic/SESSION_SNAPSHOT"
63
+ if [ -d "$SNAP_DIR" ]; then
64
+ LATEST=$(ls -1t "$SNAP_DIR" 2>/dev/null | head -1 || true)
65
+ [ -n "${LATEST:-}" ] && emit_file "LATEST SNAPSHOT ($LATEST)" "$SNAP_DIR/$LATEST"
66
+ fi
67
+ } > "$HANDOFF"
68
+
69
+ # --- 2. Lossless bundle (excludes secrets) ---
70
+ # Build a relative file list from KIT_ROOT so the tar is portable.
71
+ ( cd "$KIT_ROOT" && tar \
72
+ --exclude='*.env' --exclude='.env' --exclude='*secret*' --exclude='*.key' \
73
+ --exclude='.preflight_skill_count' --exclude='.import-backup*' \
74
+ -czf "$BUNDLE" \
75
+ agents/AGENTS.md agents/CONSTITUTION.md \
76
+ agents/memory \
77
+ project/TASKS.md \
78
+ $( [ -f "project/gabbe.config.json" ] && echo project/gabbe.config.json ) \
79
+ 2>/dev/null ) || echo " (bundle: some paths missing; STATE_HANDOFF.md is still complete)"
80
+
81
+ echo "Dehydrated state:"
82
+ echo " - $HANDOFF (portable single file — paste into any agent/LLM)"
83
+ [ -f "$BUNDLE" ] && echo " - $BUNDLE (lossless bundle — import with state_import.sh)"
84
+ echo "Next: continue in any agent → run session-resume.skill then preflight.skill."
@@ -0,0 +1,99 @@
1
+ #!/bin/sh
2
+ # state_import.sh — hydrate GABBE working state from a portable bundle produced by
3
+ # state_export.sh, so work continues in THIS agent exactly where another left off.
4
+ #
5
+ # Safe by default: extracts to a staging dir and reports what would change. Pass
6
+ # --apply to actually merge into the project. Never silently overwrites newer
7
+ # local state — conflicts are surfaced for the human/agent to resolve.
8
+ #
9
+ # Usage:
10
+ # sh agents/scripts/state_import.sh gabbe-state-<stamp>.tar.gz [KIT_ROOT] # dry-run
11
+ # sh agents/scripts/state_import.sh --apply gabbe-state-<stamp>.tar.gz [KIT_ROOT] # merge
12
+
13
+ set -eu
14
+
15
+ APPLY=0
16
+ if [ "${1:-}" = "--apply" ]; then APPLY=1; shift; fi
17
+
18
+ BUNDLE=${1:?usage: state_import.sh [--apply] <bundle.tar.gz> [KIT_ROOT]}
19
+ SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
20
+ KIT_ROOT=${2:-$(CDPATH= cd -- "$SCRIPT_DIR/../.." && pwd)}
21
+
22
+ [ -f "$BUNDLE" ] || { echo "ERROR: bundle not found: $BUNDLE" >&2; exit 1; }
23
+
24
+ # mktemp must succeed — a predictable fixed fallback (/tmp/gabbe-import-stage) is a
25
+ # symlink/pre-seed target an attacker could exploit, then rm -rf would follow it.
26
+ # Use an explicit template: bare `mktemp -d` is non-portable under BSD/macOS sh,
27
+ # which requires a template (the XXXXXX keeps the dir name unpredictable).
28
+ STAGE=$(mktemp -d "${TMPDIR:-/tmp}/gabbe-import.XXXXXX") || { echo "ERROR: mktemp failed; refusing to use a predictable temp dir." >&2; exit 1; }
29
+
30
+ # Fail the link/path checks if any stage of the pipeline errors (e.g. corrupt archive).
31
+ set -o pipefail 2>/dev/null || true
32
+
33
+ # The bundle is untrusted input. Reject any member with an absolute path or a
34
+ # ".." traversal component BEFORE extracting, so a crafted archive cannot write
35
+ # outside $STAGE. (GNU tar's --no-absolute-names is not portable, so validate.)
36
+ if tar -tzf "$BUNDLE" | grep -qE '^/|(^|/)\.\.(/|$)'; then
37
+ echo "ERROR: archive contains unsafe paths (absolute or '..'); refusing to extract." >&2
38
+ rm -rf "$STAGE"
39
+ exit 1
40
+ fi
41
+ # Reject symlink/hardlink members too: a link member plus a write-through member
42
+ # can redirect a write outside $STAGE (matches the Python extractor's guard). In
43
+ # tar's verbose listing the type char is the first column (l=symlink, h=hardlink).
44
+ if tar -tvzf "$BUNDLE" 2>/dev/null | grep -qE '^[lh]'; then
45
+ echo "ERROR: archive contains symlink/hardlink members; refusing to extract." >&2
46
+ rm -rf "$STAGE"
47
+ exit 1
48
+ fi
49
+ # --no-same-owner/--no-same-permissions: never honor a crafted archive's uid/gid or
50
+ # setuid bits (matters if ever run as root); the Python extractor is the safer model.
51
+ tar --no-same-owner --no-same-permissions -xzf "$BUNDLE" -C "$STAGE"
52
+
53
+ echo "Staged bundle contents:"
54
+ ( cd "$STAGE" && find . -type f | sed 's/^/ /' | head -60 )
55
+ echo ""
56
+
57
+ # Integrity hint: warn if instruction files differ (must be human-reviewed, not auto-clobbered).
58
+ for f in agents/AGENTS.md agents/CONSTITUTION.md; do
59
+ if [ -f "$STAGE/$f" ] && [ -f "$KIT_ROOT/$f" ]; then
60
+ if ! cmp -s "$STAGE/$f" "$KIT_ROOT/$f"; then
61
+ echo " [REVIEW] $f differs from local — instruction files are NOT auto-overwritten."
62
+ fi
63
+ fi
64
+ done
65
+
66
+ if [ "$APPLY" -eq 0 ]; then
67
+ echo ""
68
+ echo "Dry run. Re-run with --apply to merge memory + tasks + config into the project."
69
+ echo " sh agents/scripts/state_import.sh --apply $BUNDLE"
70
+ echo "Staging dir: $STAGE"
71
+ exit 0
72
+ fi
73
+
74
+ # --apply: merge memory/tasks/config. Memory is additive; back up anything replaced.
75
+ BACKUP="$KIT_ROOT/agents/memory/.import-backup-$(date -u +%Y%m%dT%H%M%SZ 2>/dev/null || echo bak)"
76
+ copy_in() {
77
+ # $1 = relative path under bundle/project
78
+ SRC="$STAGE/$1"; DST="$KIT_ROOT/$1"
79
+ [ -e "$SRC" ] || return 0
80
+ if [ -e "$DST" ] && ! cmp -s "$SRC" "$DST" 2>/dev/null; then
81
+ mkdir -p "$BACKUP/$(dirname "$1")"
82
+ cp -R "$DST" "$BACKUP/$1" 2>/dev/null || true
83
+ echo " backed up existing $1 -> $BACKUP/$1"
84
+ fi
85
+ mkdir -p "$(dirname "$DST")"
86
+ cp -R "$SRC" "$DST"
87
+ echo " imported $1"
88
+ }
89
+
90
+ # Merge the memory tree and task/config; leave AGENTS/CONSTITUTION to human review.
91
+ ( cd "$STAGE/agents/memory" 2>/dev/null && find . -type f | while read -r rel; do
92
+ copy_in "agents/memory/${rel#./}"
93
+ done ) || true
94
+ copy_in "project/TASKS.md"
95
+ copy_in "project/gabbe.config.json"
96
+
97
+ echo ""
98
+ echo "Hydrated. Now run session-resume.skill then preflight.skill to continue from NEXT ACTION."
99
+ [ -d "$BACKUP" ] && echo "Replaced files were backed up under: $BACKUP"
@@ -0,0 +1,98 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ import py_compile
4
+ import sys
5
+ from pathlib import Path
6
+
7
+ # Configuration
8
+ PROJECT_ROOT = Path(__file__).parent.parent.parent
9
+ AGENTS_DIR = PROJECT_ROOT / "agents"
10
+
11
+ RED = "\033[0;31m"
12
+ GREEN = "\033[0;32m"
13
+ BLUE = "\033[0;34m"
14
+ NC = "\033[0m"
15
+
16
+ REQUIRED_FILES = [
17
+ PROJECT_ROOT / "scripts/init.py",
18
+ PROJECT_ROOT / "README.md",
19
+ AGENTS_DIR / "AGENTS.md",
20
+ AGENTS_DIR / "CONSTITUTION.md",
21
+ AGENTS_DIR / "skills/00-index.md",
22
+ AGENTS_DIR / "templates/00-index.md",
23
+ ]
24
+
25
+ REQUIRED_DIRS = [
26
+ AGENTS_DIR / "skills",
27
+ AGENTS_DIR / "templates",
28
+ AGENTS_DIR / "guides",
29
+ AGENTS_DIR / "memory",
30
+ ]
31
+
32
+
33
+ def check_exists(path):
34
+ if not path.exists():
35
+ print(f"{RED}[MISSING] {path.relative_to(PROJECT_ROOT)}{NC}")
36
+ return False
37
+ return True
38
+
39
+
40
+ def check_python_syntax(path):
41
+ try:
42
+ py_compile.compile(path, doraise=True)
43
+ # print(f"{GREEN}[SYNTAX OK] {path.relative_to(PROJECT_ROOT)}{NC}")
44
+ return True
45
+ except py_compile.PyCompileError as e:
46
+ print(f"{RED}[SYNTAX ERROR] {path.relative_to(PROJECT_ROOT)}: {e}{NC}")
47
+ return False
48
+
49
+
50
+ def main():
51
+ print(f"{BLUE}Validating GABBE Project Integrity...{NC}")
52
+ errors = 0
53
+
54
+ # 1. Check Essential Files
55
+ print(f"\n{BLUE}1. Checking Essential Files...{NC}")
56
+ for f in REQUIRED_FILES:
57
+ if not check_exists(f):
58
+ errors += 1
59
+
60
+ for d in REQUIRED_DIRS:
61
+ if not check_exists(d):
62
+ errors += 1
63
+
64
+ # 2. Check Python Syntax
65
+ print(f"\n{BLUE}2. Checking Python Scripts...{NC}")
66
+ python_files = list(PROJECT_ROOT.glob("*.py")) + list(AGENTS_DIR.rglob("*.py"))
67
+ for py_file in python_files:
68
+ if not check_python_syntax(py_file):
69
+ errors += 1
70
+
71
+ # 3. Check Templates (Basic Existence)
72
+ print(f"\n{BLUE}3. Checking Template Directories...{NC}")
73
+ template_cats = [
74
+ "coding",
75
+ "architecture",
76
+ "ops",
77
+ "security",
78
+ "product",
79
+ "core",
80
+ "coordination",
81
+ "brain",
82
+ ]
83
+ for cat in template_cats:
84
+ d = AGENTS_DIR / "templates" / cat
85
+ if not check_exists(d):
86
+ errors += 1
87
+
88
+ print("-" * 40)
89
+ if errors > 0:
90
+ print(f"{RED}Found {errors} integrity errors.{NC}")
91
+ sys.exit(1)
92
+ else:
93
+ print(f"{GREEN}Project integrity check passed!{NC}")
94
+ sys.exit(0)
95
+
96
+
97
+ if __name__ == "__main__":
98
+ main()
@@ -0,0 +1,96 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ import re
4
+ import sys
5
+ from pathlib import Path
6
+
7
+ PROJECT_ROOT = Path(__file__).parent.parent.parent
8
+
9
+ RED = "\033[0;31m"
10
+ GREEN = "\033[0;32m"
11
+ NC = "\033[0m"
12
+
13
+ # Regex to find [text](link)
14
+ LINK_PATTERN = re.compile(r"\[([^\]]+)\]\(([^)]+)\)")
15
+
16
+
17
+ def validate_link(file_path, link_target):
18
+ # Ignore template placeholders like [field], [value]
19
+ if link_target in ["value", "link", "url", "path", "field"]:
20
+ return True
21
+ # Ignore external links
22
+ if link_target.startswith("http") or link_target.startswith("mailto:"):
23
+ return True
24
+
25
+ # Ignore anchors for now (unless we want to parse target file headers)
26
+ link_path = link_target.split("#")[0]
27
+ if not link_path:
28
+ return True # Just an anchor in same file
29
+
30
+ # Resolve path
31
+ if link_path.startswith("/"):
32
+ # Absolute path relative to project root? Usually MD links are relative.
33
+ # Let's assume absolute paths in MD are rare or refer to system root (bad practice usually)
34
+ # But if they mean project root:
35
+ target_abs = PROJECT_ROOT / link_path.lstrip("/")
36
+ else:
37
+ target_abs = (file_path.parent / link_path).resolve()
38
+
39
+ if not target_abs.exists():
40
+ return False
41
+ return True
42
+
43
+
44
+ def main():
45
+ print(f"Scanning markdown links in {PROJECT_ROOT}...")
46
+ errors = 0
47
+ checked_files = 0
48
+ checked_links = 0
49
+
50
+ # Directories that are not part of the project's own docs (dependencies,
51
+ # build output, VCS, bytecode) and must not be link-checked.
52
+ EXCLUDED_DIRS = (
53
+ "node_modules",
54
+ ".venv",
55
+ "venv",
56
+ ".git",
57
+ "__pycache__",
58
+ "build",
59
+ "dist",
60
+ ".egg-info",
61
+ "site-packages",
62
+ )
63
+
64
+ for md_file in PROJECT_ROOT.rglob("*.md"):
65
+ if any(ex in part for part in md_file.parts for ex in EXCLUDED_DIRS):
66
+ continue
67
+
68
+ checked_files += 1
69
+ content = md_file.read_text()
70
+
71
+ # Remove code blocks to avoid false positives
72
+ content = re.sub(r"```.*?```", "", content, flags=re.DOTALL)
73
+ content = re.sub(r"`[^`]*`", "", content)
74
+
75
+ links = LINK_PATTERN.findall(content)
76
+
77
+ for text, target in links:
78
+ checked_links += 1
79
+ if not validate_link(md_file, target):
80
+ print(
81
+ f"{RED}[FAIL] {md_file.relative_to(PROJECT_ROOT)}: Broken link '{target}'{NC}"
82
+ )
83
+ errors += 1
84
+
85
+ print("-" * 40)
86
+ print(f"Checked {checked_files} files and {checked_links} links.")
87
+ if errors > 0:
88
+ print(f"{RED}Found {errors} broken links.{NC}")
89
+ sys.exit(1)
90
+ else:
91
+ print(f"{GREEN}All links valid!{NC}")
92
+ sys.exit(0)
93
+
94
+
95
+ if __name__ == "__main__":
96
+ main()
@@ -0,0 +1,194 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ """Methodology-graph validator (Track E7).
4
+
5
+ Goes beyond per-file structural checks (validate_skills / validate_links) to verify
6
+ the *graph* of the methodology layer is coherent — the lifecycle flow, persona
7
+ handoffs, the memory state model, and index↔file bijection. Catches dangling
8
+ phase→asset references, orphaned/unregistered skills, and missing memory layers:
9
+ the "flows / logic / states / architecture" consistency the framework promises.
10
+
11
+ Hard checks exit 1 on failure. Softer observations are printed as warnings.
12
+ """
13
+
14
+ from __future__ import annotations
15
+
16
+ import re
17
+ import sys
18
+ from pathlib import Path
19
+
20
+ PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent
21
+ AGENTS_DIR = PROJECT_ROOT / "agents"
22
+
23
+ RED = "\033[0;31m"
24
+ GREEN = "\033[0;32m"
25
+ YELLOW = "\033[0;33m"
26
+ BLUE = "\033[0;34m"
27
+ NC = "\033[0m"
28
+
29
+ # Files that describe the lifecycle flow / orchestration state machine.
30
+ FLOW_FILES = [
31
+ AGENTS_DIR / "guides/processes/loki-sdlc-phases.md",
32
+ AGENTS_DIR / "skills/brain/loki-mode.skill.md",
33
+ AGENTS_DIR / "guides/processes/full-system-lifecycle.md",
34
+ ]
35
+
36
+ # The 4-layer memory state model (RESUME_POINTER → PROJECT_STATE → CONTINUITY → AUDIT_LOG).
37
+ MEMORY_LAYERS = ["RESUME_POINTER", "PROJECT_STATE", "CONTINUITY", "AUDIT_LOG"]
38
+
39
+ # Hard human-approval gates that must be present in the lifecycle.
40
+ REQUIRED_GATES = ["S01", "S02", "S07", "S08"]
41
+
42
+ # Asset path reference: skills/.../x.skill.md OR templates|personas|guides/.../x.md.
43
+ # (agents/memory/** paths in the flow docs are RUNTIME write-targets — e.g. per-run
44
+ # episodic snapshots — not static repo assets, so they are not existence-checked here;
45
+ # the live memory layers are verified separately by check_memory_state_model.)
46
+ _ASSET_RE = re.compile(r"\b((?:skills|templates|personas|guides)/[\w./-]+?\.(?:skill\.md|md|json))")
47
+
48
+
49
+ class Graph:
50
+ def __init__(self) -> None:
51
+ self.errors: list[str] = []
52
+ self.warnings: list[str] = []
53
+
54
+ def fail(self, msg: str) -> None:
55
+ self.errors.append(msg)
56
+ print(f"{RED}x FAIL: {msg}{NC}")
57
+
58
+ def warn(self, msg: str) -> None:
59
+ self.warnings.append(msg)
60
+ print(f"{YELLOW}! WARN: {msg}{NC}")
61
+
62
+ def ok(self, msg: str) -> None:
63
+ print(f"{GREEN}✓ {msg}{NC}")
64
+
65
+
66
+ def _resolve(token: str) -> Path:
67
+ """Resolve a doc-relative asset reference to a real path."""
68
+ if token.startswith("agents/"):
69
+ return PROJECT_ROOT / token
70
+ return AGENTS_DIR / token
71
+
72
+
73
+ def check_asset_references(g: Graph) -> None:
74
+ """Every asset a lifecycle phase points to must exist (no dangling flow edge)."""
75
+ print(f"\n{BLUE}=== Lifecycle flow → asset references resolve ==={NC}")
76
+ checked = 0
77
+ for fpath in FLOW_FILES:
78
+ if not fpath.exists():
79
+ g.warn(f"flow file missing: {fpath.relative_to(PROJECT_ROOT)}")
80
+ continue
81
+ text = fpath.read_text()
82
+ refs = set(_ASSET_RE.findall(text))
83
+ for ref in sorted(refs):
84
+ checked += 1
85
+ if not _resolve(ref).exists():
86
+ g.fail(f"{fpath.name} references missing asset: {ref}")
87
+ g.ok(f"checked {checked} lifecycle asset references")
88
+
89
+
90
+ def check_skill_index_bijection(g: Graph) -> None:
91
+ """Every skill file is registered in the index, and every indexed path resolves."""
92
+ print(f"\n{BLUE}=== Skill index ↔ file bijection ==={NC}")
93
+ idx = (AGENTS_DIR / "skills/00-index.md").read_text()
94
+ indexed = {
95
+ m.replace("skills/", "")
96
+ for m in re.findall(r"`((?:skills/)?[\w-]+/[\w-]+\.skill\.md)`", idx)
97
+ }
98
+ files = {
99
+ str(p.relative_to(AGENTS_DIR / "skills"))
100
+ for p in (AGENTS_DIR / "skills").glob("**/*.skill.md")
101
+ }
102
+
103
+ unregistered = sorted(files - indexed)
104
+ for u in unregistered:
105
+ g.fail(f"skill file not registered in skills/00-index.md: {u}")
106
+ dangling = sorted(t for t in indexed if not (AGENTS_DIR / "skills" / t).exists())
107
+ for d in dangling:
108
+ g.fail(f"skills/00-index.md references missing skill file: {d}")
109
+ if not unregistered and not dangling:
110
+ g.ok(f"all {len(files)} skill files registered and resolvable")
111
+
112
+
113
+ def check_persona_index_bijection(g: Graph) -> None:
114
+ print(f"\n{BLUE}=== Persona index ↔ file bijection ==={NC}")
115
+ idx = (AGENTS_DIR / "personas/00-index.md").read_text()
116
+ files = {p.stem for p in (AGENTS_DIR / "personas").glob("*.md") if p.stem != "00-index"}
117
+ for slug in sorted(files):
118
+ if slug not in idx:
119
+ g.fail(f"persona file not registered in personas/00-index.md: {slug}")
120
+ g.ok(f"checked {len(files)} persona files against the index")
121
+
122
+
123
+ def check_memory_state_model(g: Graph) -> None:
124
+ """The 4-layer memory model must exist and be wired into the orchestration spine."""
125
+ print(f"\n{BLUE}=== Memory state model (4 layers) ==={NC}")
126
+ loki = AGENTS_DIR / "skills/brain/loki-mode.skill.md"
127
+ loki_text = loki.read_text() if loki.exists() else ""
128
+ mem_dir = AGENTS_DIR / "memory"
129
+ for layer in MEMORY_LAYERS:
130
+ present = list(mem_dir.glob(f"{layer}*.md"))
131
+ if not present:
132
+ g.fail(f"memory layer artifact missing: {layer}*.md under agents/memory/")
133
+ if layer not in loki_text:
134
+ g.warn(f"memory layer '{layer}' not referenced in loki-mode.skill.md")
135
+ if not g.errors:
136
+ g.ok("all 4 memory layers present")
137
+
138
+
139
+ def check_lifecycle_dag(g: Graph) -> None:
140
+ """Lifecycle phases form a contiguous sequence with the hard approval gates present."""
141
+ print(f"\n{BLUE}=== Lifecycle DAG + approval gates ==={NC}")
142
+ phases_text = (AGENTS_DIR / "guides/processes/loki-sdlc-phases.md").read_text()
143
+ phases = sorted(set(re.findall(r"\bPHASE\s+(S\d{2})\b", phases_text)))
144
+ if not phases:
145
+ g.fail("no PHASE S## definitions found in loki-sdlc-phases.md")
146
+ return
147
+ g.ok(f"phases defined: {', '.join(phases)}")
148
+ for gate in REQUIRED_GATES:
149
+ if gate not in phases:
150
+ g.fail(f"required human-approval gate phase {gate} not defined")
151
+ # Day-0 / Day-2 phases are added by Track A — report status without failing.
152
+ for extra in ["S00", "S11", "S12", "S13"]:
153
+ if extra not in phases:
154
+ g.warn(f"lifecycle phase {extra} not yet defined (Track A1 — Day-0/Day-2 extension)")
155
+
156
+
157
+ def check_skill_shape(g: Graph) -> None:
158
+ """Soft check: skills should carry the canonical sections."""
159
+ print(f"\n{BLUE}=== Skill shape (canonical sections) ==={NC}")
160
+ required = ["## Goal", "## Steps", "## Constraints", "## Output Format"]
161
+ missing_any = 0
162
+ for skill in (AGENTS_DIR / "skills").glob("**/*.skill.md"):
163
+ text = skill.read_text()
164
+ gaps = [s for s in required if s not in text]
165
+ if gaps:
166
+ missing_any += 1
167
+ g.warn(f"{skill.relative_to(AGENTS_DIR)} missing section(s): {', '.join(gaps)}")
168
+ if missing_any == 0:
169
+ g.ok("all skills carry the canonical Goal/Steps/Constraints/Output sections")
170
+
171
+
172
+ def main() -> None:
173
+ print(f"{YELLOW}Validating GABBE methodology graph (flows / personas / memory / index)...{NC}")
174
+ g = Graph()
175
+ check_asset_references(g)
176
+ check_skill_index_bijection(g)
177
+ check_persona_index_bijection(g)
178
+ check_memory_state_model(g)
179
+ check_lifecycle_dag(g)
180
+ check_skill_shape(g)
181
+
182
+ print(f"\n{BLUE}=== Methodology Graph Summary ==={NC}")
183
+ print(f" warnings: {len(g.warnings)}")
184
+ if g.errors:
185
+ print(f"{RED}{len(g.errors)} methodology-graph errors:{NC}")
186
+ for e in g.errors:
187
+ print(f" - {e}")
188
+ sys.exit(1)
189
+ print(f"{GREEN}Methodology graph is coherent (flows, personas, memory, indexes).{NC}")
190
+ sys.exit(0)
191
+
192
+
193
+ if __name__ == "__main__":
194
+ main()
@@ -0,0 +1,81 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ import sys
4
+ from pathlib import Path
5
+
6
+ # Configuration
7
+ AGENTS_DIR = Path(__file__).parent.parent
8
+ SKILLS_DIR = AGENTS_DIR / "skills"
9
+
10
+ RED = "\033[0;31m"
11
+ GREEN = "\033[0;32m"
12
+ NC = "\033[0m"
13
+
14
+
15
+ def validate_frontmatter(file_path):
16
+ content = file_path.read_text()
17
+ if not content.startswith("---"):
18
+ return False, "Missing YAML start (---)"
19
+
20
+ end_yaml = content.find("---", 3)
21
+ if end_yaml == -1:
22
+ return False, "Missing YAML end (---)"
23
+
24
+ yaml_block = content[3:end_yaml]
25
+
26
+ # The frontmatter must be parseable by a real YAML parser — the per-platform
27
+ # compiler (compile_skills.py) uses yaml.safe_load and silently falls back to
28
+ # a default block when parsing fails, which would drop the skill's real
29
+ # description/triggers from the emitted output. Catch that here.
30
+ try:
31
+ import yaml
32
+
33
+ parsed = yaml.safe_load(yaml_block)
34
+ if not isinstance(parsed, dict):
35
+ return False, "Frontmatter is not a YAML mapping"
36
+ keys = {str(k): v for k, v in parsed.items()}
37
+ except ImportError:
38
+ # PyYAML unavailable (bootstrapping): fall back to a line parser.
39
+ keys = {}
40
+ for line in yaml_block.strip().split("\n"):
41
+ if ":" in line:
42
+ k, v = line.split(":", 1)
43
+ keys[k.strip()] = v.strip()
44
+ except Exception as e: # noqa: BLE001 - surface the YAML error to the user
45
+ return False, f"Frontmatter is not valid YAML ({str(e).splitlines()[0]})"
46
+
47
+ required = ["name", "description"]
48
+ missing = [k for k in required if k not in keys]
49
+
50
+ if missing:
51
+ return False, f"Missing required keys: {missing}"
52
+
53
+ return True, "OK"
54
+
55
+
56
+ def main():
57
+ print(f"Validating skills in {SKILLS_DIR}...")
58
+ errors = 0
59
+ checked = 0
60
+
61
+ for skill_file in SKILLS_DIR.rglob("*.skill.md"):
62
+ checked += 1
63
+ is_valid, msg = validate_frontmatter(skill_file)
64
+
65
+ if not is_valid:
66
+ print(f"{RED}[FAIL] {skill_file.name}: {msg}{NC}")
67
+ errors += 1
68
+ # else:
69
+ # print(f"{GREEN}[OK] {skill_file.name}{NC}")
70
+
71
+ print("-" * 40)
72
+ if errors > 0:
73
+ print(f"{RED}Found {errors} errors in {checked} skills.{NC}")
74
+ sys.exit(1)
75
+ else:
76
+ print(f"{GREEN}All {checked} skills passed validation!{NC}")
77
+ sys.exit(0)
78
+
79
+
80
+ if __name__ == "__main__":
81
+ main()