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
package/bin/install.js ADDED
@@ -0,0 +1,572 @@
1
+ #!/usr/bin/env node
2
+ // SPDX-License-Identifier: Apache-2.0
3
+ //
4
+ // GABBE installer (Python-independent).
5
+ //
6
+ // This is the PRIMARY installer for `npx gabbe-kit init`. It bundles the Markdown
7
+ // kit (agents/, docs/) and wires it into the current project using only the
8
+ // Node standard library -- no npm dependencies, no Python required.
9
+ //
10
+ // Conventions mirror scripts/init.py and agents/scripts/compile_skills.py:
11
+ // - safe_slug() -> compile_skills.py safe_slug()
12
+ // - .agents/skills/<slug>/SKILL.md (agentskills.io "Universal" target)
13
+ // - root AGENTS.md -> agents.md open standard
14
+ // - per-agent rule files -> .claude/CLAUDE.md, .cursorrules, etc.
15
+ //
16
+ // If `python3` is available the full interactive wizard (scripts/init.py) can
17
+ // be delegated to with `--wizard`, but the Node path works WITHOUT Python.
18
+
19
+ 'use strict';
20
+
21
+ const fs = require('fs');
22
+ const path = require('path');
23
+ const os = require('os');
24
+ const { spawnSync } = require('child_process');
25
+
26
+ // ---------------------------------------------------------------------------
27
+ // Paths / colors
28
+ // ---------------------------------------------------------------------------
29
+
30
+ // The bundled kit lives one level up from bin/ (the package root).
31
+ const KIT_ROOT = path.resolve(__dirname, '..');
32
+ const SOURCE_AGENTS_DIR = path.join(KIT_ROOT, 'agents');
33
+ const SOURCE_DOCS_DIR = path.join(KIT_ROOT, 'docs');
34
+ const PROJECT_ROOT = process.cwd();
35
+
36
+ const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
37
+ const c = (code, s) => (useColor ? `[${code}m${s}` : s);
38
+ const green = (s) => c('0;32', s);
39
+ const yellow = (s) => c('1;33', s);
40
+ const blue = (s) => c('0;34', s);
41
+ const red = (s) => c('0;31', s);
42
+
43
+ function log(msg) {
44
+ process.stdout.write(msg + '\n');
45
+ }
46
+
47
+ // ---------------------------------------------------------------------------
48
+ // Agent registry: canonical name -> CLI alias(es) accepted in --agents
49
+ // ---------------------------------------------------------------------------
50
+
51
+ const AGENT_ALIASES = {
52
+ claude: 'Claude Code',
53
+ 'claude-code': 'Claude Code',
54
+ cursor: 'Cursor',
55
+ windsurf: 'Windsurf',
56
+ cline: 'Cline',
57
+ aider: 'Aider',
58
+ devin: 'Devin / Cognition',
59
+ cognition: 'Devin / Cognition',
60
+ gemini: 'Gemini',
61
+ antigravity: 'Antigravity',
62
+ opencode: 'OpenCode',
63
+ zed: 'Zed',
64
+ continue: 'Continue',
65
+ roo: 'Roo Code',
66
+ 'roo-code': 'Roo Code',
67
+ kilo: 'Kilo Code',
68
+ 'kilo-code': 'Kilo Code',
69
+ codex: 'OpenAI / Codex',
70
+ openai: 'OpenAI / Codex',
71
+ copilot: 'GitHub Copilot',
72
+ 'github-copilot': 'GitHub Copilot',
73
+ vscode: 'VS Code',
74
+ 'vs-code': 'VS Code',
75
+ };
76
+
77
+ // ---------------------------------------------------------------------------
78
+ // Helpers
79
+ // ---------------------------------------------------------------------------
80
+
81
+ // Mirror of compile_skills.py safe_slug(): lowercase, collapse non [a-z0-9]
82
+ // runs into single hyphens, strip leading/trailing hyphens, prevent traversal.
83
+ function safeSlug(rawName, fallback) {
84
+ let slug = (rawName || '').toLowerCase().trim();
85
+ slug = slug.replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
86
+ if (!slug || slug === '.' || slug === '..') {
87
+ const fb = String(fallback || 'skill')
88
+ .toLowerCase()
89
+ .replace(/[^a-z0-9]+/g, '-')
90
+ .replace(/^-+|-+$/g, '');
91
+ slug = fb || 'skill';
92
+ }
93
+ return slug;
94
+ }
95
+
96
+ // Minimal YAML frontmatter reader: returns { name, description } parsed from a
97
+ // leading `---` block. Enough for slug + description; we never re-serialize.
98
+ function parseFrontmatter(content) {
99
+ const meta = {};
100
+ if (!content.startsWith('---')) return meta;
101
+ const end = content.indexOf('---', 3);
102
+ if (end === -1) return meta;
103
+ const block = content.slice(3, end);
104
+ for (const line of block.split('\n')) {
105
+ const idx = line.indexOf(':');
106
+ if (idx === -1) continue;
107
+ const key = line.slice(0, idx).trim();
108
+ let val = line.slice(idx + 1).trim();
109
+ // Strip a single pair of surrounding quotes.
110
+ if (
111
+ (val.startsWith('"') && val.endsWith('"')) ||
112
+ (val.startsWith("'") && val.endsWith("'"))
113
+ ) {
114
+ val = val.slice(1, -1);
115
+ }
116
+ if (key) meta[key] = val;
117
+ }
118
+ return meta;
119
+ }
120
+
121
+ // Idempotent: inject `gabbe-schema-version: 1` into a leading frontmatter block
122
+ // (matches compile_skills.py inject_schema_version()).
123
+ const GABBE_SCHEMA_VERSION = 1;
124
+ function injectSchemaVersion(content) {
125
+ if (content.includes('gabbe-schema-version:')) return content;
126
+ if (content.startsWith('---')) {
127
+ const end = content.indexOf('---', 3);
128
+ if (end !== -1) {
129
+ const head = content.slice(0, 3);
130
+ const block = content.slice(3, end).replace(/\n+$/, '');
131
+ const tail = content.slice(end);
132
+ return head + block + `\ngabbe-schema-version: ${GABBE_SCHEMA_VERSION}\n` + tail;
133
+ }
134
+ }
135
+ return content;
136
+ }
137
+
138
+ function walk(dir) {
139
+ const out = [];
140
+ let entries;
141
+ try {
142
+ entries = fs.readdirSync(dir, { withFileTypes: true });
143
+ } catch (e) {
144
+ return out;
145
+ }
146
+ for (const entry of entries) {
147
+ const full = path.join(dir, entry.name);
148
+ if (entry.isDirectory()) {
149
+ out.push(...walk(full));
150
+ } else if (entry.isFile()) {
151
+ out.push(full);
152
+ }
153
+ }
154
+ return out;
155
+ }
156
+
157
+ // PRESERVE_FILES mirrors init.py: never clobber user-authored content.
158
+ const PRESERVE_FILES = new Set([
159
+ 'AGENTS.md',
160
+ 'CONSTITUTION.md',
161
+ 'TASKS.md',
162
+ 'policies.yml',
163
+ 'config.json',
164
+ ]);
165
+
166
+ function shouldPreserve(relPath, fileName) {
167
+ const parts = relPath.split(path.sep);
168
+ if (parts.includes('memory')) return true;
169
+ if (parts.includes('project')) return true;
170
+ if (PRESERVE_FILES.has(fileName)) return true;
171
+ if (fileName.startsWith('PROJECT') && fileName.endsWith('.md')) return true;
172
+ return false;
173
+ }
174
+
175
+ // Copy a directory tree without overwriting preserved user files.
176
+ function safeCopyTree(srcRoot, dstRoot) {
177
+ if (!fs.existsSync(srcRoot)) return 0;
178
+ let copied = 0;
179
+ for (const src of walk(srcRoot)) {
180
+ const rel = path.relative(srcRoot, src);
181
+ const dst = path.join(dstRoot, rel);
182
+ const fileName = path.basename(src);
183
+ if (fs.existsSync(dst) && shouldPreserve(rel, fileName)) {
184
+ continue;
185
+ }
186
+ fs.mkdirSync(path.dirname(dst), { recursive: true });
187
+ fs.copyFileSync(src, dst);
188
+ copied += 1;
189
+ }
190
+ return copied;
191
+ }
192
+
193
+ // Wire a rule file pointing at the kit's AGENTS.md. Prefer a relative symlink
194
+ // (like init.py); fall back to a copy on platforms/filesystems that refuse
195
+ // symlinks (e.g. Windows without privileges). Backs up existing non-symlink.
196
+ function wireAgentsLink(target, sourceAgentsMd) {
197
+ fs.mkdirSync(path.dirname(target), { recursive: true });
198
+ try {
199
+ const st = fs.lstatSync(target);
200
+ if (st.isSymbolicLink()) {
201
+ fs.unlinkSync(target);
202
+ } else {
203
+ const backup = target + '.bak';
204
+ fs.renameSync(target, backup);
205
+ log(` ${yellow('!')} Backed up existing ${path.basename(target)} -> ${path.basename(backup)}`);
206
+ }
207
+ } catch (e) {
208
+ /* target does not exist */
209
+ }
210
+ const linkPath = path.relative(path.dirname(target), sourceAgentsMd);
211
+ try {
212
+ fs.symlinkSync(linkPath, target);
213
+ log(` ${green('✓')} Linked ${path.relative(PROJECT_ROOT, target)} -> ${linkPath}`);
214
+ } catch (e) {
215
+ fs.copyFileSync(sourceAgentsMd, target);
216
+ log(` ${green('✓')} Copied ${path.relative(PROJECT_ROOT, target)} (symlink fallback)`);
217
+ }
218
+ }
219
+
220
+ // Emit the universal .agents/skills/<slug>/SKILL.md tree (agentskills.io).
221
+ // Reads every agents/skills/**/*.skill.md and writes a real SKILL.md file.
222
+ function emitUniversalSkills(skillsSrcDir, targetSkillsDir) {
223
+ fs.mkdirSync(targetSkillsDir, { recursive: true });
224
+ let count = 0;
225
+ for (const skillFile of walk(skillsSrcDir)) {
226
+ if (!skillFile.endsWith('.skill.md')) continue;
227
+ const content = fs.readFileSync(skillFile, 'utf8');
228
+ const meta = parseFrontmatter(content);
229
+ const fallback = path.basename(skillFile).replace(/\.skill\.md$/, '');
230
+ const slug = safeSlug(meta.name, fallback);
231
+ const folder = path.join(targetSkillsDir, slug);
232
+ fs.mkdirSync(folder, { recursive: true });
233
+ fs.writeFileSync(path.join(folder, 'SKILL.md'), injectSchemaVersion(content));
234
+ count += 1;
235
+ }
236
+ return count;
237
+ }
238
+
239
+ // Emit Cursor flat .mdc rules (.cursor/rules/<slug>.mdc) -- mirrors the Cursor
240
+ // branch of compile_skills.py.
241
+ function emitCursorRules(skillsSrcDir, cursorRulesDir) {
242
+ fs.mkdirSync(cursorRulesDir, { recursive: true });
243
+ let count = 0;
244
+ for (const skillFile of walk(skillsSrcDir)) {
245
+ if (!skillFile.endsWith('.skill.md')) continue;
246
+ const content = fs.readFileSync(skillFile, 'utf8');
247
+ const meta = parseFrontmatter(content);
248
+ const fallback = path.basename(skillFile).replace(/\.skill\.md$/, '');
249
+ const slug = safeSlug(meta.name, fallback);
250
+ const desc = meta.description || `Skill for ${meta.name || slug}`;
251
+ let body = content;
252
+ if (content.startsWith('---')) {
253
+ const end = content.indexOf('---', 3);
254
+ if (end !== -1) body = content.slice(end + 3).replace(/^\s+/, '');
255
+ }
256
+ const cursorFm =
257
+ '---\n' +
258
+ `description: ${desc}\n` +
259
+ 'alwaysApply: false\n' +
260
+ `gabbe-schema-version: ${GABBE_SCHEMA_VERSION}\n` +
261
+ '---\n';
262
+ fs.writeFileSync(path.join(cursorRulesDir, `${slug}.mdc`), cursorFm + '\n' + body);
263
+ count += 1;
264
+ }
265
+ return count;
266
+ }
267
+
268
+ function writeJsonIfAbsent(filePath, obj) {
269
+ if (fs.existsSync(filePath)) return false;
270
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
271
+ fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\n');
272
+ return true;
273
+ }
274
+
275
+ // ---------------------------------------------------------------------------
276
+ // Per-agent wiring (mirrors scripts/init.py Step 5 conventions)
277
+ // ---------------------------------------------------------------------------
278
+
279
+ function wireAgent(agent, ctx) {
280
+ const { skillsSrc, agentsMdSrc } = ctx;
281
+ switch (agent) {
282
+ case 'Claude Code':
283
+ wireAgentsLink(path.join(PROJECT_ROOT, '.claude', 'CLAUDE.md'), agentsMdSrc);
284
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.claude', 'skills'));
285
+ log(` ${green('✓')} Wired Claude Code (.claude/CLAUDE.md + .claude/skills)`);
286
+ break;
287
+ case 'Cursor':
288
+ wireAgentsLink(path.join(PROJECT_ROOT, '.cursorrules'), agentsMdSrc);
289
+ emitCursorRules(skillsSrc, path.join(PROJECT_ROOT, '.cursor', 'rules'));
290
+ log(` ${green('✓')} Wired Cursor (.cursorrules + .cursor/rules)`);
291
+ break;
292
+ case 'Windsurf':
293
+ wireAgentsLink(path.join(PROJECT_ROOT, '.windsurfrules'), agentsMdSrc);
294
+ wireAgentsLink(path.join(PROJECT_ROOT, '.windsurf', 'skills', 'AGENTS.md'), agentsMdSrc);
295
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.windsurf', 'skills'));
296
+ log(` ${green('✓')} Wired Windsurf (.windsurfrules + .windsurf/skills)`);
297
+ break;
298
+ case 'Cline':
299
+ wireAgentsLink(path.join(PROJECT_ROOT, '.clinerules'), agentsMdSrc);
300
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.cline', 'skills'));
301
+ log(` ${green('✓')} Wired Cline (.clinerules + .cline/skills)`);
302
+ break;
303
+ case 'Devin / Cognition':
304
+ wireAgentsLink(path.join(PROJECT_ROOT, '.devinrules'), agentsMdSrc);
305
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.devin', 'skills'));
306
+ log(` ${green('✓')} Wired Devin (.devinrules + .devin/skills)`);
307
+ break;
308
+ case 'Aider': {
309
+ const aiderConf = path.join(PROJECT_ROOT, '.aider.conf.yml');
310
+ if (!fs.existsSync(aiderConf)) {
311
+ fs.writeFileSync(aiderConf, 'read:\n - agents/AGENTS.md\n - agents/skills/\n');
312
+ log(` ${green('✓')} Wired .aider.conf.yml`);
313
+ } else {
314
+ log(` ${blue('→')} .aider.conf.yml exists, leaving as-is`);
315
+ }
316
+ break;
317
+ }
318
+ case 'Gemini': {
319
+ const geminiDir = path.join(PROJECT_ROOT, '.gemini');
320
+ fs.mkdirSync(geminiDir, { recursive: true });
321
+ const relAgents = path.relative(PROJECT_ROOT, agentsMdSrc);
322
+ const relSkills = path.relative(PROJECT_ROOT, skillsSrc);
323
+ writeJsonIfAbsent(path.join(geminiDir, 'settings.json'), {
324
+ agent_instructions_file: relAgents,
325
+ skills_directory: relSkills,
326
+ contextFileName: 'GEMINI.md',
327
+ 'gabbe-schema-version': GABBE_SCHEMA_VERSION,
328
+ notes: 'Managed by gabbe (Node installer)',
329
+ });
330
+ wireAgentsLink(path.join(PROJECT_ROOT, 'GEMINI.md'), agentsMdSrc);
331
+ log(` ${green('✓')} Wired .gemini/settings.json + GEMINI.md`);
332
+ break;
333
+ }
334
+ case 'Antigravity':
335
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.agents', 'skills'));
336
+ log(` ${green('✓')} Wired Antigravity (.agents/skills + root AGENTS.md)`);
337
+ break;
338
+ case 'OpenCode': {
339
+ const opencodeConf = path.join(PROJECT_ROOT, 'opencode.json');
340
+ writeJsonIfAbsent(opencodeConf, {
341
+ $schema: 'https://opencode.ai/config.json',
342
+ instructions: ['AGENTS.md', 'agents/skills/'],
343
+ });
344
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.agents', 'skills'));
345
+ log(` ${green('✓')} Wired opencode.json + .agents/skills`);
346
+ break;
347
+ }
348
+ case 'Zed':
349
+ wireAgentsLink(path.join(PROJECT_ROOT, '.rules'), agentsMdSrc);
350
+ log(` ${green('✓')} Wired Zed (.rules)`);
351
+ break;
352
+ case 'Continue':
353
+ wireAgentsLink(path.join(PROJECT_ROOT, '.continue', 'rules', 'agents.md'), agentsMdSrc);
354
+ log(` ${green('✓')} Wired Continue (.continue/rules/agents.md)`);
355
+ break;
356
+ case 'Roo Code':
357
+ wireAgentsLink(path.join(PROJECT_ROOT, '.roo', 'rules', 'agents.md'), agentsMdSrc);
358
+ log(` ${green('✓')} Wired Roo Code (.roo/rules/agents.md)`);
359
+ break;
360
+ case 'Kilo Code':
361
+ wireAgentsLink(path.join(PROJECT_ROOT, '.kilocode', 'rules', 'agents.md'), agentsMdSrc);
362
+ log(` ${green('✓')} Wired Kilo Code (.kilocode/rules/agents.md)`);
363
+ break;
364
+ case 'OpenAI / Codex':
365
+ wireAgentsLink(path.join(PROJECT_ROOT, '.codex', 'AGENTS.md'), agentsMdSrc);
366
+ log(` ${green('✓')} Wired Codex (.codex/AGENTS.md)`);
367
+ break;
368
+ case 'GitHub Copilot':
369
+ wireAgentsLink(path.join(PROJECT_ROOT, '.github', 'copilot-instructions.md'), agentsMdSrc);
370
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.github', 'skills'));
371
+ log(` ${green('✓')} Wired GitHub Copilot (.github/copilot-instructions.md + .github/skills)`);
372
+ break;
373
+ case 'VS Code':
374
+ emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.github', 'skills'));
375
+ log(` ${green('✓')} Wired VS Code (.github/skills)`);
376
+ break;
377
+ default:
378
+ log(` ${yellow('!')} Unknown agent "${agent}", skipped`);
379
+ }
380
+ }
381
+
382
+ // ---------------------------------------------------------------------------
383
+ // CLI
384
+ // ---------------------------------------------------------------------------
385
+
386
+ const USAGE = `gabbe - Generative Architectural Brain Base Engine (kit installer)
387
+
388
+ Usage:
389
+ gabbe init [options] Install the GABBE kit into the current directory
390
+ gabbe --help Show this help
391
+
392
+ Options:
393
+ --agents <list> Comma-separated agents to wire, e.g. claude,cursor,copilot.
394
+ Known: claude, cursor, windsurf, cline, aider, devin,
395
+ gemini, antigravity, opencode, zed, continue, roo, kilo,
396
+ codex, copilot, vscode.
397
+ --yes, -y Non-interactive: accept defaults, do not prompt.
398
+ --wizard Delegate to the full Python wizard (scripts/init.py) if
399
+ python3 is available (interactive, richer configuration).
400
+ --help, -h Show this help.
401
+
402
+ What it does (Node path, no Python required):
403
+ - Copies the bundled kit (agents/, docs/) into the current project.
404
+ - Writes a root AGENTS.md (agents.md open standard).
405
+ - Emits the universal .agents/skills/<slug>/SKILL.md tree.
406
+ - Wires per-agent rule files for any agents passed via --agents.
407
+
408
+ Examples:
409
+ npx gabbe-kit init --agents claude,cursor --yes
410
+ npx gabbe-kit init --wizard
411
+ `;
412
+
413
+ function parseArgs(argv) {
414
+ const opts = { command: null, agents: [], yes: false, wizard: false, help: false };
415
+ for (let i = 0; i < argv.length; i++) {
416
+ const a = argv[i];
417
+ if (a === 'init') {
418
+ opts.command = 'init';
419
+ } else if (a === '--help' || a === '-h') {
420
+ opts.help = true;
421
+ } else if (a === '--yes' || a === '-y') {
422
+ opts.yes = true;
423
+ } else if (a === '--wizard') {
424
+ opts.wizard = true;
425
+ } else if (a === '--agents') {
426
+ opts.agents = (argv[++i] || '').split(',');
427
+ } else if (a.startsWith('--agents=')) {
428
+ opts.agents = a.slice('--agents='.length).split(',');
429
+ } else if (a.startsWith('-')) {
430
+ log(red(`Unknown option: ${a}`));
431
+ opts.help = true;
432
+ }
433
+ }
434
+ return opts;
435
+ }
436
+
437
+ function resolveAgents(rawList) {
438
+ const resolved = [];
439
+ const seen = new Set();
440
+ for (const raw of rawList) {
441
+ const key = String(raw || '').trim().toLowerCase();
442
+ if (!key) continue;
443
+ const canonical = AGENT_ALIASES[key];
444
+ if (!canonical) {
445
+ log(` ${yellow('!')} Unknown agent "${raw}" -- skipping`);
446
+ continue;
447
+ }
448
+ if (!seen.has(canonical)) {
449
+ seen.add(canonical);
450
+ resolved.push(canonical);
451
+ }
452
+ }
453
+ return resolved;
454
+ }
455
+
456
+ function delegateToPython() {
457
+ const initPy = path.join(KIT_ROOT, 'scripts', 'init.py');
458
+ if (!fs.existsSync(initPy)) {
459
+ log(red(`Cannot find scripts/init.py at ${initPy}`));
460
+ return 1;
461
+ }
462
+ for (const py of ['python3', 'python']) {
463
+ const probe = spawnSync(py, ['--version'], { stdio: 'ignore' });
464
+ if (probe.status === 0) {
465
+ log(blue(`→ Delegating to the Python wizard (${py} ${initPy})...`));
466
+ const res = spawnSync(py, [initPy], { stdio: 'inherit' });
467
+ return res.status == null ? 1 : res.status;
468
+ }
469
+ }
470
+ log(red('--wizard requested but python3/python is not available on PATH.'));
471
+ log(yellow('Re-run without --wizard to use the pure-Node installer.'));
472
+ return 1;
473
+ }
474
+
475
+ function runInit(opts) {
476
+ if (opts.wizard) {
477
+ return delegateToPython();
478
+ }
479
+
480
+ if (!fs.existsSync(SOURCE_AGENTS_DIR)) {
481
+ log(red(`Error: bundled kit not found at ${SOURCE_AGENTS_DIR}`));
482
+ log(yellow('The gabbe package appears to be incomplete (missing agents/).'));
483
+ return 1;
484
+ }
485
+
486
+ log(blue('='.repeat(60)));
487
+ log(blue('GABBE - Agentic Engineering Kit installer (Node)'));
488
+ log(blue('='.repeat(60)));
489
+ log(`Source kit : ${KIT_ROOT}`);
490
+ log(`Target : ${PROJECT_ROOT}`);
491
+ log('');
492
+
493
+ // --- Copy the kit into the project (agents/ + docs/) ---
494
+ log(yellow('Part 1: Copying kit'));
495
+ const targetAgents = path.join(PROJECT_ROOT, 'agents');
496
+ if (path.resolve(targetAgents) === path.resolve(SOURCE_AGENTS_DIR)) {
497
+ log(` ${blue('→')} Target agents/ is the source; skipping copy.`);
498
+ } else {
499
+ const n = safeCopyTree(SOURCE_AGENTS_DIR, targetAgents);
500
+ log(` ${green('✓')} Copied agents/ (${n} files, user content preserved)`);
501
+ }
502
+ if (fs.existsSync(SOURCE_DOCS_DIR)) {
503
+ const targetDocs = path.join(PROJECT_ROOT, 'docs');
504
+ if (path.resolve(targetDocs) !== path.resolve(SOURCE_DOCS_DIR)) {
505
+ const n = safeCopyTree(SOURCE_DOCS_DIR, targetDocs);
506
+ log(` ${green('✓')} Copied docs/ (${n} files)`);
507
+ }
508
+ }
509
+
510
+ const agentsMdSrc = path.join(targetAgents, 'AGENTS.md');
511
+ const skillsSrc = path.join(targetAgents, 'skills');
512
+
513
+ // --- Universal targets (always emitted) ---
514
+ log('');
515
+ log(yellow('Part 2: Universal wiring'));
516
+
517
+ // Root AGENTS.md (agents.md open standard).
518
+ const rootAgentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
519
+ if (fs.existsSync(agentsMdSrc)) {
520
+ if (path.resolve(rootAgentsMd) !== path.resolve(agentsMdSrc)) {
521
+ wireAgentsLink(rootAgentsMd, agentsMdSrc);
522
+ log(` ${green('✓')} Wired root AGENTS.md (agents.md standard)`);
523
+ }
524
+ } else {
525
+ log(` ${yellow('!')} agents/AGENTS.md not found; root AGENTS.md not wired.`);
526
+ }
527
+
528
+ // Universal .agents/skills/<slug>/SKILL.md tree.
529
+ if (fs.existsSync(skillsSrc)) {
530
+ const n = emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.agents', 'skills'));
531
+ log(` ${green('✓')} Emitted ${n} universal skills (.agents/skills/<slug>/SKILL.md)`);
532
+ } else {
533
+ log(` ${yellow('!')} agents/skills not found; universal skills not emitted.`);
534
+ }
535
+
536
+ // --- Per-agent wiring ---
537
+ const agents = resolveAgents(opts.agents);
538
+ if (agents.length) {
539
+ log('');
540
+ log(yellow('Part 3: Per-agent wiring'));
541
+ const ctx = { skillsSrc, agentsMdSrc };
542
+ for (const agent of agents) {
543
+ wireAgent(agent, ctx);
544
+ }
545
+ } else {
546
+ log('');
547
+ log(` ${blue('→')} No --agents specified; only universal targets wired.`);
548
+ log(` ${blue('→')} Re-run with e.g. --agents claude,cursor to wire tools.`);
549
+ }
550
+
551
+ log('');
552
+ log(green('Setup complete.'));
553
+ log(`The kit is installed at: ${targetAgents}`);
554
+ return 0;
555
+ }
556
+
557
+ function main() {
558
+ const opts = parseArgs(process.argv.slice(2));
559
+ if (opts.help) {
560
+ process.stdout.write(USAGE);
561
+ return 0;
562
+ }
563
+ // `init` is the default command.
564
+ if (opts.command === null) opts.command = 'init';
565
+ if (opts.command === 'init') {
566
+ return runInit(opts);
567
+ }
568
+ process.stdout.write(USAGE);
569
+ return 0;
570
+ }
571
+
572
+ process.exit(main());