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,120 @@
1
+ # SPDX-License-Identifier: Apache-2.0
2
+ import os
3
+ import re
4
+ from pathlib import Path
5
+
6
+
7
+ def main():
8
+ root_dir = Path(__file__).parent.parent.parent
9
+ skills_dir = root_dir / "agents" / "skills"
10
+
11
+ # Exclude these directories from search
12
+ exclude_dirs = {".git", ".venv", "node_modules", "__pycache__", "gabbe"}
13
+
14
+ # 1. Discover all existing skills
15
+ existing_skills = set()
16
+ if skills_dir.exists():
17
+ for root, dirs, files in os.walk(skills_dir):
18
+ for file in files:
19
+ if file.endswith(".skill.md"):
20
+ existing_skills.add(file.replace(".skill.md", ""))
21
+
22
+ print(f"Found {len(existing_skills)} actual skills in {skills_dir}")
23
+
24
+ # 2. Search for skill mentions in all markdown files
25
+ mentioned_skills = set()
26
+ skill_mentions_map = {} # skill -> set of files
27
+
28
+ # regex matches: "some-skill.skill" or "some-skill.skill.md" or "`some-skill`" in specific contexts
29
+ # Let's extract anything that ends in .skill or .skill.md
30
+ skill_pattern1 = re.compile(r"([\w-]+)\.skill(?!\.md)")
31
+ skill_pattern2 = re.compile(r"([\w-]+)\.skill\.md")
32
+
33
+ # In table cells, sometimes they are just backticked: `spec-writer`
34
+ # We will try to match those as well by looking for anything in backticks in the READMEs that matches existing skills,
35
+ # or just collect all backticked words and see if they look like a skill.
36
+ backtick_pattern = re.compile(r"`([\w-]+)`")
37
+
38
+ for root, dirs, files in os.walk(root_dir):
39
+ # Filter exclusions
40
+ dirs[:] = [d for d in dirs if d not in exclude_dirs and not d.startswith(".")]
41
+
42
+ for file in files:
43
+ if not file.endswith(".md"):
44
+ continue
45
+
46
+ filepath = Path(root) / file
47
+
48
+ try:
49
+ with open(filepath, "r", encoding="utf-8") as f:
50
+ content = f.read()
51
+
52
+ matches1 = skill_pattern1.findall(content)
53
+ matches2 = skill_pattern2.findall(content)
54
+ bmatches = backtick_pattern.findall(content)
55
+
56
+ # We count a backticked word as a skill mention if it's already a known skill or ends with -skill etc. Let's just collect all and filter later.
57
+ all_possible = set(matches1 + matches2)
58
+ for bm in bmatches:
59
+ if bm in existing_skills:
60
+ all_possible.add(bm)
61
+
62
+ for skill in all_possible:
63
+ mentioned_skills.add(skill)
64
+ if skill not in skill_mentions_map:
65
+ skill_mentions_map[skill] = set()
66
+ skill_mentions_map[skill].add(str(filepath.relative_to(root_dir)))
67
+
68
+ except Exception as e:
69
+ print(f"Error reading {filepath}: {e}")
70
+
71
+ # 3. Analyze discrepancy
72
+ missing_skills = mentioned_skills - existing_skills
73
+ unmentioned_skills = existing_skills - mentioned_skills
74
+
75
+ print("\n--- Summary ---")
76
+ print(f"Total mentioned skills: {len(mentioned_skills)}")
77
+ print(f"Total existing skills: {len(existing_skills)}")
78
+
79
+ print("\n[⚠️] Mentioned in docs but missing from agents/skills/:")
80
+ if missing_skills:
81
+ for ms in sorted(missing_skills):
82
+ files_mentioned = ", ".join(skill_mentions_map[ms])
83
+ print(f" - {ms} (Found in: {files_mentioned})")
84
+ else:
85
+ print(" None. All mentioned skills exist.")
86
+
87
+ print("\n[ℹ️] Existing skills NOT mentioned in any parsed docs:")
88
+ # We can refine this to check if they are missing from specific files like QUICK_GUIDE.md or README_FULL.md
89
+ if unmentioned_skills:
90
+ for us in sorted(unmentioned_skills):
91
+ print(f" - {us}")
92
+ else:
93
+ print(" None. All existing skills are mentioned somewhere.")
94
+
95
+ # Specifically check docs/QUICK_GUIDE.md and docs/README_FULL.md
96
+ critical_docs = [
97
+ "docs/QUICK_GUIDE.md",
98
+ "docs/README_FULL.md",
99
+ "README.md",
100
+ "agents/skills/00-index.md",
101
+ ]
102
+
103
+ for doc in critical_docs:
104
+ doc_path = root_dir / doc
105
+ if doc_path.exists():
106
+ with open(doc_path, "r", encoding="utf-8") as f:
107
+ content = f.read()
108
+ # Find all skill mentions in this doc
109
+ doc_m1 = skill_pattern1.findall(content)
110
+ doc_m2 = skill_pattern2.findall(content)
111
+ doc_bm = [b for b in backtick_pattern.findall(content) if b in existing_skills]
112
+ doc_skills = set(doc_m1 + doc_m2 + doc_bm)
113
+
114
+ print(
115
+ f"\n[📊] {doc} covers {len(doc_skills)} out of {len(existing_skills)} skills."
116
+ )
117
+
118
+
119
+ if __name__ == "__main__":
120
+ main()
@@ -0,0 +1,284 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ import argparse
4
+ import json
5
+ import os
6
+ import re
7
+ import shutil
8
+ import sys
9
+ from pathlib import Path
10
+
11
+ # Colors
12
+ GREEN = "\033[0;32m"
13
+ YELLOW = "\033[1;33m"
14
+ BLUE = "\033[0;34m"
15
+ RED = "\033[0;31m"
16
+ NC = "\033[0m"
17
+
18
+ # Schema generation embedded into every emitted artifact so downstream tooling
19
+ # can detect the emitted-format version. Consumers that ignore it are unaffected.
20
+ GABBE_SCHEMA_VERSION = 1
21
+
22
+
23
+ def safe_slug(raw_name, fallback="skill"):
24
+ """Sanitize a skill name into a filesystem-safe slug.
25
+
26
+ Prevents path traversal: the slug can never contain a path separator, '..',
27
+ NUL, or escape its target directory. Falls back to `fallback` when the name
28
+ sanitizes to empty.
29
+ """
30
+ slug = (raw_name or "").lower().strip()
31
+ # Collapse any run of non [a-z0-9] into a single hyphen.
32
+ slug = re.sub(r"[^a-z0-9]+", "-", slug)
33
+ slug = slug.strip("-")
34
+ if not slug or slug in (".", ".."):
35
+ slug = re.sub(r"[^a-z0-9]+", "-", str(fallback).lower()).strip("-") or "skill"
36
+ return slug
37
+
38
+
39
+ def inject_schema_version(content):
40
+ """Insert `gabbe-schema-version: <N>` into a leading YAML frontmatter block.
41
+
42
+ Idempotent: if the key is already present the content is returned unchanged.
43
+ If there is no frontmatter, the content is returned unchanged.
44
+ """
45
+ if "gabbe-schema-version:" in content:
46
+ return content
47
+ if content.startswith("---"):
48
+ end = content.find("---", 3)
49
+ if end != -1:
50
+ head = content[:3]
51
+ block = content[3:end]
52
+ tail = content[end:]
53
+ return (
54
+ head
55
+ + block.rstrip("\n")
56
+ + f"\ngabbe-schema-version: {GABBE_SCHEMA_VERSION}\n"
57
+ + tail
58
+ )
59
+ return content
60
+
61
+
62
+ def ensure_yaml_frontmatter(content, filename):
63
+ """Ensures content has valid YAML frontmatter using PyYAML. Returns (frontmatter_dict, content)."""
64
+ try:
65
+ import yaml
66
+
67
+ if content.startswith("---"):
68
+ end_yaml = content.find("---", 3)
69
+ if end_yaml != -1:
70
+ yaml_text = content[3:end_yaml]
71
+ data = yaml.safe_load(yaml_text)
72
+ if isinstance(data, dict):
73
+ return data, content
74
+ except ImportError:
75
+ # Fallback to simple parser if PyYAML is missing
76
+ if content.startswith("---"):
77
+ end_yaml = content.find("---", 3)
78
+ if end_yaml != -1:
79
+ yaml_text = content[3:end_yaml]
80
+ data = {}
81
+ for line in yaml_text.strip().split("\n"):
82
+ if ":" in line:
83
+ k, v = line.split(":", 1)
84
+ data[k.strip()] = v.strip().strip("\"'")
85
+ return data, content
86
+ except Exception:
87
+ # print(f"Warning: Failed to parse YAML for {filename}: {e}")
88
+ pass
89
+
90
+ # Default frontmatter if missing or failed
91
+ name = filename.replace(".skill.md", "").replace(".md", "").replace(".mdc", "")
92
+ frontmatter = f"""---
93
+ name: {name}
94
+ description: AI Skill for {name}
95
+ version: 1.0
96
+ author: GABBE-Kit
97
+ ---
98
+ """
99
+ return {"name": name}, frontmatter + content
100
+
101
+
102
+ def create_symlink(source, target, project_root):
103
+ """Creates a symlink from target to source, backing up if exists."""
104
+ if target.is_symlink():
105
+ target.unlink()
106
+ elif target.exists():
107
+ # Append ".bak" to the FULL name (with_suffix would drop a real
108
+ # extension, e.g. config.json -> config.bak).
109
+ backup = target.parent / (target.name + ".bak")
110
+ if target.is_dir():
111
+ print(f" {YELLOW}! Backing up existing directory {target.name} to {backup.name}{NC}")
112
+ shutil.move(str(target), str(backup))
113
+ else:
114
+ print(f" {YELLOW}! Backing up existing file {target.name} to {backup.name}{NC}")
115
+ target.rename(backup)
116
+
117
+ # Ensure parent dir exists
118
+ target.parent.mkdir(parents=True, exist_ok=True)
119
+
120
+ # Calculate relative path if possible, else absolute
121
+ try:
122
+ if str(project_root) in str(source.absolute()):
123
+ link_path = os.path.relpath(source, target.parent)
124
+ else:
125
+ link_path = source.absolute()
126
+
127
+ os.symlink(link_path, target)
128
+ # print(f" {GREEN}✓ Linked {target.name} -> {link_path}{NC}")
129
+ except OSError as e:
130
+ # Fallback for Windows (no admin rights) or restricted environments
131
+ print(f" {YELLOW}! Symlink failed ({e}), falling back to copy...{NC}")
132
+ try:
133
+ if source.is_dir():
134
+ if target.exists():
135
+ shutil.rmtree(target)
136
+ shutil.copytree(source, target)
137
+ else:
138
+ if target.exists():
139
+ target.unlink()
140
+ shutil.copy2(source, target)
141
+ print(f" {GREEN}✓ Copied {target.name} (Symlink fallback){NC}")
142
+ except Exception as e2:
143
+ print(f" {RED}x Failed to copy {target}: {e2}{NC}")
144
+ except Exception as e:
145
+ print(f" {RED}x Failed to link {target}: {e}{NC}")
146
+
147
+
148
+ def setup_skills_for_platform(
149
+ platform, skills_src_dir, target_dir, project_root, native_subset=None
150
+ ):
151
+ """
152
+ Distributes skills to platform-specific formats.
153
+
154
+ native_subset: when "core", emit only skills flagged `core: true` in their
155
+ frontmatter. This keeps a large collection (180+ skills) under a runtime's
156
+ native skill-discovery budget (e.g. Claude Code truncates big skill menus) —
157
+ the full catalog stays discoverable via agents/skills/00-index.md. Default
158
+ (None) emits every skill, preserving existing behavior.
159
+ """
160
+ print(f"\n{BLUE}→ Setting up skills for {platform}...{NC}")
161
+ target_dir.mkdir(parents=True, exist_ok=True)
162
+
163
+ # Get all .skill.md files recursively
164
+ skill_files = list(skills_src_dir.rglob("*.skill.md"))
165
+
166
+ count = 0
167
+ for skill_file in skill_files:
168
+ content = skill_file.read_text()
169
+ meta, content_with_fm = ensure_yaml_frontmatter(content, skill_file.name)
170
+
171
+ # Curated native emit: skip non-core skills when a subset was requested.
172
+ if native_subset == "core" and str(meta.get("core", "")).lower() != "true":
173
+ continue
174
+
175
+ # Slugify name for files/commands (e.g. "Agent Interop" -> "agent-interop").
176
+ # safe_slug() prevents path traversal via a malicious frontmatter name.
177
+ raw_name = meta.get("name", skill_file.stem.replace(".skill", ""))
178
+ skill_slug = safe_slug(raw_name, fallback=skill_file.stem.replace(".skill", ""))
179
+ skill_desc = meta.get("description", f"Skill for {raw_name}")
180
+
181
+ if platform == "Cursor":
182
+ # Flatten structure: .cursor/rules/<slug>.mdc
183
+ dest_file = target_dir / f"{skill_slug}.mdc"
184
+
185
+ # Cursor "Agent Requested" rule: description + alwaysApply:false and
186
+ # NO globs, so Cursor selects the rule intelligently by description
187
+ # rather than auto-attaching it to every file (per docs.cursor.com).
188
+ cursor_fm = (
189
+ "---\n"
190
+ f"description: {skill_desc}\n"
191
+ "alwaysApply: false\n"
192
+ f"gabbe-schema-version: {GABBE_SCHEMA_VERSION}\n"
193
+ "---\n"
194
+ )
195
+ # Strip existing FM and prepend Cursor FM
196
+ start_body = content_with_fm.find("---", 3) + 3
197
+ body = content_with_fm[start_body:].strip()
198
+
199
+ final_content = cursor_fm + "\n" + body
200
+ dest_file.write_text(final_content)
201
+ count += 1
202
+
203
+ elif platform in (
204
+ "VS Code",
205
+ "GitHub Copilot",
206
+ "Claude Code",
207
+ "Antigravity",
208
+ "OpenCode",
209
+ "Universal",
210
+ ):
211
+ # Agent-skills open standard (agentskills.io), shared by Copilot,
212
+ # VS Code, Claude Code, Antigravity (.agents/skills), OpenCode, and the
213
+ # universal .agents/skills tree: <target>/<slug>/SKILL.md as a real file
214
+ # (not a symlink) with name+description frontmatter so the skill is
215
+ # discoverable on every platform and portable across filesystems.
216
+ skill_folder = target_dir / skill_slug
217
+ skill_folder.mkdir(parents=True, exist_ok=True)
218
+ (skill_folder / "SKILL.md").write_text(inject_schema_version(content_with_fm))
219
+
220
+ if platform in ("VS Code", "GitHub Copilot"):
221
+ # Optional GABBE metadata (ignored by Copilot; kept for tooling).
222
+ config = {
223
+ "name": skill_slug,
224
+ "description": skill_desc,
225
+ "version": "1.0.0",
226
+ "gabbe-schema-version": GABBE_SCHEMA_VERSION,
227
+ "slashCommands": [{"name": skill_slug, "description": skill_desc}],
228
+ }
229
+ (skill_folder / "config.json").write_text(json.dumps(config, indent=2))
230
+ count += 1
231
+
232
+ print(f" {GREEN}✓ Processed {count} skills for {platform}{NC}")
233
+
234
+
235
+ def main():
236
+ parser = argparse.ArgumentParser(description="Compile skills for specific platforms.")
237
+ parser.add_argument(
238
+ "--platform",
239
+ required=True,
240
+ choices=[
241
+ "Cursor",
242
+ "VS Code",
243
+ "GitHub Copilot",
244
+ "Claude Code",
245
+ "Antigravity",
246
+ "OpenCode",
247
+ "Universal",
248
+ "All",
249
+ ],
250
+ help="Target platform",
251
+ )
252
+ parser.add_argument(
253
+ "--skills-dir", required=True, help="Source directory for skills (agents/skills)"
254
+ )
255
+ parser.add_argument("--target-dir", required=True, help="Target directory for output")
256
+ parser.add_argument("--project-root", required=True, help="Root of the project")
257
+ parser.add_argument(
258
+ "--native-subset",
259
+ choices=["all", "core"],
260
+ default="all",
261
+ help="'core' emits only skills flagged core:true (fits native discovery budgets); "
262
+ "default 'all' emits every skill. Full catalog is always in skills/00-index.md.",
263
+ )
264
+
265
+ args = parser.parse_args()
266
+
267
+ skills_src = Path(args.skills_dir)
268
+ target_dir = Path(args.target_dir)
269
+ project_root = Path(args.project_root)
270
+
271
+ if not skills_src.exists():
272
+ print(f"{RED}Error: Skills directory not found at {skills_src}{NC}")
273
+ sys.exit(1)
274
+
275
+ subset = None if args.native_subset == "all" else args.native_subset
276
+ if args.platform == "All":
277
+ # Example logic for 'All' if needed, otherwise distinct calls are safer
278
+ pass
279
+ else:
280
+ setup_skills_for_platform(args.platform, skills_src, target_dir, project_root, subset)
281
+
282
+
283
+ if __name__ == "__main__":
284
+ main()
@@ -0,0 +1,187 @@
1
+ # SPDX-License-Identifier: Apache-2.0
2
+ import os
3
+ import re
4
+ from pathlib import Path
5
+
6
+
7
+ def main():
8
+ # Use path relative to this script location to find project root reliability
9
+ script_dir = Path(__file__).parent.resolve()
10
+ # script is in agents/scripts, so root is 2 levels up
11
+ root_dir = script_dir.parent.parent
12
+ agents_dir = root_dir / "agents"
13
+
14
+ # Exclude these directories
15
+ exclude_dirs = {".git", ".venv", "node_modules", "__pycache__", "gabbe"}
16
+
17
+ # 1. Discover all existing components
18
+ existing = {"skills": set(), "templates": set(), "guides": set(), "personas": set()}
19
+
20
+ folders = {
21
+ "skills": agents_dir / "skills",
22
+ "templates": agents_dir / "templates",
23
+ "guides": agents_dir / "guides",
24
+ "personas": agents_dir / "personas",
25
+ "memory": agents_dir / "memory",
26
+ }
27
+
28
+ # Gather skills (*.skill.md)
29
+ if folders["skills"].exists():
30
+ for root, _, files in os.walk(folders["skills"]):
31
+ for f in files:
32
+ if f.endswith(".skill.md"):
33
+ existing["skills"].add(f.replace(".skill.md", ""))
34
+
35
+ # Gather templates (*_TEMPLATE.md)
36
+ template_folders = [folders["templates"], folders["memory"]]
37
+ for tf in template_folders:
38
+ if tf.exists():
39
+ for root, _, files in os.walk(tf):
40
+ for f in files:
41
+ if f.endswith(".md") and "TEMPLATE" in f:
42
+ existing["templates"].add(f.replace(".md", ""))
43
+
44
+ # Gather guides (*.md in guides folder)
45
+ if folders["guides"].exists():
46
+ for root, _, files in os.walk(folders["guides"]):
47
+ for f in files:
48
+ if f.endswith(".md") and f != "00-index.md":
49
+ existing["guides"].add(f.replace(".md", ""))
50
+
51
+ # Gather personas (*.md in personas folder)
52
+ if folders["personas"].exists():
53
+ for root, _, files in os.walk(folders["personas"]):
54
+ for f in files:
55
+ if f.endswith(".md") and f != "00-index.md":
56
+ existing["personas"].add(f.replace(".md", ""))
57
+
58
+ print(
59
+ f"Discovered {len(existing['skills'])} skills, {len(existing['templates'])} templates, {len(existing['guides'])} guides, {len(existing['personas'])} personas.\n"
60
+ )
61
+
62
+ # 2. Search for mentions in root and docs/
63
+ mentioned = {"skills": set(), "templates": set(), "guides": set(), "personas": set()}
64
+
65
+ # Patterns
66
+ skill_p1 = re.compile(r"([\w-]+)\.skill(?!\.md)")
67
+ skill_p2 = re.compile(r"([\w-]+)\.skill\.md")
68
+ template_p = re.compile(r"([\w_]+_TEMPLATE)\.md")
69
+ guide_p = re.compile(r"guides/([\w-]+)\.md")
70
+
71
+ # We will also just check if the exact filename (minus extension) appears in the docs
72
+ def check_exact_match(content, item_set, item_type):
73
+ for item in item_set:
74
+ # simple string match
75
+ if item in content:
76
+ mentioned[item_type].add(item)
77
+
78
+ docs_to_check = []
79
+ for root, dirs, files in os.walk(root_dir):
80
+ dirs[:] = [d for d in dirs if d not in exclude_dirs and not d.startswith(".")]
81
+ for file in files:
82
+ if file.endswith(".md"):
83
+ docs_to_check.append(Path(root) / file)
84
+
85
+ for filepath in docs_to_check:
86
+ try:
87
+ with open(filepath, "r", encoding="utf-8") as f:
88
+ content = f.read()
89
+
90
+ # Extract via regex
91
+ mentioned["skills"].update(skill_p1.findall(content))
92
+ mentioned["skills"].update(skill_p2.findall(content))
93
+ mentioned["templates"].update(template_p.findall(content))
94
+ mentioned["guides"].update(guide_p.findall(content))
95
+
96
+ # Check exact mentions for all
97
+ check_exact_match(content, existing["skills"], "skills")
98
+ check_exact_match(content, existing["templates"], "templates")
99
+ check_exact_match(content, existing["guides"], "guides")
100
+ check_exact_match(content, existing["personas"], "personas")
101
+
102
+ except Exception as e:
103
+ print(f"Error reading {filepath}: {e}")
104
+
105
+ # 3. Analyze differences
106
+ for category in existing.keys():
107
+ missing = mentioned[category] - existing[category]
108
+ unmentioned = existing[category] - mentioned[category]
109
+
110
+ # Filter expected placeholders
111
+ if category == "skills":
112
+ missing -= {"my-language", "your-skill-name"}
113
+ elif category == "templates":
114
+ missing -= {"YOUR_TEMPLATE"}
115
+
116
+ print(f"--- {category.upper()} ---")
117
+ print(f"Total mentioned: {len(mentioned[category])}")
118
+ print(f"Total existing: {len(existing[category])}")
119
+
120
+ if missing:
121
+ print("[⚠️] Mentioned in docs but missing from files:")
122
+ for m in sorted(missing):
123
+ print(f" - {m}")
124
+ else:
125
+ print(f"[✅] All mentioned {category} exist.")
126
+
127
+ if unmentioned:
128
+ print(f"[ℹ️] Existing {category} NOT explicitly mentioned in any parsed docs:")
129
+ for u in sorted(unmentioned):
130
+ print(f" - {u}")
131
+ else:
132
+ print(f"[✅] All existing {category} are mentioned somewhere in docs.")
133
+
134
+ print()
135
+
136
+ # 4. Critical Quality Checks
137
+ print("--- CRITICAL QUALITY CHECKS ---")
138
+ outdated_version_files = []
139
+ corrupted_header_files = []
140
+
141
+ for filepath in docs_to_check:
142
+ try:
143
+ with open(filepath, "r", encoding="utf-8") as f:
144
+ content = f.read()
145
+
146
+ if "0.2.0" in content:
147
+ outdated_version_files.append(str(filepath))
148
+
149
+ if "## 🚀- **" in content:
150
+ corrupted_header_files.append(str(filepath))
151
+
152
+ except Exception:
153
+ pass
154
+
155
+ if outdated_version_files:
156
+ print("[❌] Outdated CLI version (0.2.0) found in:")
157
+ for f in outdated_version_files:
158
+ print(f" - {f}")
159
+ else:
160
+ print("[✅] No outdated CLI versions found.")
161
+
162
+ if corrupted_header_files:
163
+ print("[❌] Corrupted headers found in:")
164
+ for f in corrupted_header_files:
165
+ print(f" - {f}")
166
+ else:
167
+ print("[✅] No corrupted headers found.")
168
+
169
+ # 5. Workflow Disovery
170
+ print("\n--- WORKFLOWS ---")
171
+ workflows = set()
172
+ workflow_paths = [root_dir / "agents/workflows", root_dir / ".agent/workflows"]
173
+ for wp in workflow_paths:
174
+ if wp.exists():
175
+ for f in wp.glob("*.md"):
176
+ workflows.add(f.name)
177
+
178
+ if workflows:
179
+ print(f"Found {len(workflows)} workflows:")
180
+ for w in sorted(workflows):
181
+ print(f" - {w}")
182
+ else:
183
+ print("[ℹ️] No workflows found.")
184
+
185
+
186
+ if __name__ == "__main__":
187
+ main()
@@ -0,0 +1,37 @@
1
+ #!/bin/bash
2
+ # setup-context.sh: Dumps project context for AI Agents
3
+
4
+ echo "# Project Context Report"
5
+ echo "Generated: $(date)"
6
+ echo ""
7
+
8
+ echo "## Directory Structure"
9
+ echo '```'
10
+ # Use git ls-files if available, otherwise find, excluding node_modules/vendor/etc
11
+ if [ -d .git ]; then
12
+ git ls-files --exclude-standard -co | grep -vE "^(\.git|\.idea|\.vscode|node_modules|vendor|dist|build|coverage)" | tree --fromfile -L 3
13
+ else
14
+ find . -maxdepth 3 -not -path '*/.*' -not -path './node_modules*' -not -path './vendor*' -not -path './dist*' -print | sort | sed 's/[^/]*\// /g'
15
+ fi
16
+ echo '```'
17
+ echo ""
18
+
19
+ echo "## Key Configuration Files"
20
+ FILES=("package.json" "composer.json" "pyproject.toml" "go.mod" "Cargo.toml" "Makefile" "Dockerfile" "docker-compose.yml" ".env.example" "agents.md" "AGENTS.md" "SETUP_MISSION.md" "BOOTSTRAP_MISSION.md")
21
+
22
+ for f in "${FILES[@]}"; do
23
+ if [ -f "$f" ]; then
24
+ echo "### $f"
25
+ echo '```'${f##*.}
26
+ cat "$f"
27
+ echo '```'
28
+ echo ""
29
+ fi
30
+ done
31
+
32
+ echo "## Active Task List"
33
+ if [ -f "task.md" ]; then
34
+ echo '```markdown'
35
+ cat "task.md"
36
+ echo '```'
37
+ fi