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,246 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ import os
4
+ import subprocess
5
+ import sys
6
+ import tempfile
7
+ from pathlib import Path
8
+
9
+ PROJECT_ROOT = Path(__file__).resolve().parent.parent.parent
10
+ INIT_SCRIPT = PROJECT_ROOT / "scripts" / "init.py"
11
+ GABBE_EXEC = sys.executable + " -m gabbe.main"
12
+
13
+
14
+ def run_init(inputs, env, cwd):
15
+ process = subprocess.run(
16
+ [sys.executable, str(INIT_SCRIPT)],
17
+ input="\n".join(inputs) + "\n",
18
+ text=True,
19
+ env=env,
20
+ cwd=str(cwd),
21
+ capture_output=True,
22
+ )
23
+ if process.returncode != 0:
24
+ print(f"FAILED. STDOUT: {process.stdout}\nSTDERR: {process.stderr}")
25
+ sys.exit(1)
26
+ return process.stdout
27
+
28
+
29
+ def run_gabbe_command(cmd, env, cwd):
30
+ process = subprocess.run(cmd, text=True, env=env, cwd=str(cwd), capture_output=True, shell=True)
31
+ # gabbe verify is expected to fail with exit code 1 due to [PLACEHOLDER] variables inside a freshly initialized setup.
32
+ # The success state is it finding the placeholders instead of crashing.
33
+ if "gabbe verify" in cmd and process.returncode != 0:
34
+ if (
35
+ "Verification FAILED" in process.stdout
36
+ or "Placeholder" in process.stdout
37
+ or "Found" in process.stdout
38
+ or "Missing" in process.stdout
39
+ ):
40
+ return (
41
+ process.stdout
42
+ ) # This is expected behavior for edge case where human needs to input stuff
43
+ elif process.returncode != 0:
44
+ print(f"GABBE FAILED. STDOUT: {process.stdout}\nSTDERR: {process.stderr}")
45
+ sys.exit(1)
46
+ return process.stdout
47
+
48
+
49
+ def create_mock_user_files(agents_dir):
50
+ (agents_dir / "AGENTS.md").write_text("custom user agents")
51
+ (agents_dir / "CONSTITUTION.md").write_text("my custom rules")
52
+ mem_dir = agents_dir / "memory" / "episodic"
53
+ mem_dir.mkdir(parents=True, exist_ok=True)
54
+ (mem_dir / "SESSION_SNAPSHOT.md").write_text("mem")
55
+
56
+ proj_dir = agents_dir / "project"
57
+ proj_dir.mkdir(parents=True, exist_ok=True)
58
+ (proj_dir / "TASKS.md").write_text("my custom tasks")
59
+ (proj_dir / "policies.yml").write_text("my custom policy")
60
+ (proj_dir / "config.json").write_text('{"key": "value"}')
61
+
62
+
63
+ def verify_mock_user_files(agents_dir):
64
+ assert (agents_dir / "AGENTS.md").read_text() == "custom user agents", "AGENTS.md overwritten"
65
+ assert (
66
+ agents_dir / "CONSTITUTION.md"
67
+ ).read_text() == "my custom rules", "CONSTITUTION.md overwritten"
68
+ assert (
69
+ agents_dir / "memory" / "episodic" / "SESSION_SNAPSHOT.md"
70
+ ).read_text() == "mem", "memory overwritten"
71
+
72
+ # Adding specific project files per user request
73
+ assert (
74
+ agents_dir / "project" / "TASKS.md"
75
+ ).read_text() == "my custom tasks", "TASKS.md overwritten"
76
+ assert (
77
+ agents_dir / "project" / "policies.yml"
78
+ ).read_text() == "my custom policy", "policies.yml overwritten"
79
+ assert (
80
+ agents_dir / "project" / "config.json"
81
+ ).read_text() == '{"key": "value"}', "config.json overwritten"
82
+
83
+
84
+ def test_global_flow():
85
+ with tempfile.TemporaryDirectory() as td:
86
+ mock_home = Path(td) / "mock_home"
87
+ mock_home.mkdir()
88
+ cwd = Path(td) / "project"
89
+ cwd.mkdir()
90
+ env = os.environ.copy()
91
+ env["HOME"] = str(mock_home)
92
+ env["PYTHONPATH"] = str(PROJECT_ROOT) + os.pathsep + env.get("PYTHONPATH", "")
93
+
94
+ print("Testing Global Install Flow...")
95
+ inputs = ["2", "", "", "1", "1", "3", "", "6", "7", "n", "n", "n", "n", "7"] # Global
96
+ out = run_init(inputs, env, cwd)
97
+ expected_agents = mock_home / "agents"
98
+ assert expected_agents.exists()
99
+ assert (expected_agents / "AGENTS.md").exists()
100
+
101
+ print("Testing Global CLI Verify edges (checking logic flows)...")
102
+ # Set agent dir to the global space we just mapped
103
+ env["GABBE_AGENTS_DIR"] = str(expected_agents)
104
+ run_gabbe_command(f"{GABBE_EXEC} init", env, cwd)
105
+ run_gabbe_command(f"{GABBE_EXEC} sync", env, cwd)
106
+ verify_out = run_gabbe_command(f"{GABBE_EXEC} verify", env, cwd)
107
+ # Assuming it catches placeholders:
108
+ assert verify_out is not None
109
+
110
+ print("Testing Global Update Flow...")
111
+ create_mock_user_files(expected_agents)
112
+ inputs_update = [
113
+ "2", # Global
114
+ "y", # Merge
115
+ "",
116
+ "",
117
+ "1",
118
+ "1",
119
+ "3",
120
+ "",
121
+ "6",
122
+ "7",
123
+ "n",
124
+ "n",
125
+ "n",
126
+ "n",
127
+ "7",
128
+ ]
129
+ out_update = run_init(inputs_update, env, cwd)
130
+ verify_mock_user_files(expected_agents)
131
+ assert "Preserved user file(s): AGENTS.md" in out_update
132
+ print("[PASS] Global flows safely tested.\n")
133
+
134
+
135
+ def test_local_flow():
136
+ with tempfile.TemporaryDirectory() as td:
137
+ cwd = Path(td) / "project"
138
+ cwd.mkdir()
139
+ env = os.environ.copy()
140
+ env["PYTHONPATH"] = str(PROJECT_ROOT) + os.pathsep + env.get("PYTHONPATH", "")
141
+
142
+ print("Testing Local Install Flow...")
143
+ inputs = ["1", "", "", "1", "1", "3", "", "6", "7", "n", "n", "n", "n", "7"] # Local
144
+ out = run_init(inputs, env, cwd)
145
+ expected_agents = cwd / "agents"
146
+ assert expected_agents.exists()
147
+
148
+ print("Testing Local CLI Verify edges (checking logic flows)...")
149
+ run_gabbe_command(f"{GABBE_EXEC} init", env, cwd)
150
+ run_gabbe_command(f"{GABBE_EXEC} sync", env, cwd)
151
+ verify_out = run_gabbe_command(f"{GABBE_EXEC} verify", env, cwd)
152
+ assert verify_out is not None
153
+
154
+ print("Testing Local Update Flow...")
155
+ create_mock_user_files(expected_agents)
156
+ inputs_update = [
157
+ "1", # Local
158
+ "y", # Merge
159
+ "",
160
+ "",
161
+ "1",
162
+ "1",
163
+ "3",
164
+ "",
165
+ "6",
166
+ "7",
167
+ "n",
168
+ "n",
169
+ "n",
170
+ "n",
171
+ "7",
172
+ ]
173
+ out_update = run_init(inputs_update, env, cwd)
174
+ verify_mock_user_files(expected_agents)
175
+ assert "Preserved user file(s): AGENTS.md" in out_update
176
+ print("[PASS] Local flows safely tested.\n")
177
+
178
+
179
+ def test_custom_flow():
180
+ with tempfile.TemporaryDirectory() as td:
181
+ cwd = Path(td) / "project"
182
+ cwd.mkdir()
183
+ custom_dir = Path(td) / "custom_agents"
184
+ env = os.environ.copy()
185
+ env["PYTHONPATH"] = str(PROJECT_ROOT) + os.pathsep + env.get("PYTHONPATH", "")
186
+
187
+ print("Testing Custom Install Flow...")
188
+ inputs = [
189
+ "3", # Custom
190
+ str(custom_dir),
191
+ "",
192
+ "",
193
+ "1",
194
+ "1",
195
+ "3",
196
+ "",
197
+ "6",
198
+ "7",
199
+ "n",
200
+ "n",
201
+ "n",
202
+ "n",
203
+ "7",
204
+ ]
205
+ out = run_init(inputs, env, cwd)
206
+ assert custom_dir.exists()
207
+
208
+ print("Testing Custom CLI Verify edges (checking logic flows)...")
209
+ env["GABBE_AGENTS_DIR"] = str(custom_dir)
210
+ run_gabbe_command(f"{GABBE_EXEC} init", env, cwd)
211
+ run_gabbe_command(f"{GABBE_EXEC} sync", env, cwd)
212
+ verify_out = run_gabbe_command(f"{GABBE_EXEC} verify", env, cwd)
213
+ assert verify_out is not None
214
+
215
+ print("Testing Custom Update Flow...")
216
+ create_mock_user_files(custom_dir)
217
+ inputs_update = [
218
+ "3", # Custom
219
+ str(custom_dir),
220
+ "y", # Merge
221
+ "",
222
+ "",
223
+ "1",
224
+ "1",
225
+ "3",
226
+ "",
227
+ "6",
228
+ "7",
229
+ "n",
230
+ "n",
231
+ "n",
232
+ "n",
233
+ "7",
234
+ ]
235
+ out_update = run_init(inputs_update, env, cwd)
236
+ verify_mock_user_files(custom_dir)
237
+ assert "Preserved user file(s): AGENTS.md" in out_update
238
+ print("[PASS] Custom flows safely tested.\n")
239
+
240
+
241
+ if __name__ == "__main__":
242
+ print("=== Starting E2E Setup Simulation Validations ===\n")
243
+ test_global_flow()
244
+ test_local_flow()
245
+ test_custom_flow()
246
+ print("\\033[0;32mALL COMPREHENSIVE E2E FLOWS (12 PERMUTATIONS) VERIFIED SUCCESSFULLY.\\033[0m")
@@ -0,0 +1,104 @@
1
+ #!/usr/bin/env python3
2
+ # SPDX-License-Identifier: Apache-2.0
3
+ import sys
4
+ import tempfile
5
+ from pathlib import Path
6
+ from unittest.mock import patch
7
+
8
+ # Add project root and scripts dir to path so we can import init
9
+ PROJECT_ROOT = Path(__file__).parent.parent.parent
10
+ sys.path.append(str(PROJECT_ROOT))
11
+ sys.path.append(str(PROJECT_ROOT / "scripts"))
12
+
13
+ import init # noqa: E402
14
+
15
+ RED = "\033[0;31m"
16
+ GREEN = "\033[0;32m"
17
+ NC = "\033[0m"
18
+
19
+
20
+ def test_tech_map_generation():
21
+ print("\nTesting build_tech_map_from_skills...")
22
+ # Point to the actual agents dir
23
+ agents_dir = PROJECT_ROOT / "agents"
24
+ tech_map = init.build_tech_map_from_skills(agents_dir)
25
+
26
+ # Assertions
27
+ if "python" in tech_map and "tdd-cycle" in tech_map["python"]["skills"]:
28
+ print(f"{GREEN}[PASS] Python mapped to tdd-cycle{NC}")
29
+ else:
30
+ print(f"{RED}[FAIL] Python mapping issues: {tech_map.get('python')}{NC}")
31
+
32
+ if "brain" in tech_map and "sequential-thinking" in tech_map["brain"]["skills"]:
33
+ print(f"{GREEN}[PASS] Brain mapped to sequential-thinking{NC}")
34
+ else:
35
+ # sequential-thinking tag is 'brain', 'core', 'reasoning'
36
+ # check if 'brain' key exists
37
+ print(f"{RED}[FAIL] Brain mapping issues.{NC}")
38
+
39
+ # Check if we have entries
40
+ print(f"Total keys in TECH_MAP: {len(tech_map)}")
41
+
42
+
43
+ def test_platform_setup():
44
+ print("\nTesting setup_skills_for_platform...")
45
+ with tempfile.TemporaryDirectory() as temp_dir_str:
46
+ temp_dir = Path(temp_dir_str)
47
+ # setup_skills_for_platform(platform, agents_dir, target_dir) expects the
48
+ # AGENTS directory (it looks for agents_dir/scripts/compile_skills.py and
49
+ # reads agents_dir/skills) — NOT the skills dir itself.
50
+ agents_dir = PROJECT_ROOT / "agents"
51
+
52
+ # Test Cursor (Generation). For Cursor the compiler writes only to
53
+ # target_dir (no project-root mutation), so a temp target is safe.
54
+ cursor_target = temp_dir / "cursor_rules"
55
+ init.setup_skills_for_platform("Cursor", agents_dir, cursor_target)
56
+
57
+ if cursor_target.exists() and list(cursor_target.glob("*.mdc")):
58
+ print(f"{GREEN}[PASS] Cursor rules generated{NC}")
59
+ # Check the real Cursor frontmatter contract emitted by compile_skills.py:
60
+ # description + `alwaysApply: false` (Agent-Requested rule, no globs).
61
+ mdc_files = list(cursor_target.glob("*.mdc"))
62
+ content = mdc_files[0].read_text()
63
+ if "alwaysApply: false" in content:
64
+ print(f"{GREEN}[PASS] Cursor frontmatter (alwaysApply: false) present{NC}")
65
+ else:
66
+ print(f"{RED}[FAIL] Cursor frontmatter missing alwaysApply: false{NC}")
67
+ else:
68
+ print(f"{RED}[FAIL] Cursor rules not generated{NC}")
69
+
70
+
71
+ def test_symlink_fallback():
72
+ print("\nTesting symlink fallback mechanism...")
73
+ with tempfile.TemporaryDirectory() as temp_dir_str:
74
+ temp_dir = Path(temp_dir_str)
75
+ source = temp_dir / "source"
76
+ source.mkdir()
77
+ (source / "file.txt").write_text("content")
78
+ target = temp_dir / "target"
79
+
80
+ # Mock os.symlink to raise OSError (simulate Windows non-admin)
81
+ with patch("os.symlink", side_effect=OSError("Privilege not held")):
82
+ # We need to import init inside patch context or patch where it's used
83
+ # Since we imported init at top level, we patch 'os.symlink' globally if possible,
84
+ # but better to patch 'init.os.symlink' if that's how it's bound, or just 'os.symlink'.
85
+
86
+ # Recalling create_symlink logic: it calls os.symlink
87
+ init.create_symlink(source, target)
88
+
89
+ if target.exists() and not target.is_symlink():
90
+ print(f"{GREEN}[PASS] Fallback copy successful (Target exists and is NOT symlink){NC}")
91
+ else:
92
+ print(
93
+ f"{RED}[FAIL] Fallback failed. Target exists: {target.exists()}, Is symlink: {target.is_symlink()}{NC}"
94
+ )
95
+
96
+
97
+ def main():
98
+ test_tech_map_generation()
99
+ test_platform_setup()
100
+ test_symlink_fallback()
101
+
102
+
103
+ if __name__ == "__main__":
104
+ main()
@@ -0,0 +1,159 @@
1
+ # SPDX-License-Identifier: Apache-2.0
2
+ import json
3
+ import os
4
+ import re
5
+ import sys
6
+ from pathlib import Path
7
+
8
+ # ANSI colors for output
9
+ RED = "\033[0;31m"
10
+ GREEN = "\033[0;32m"
11
+ BLUE = "\033[0;34m"
12
+ YELLOW = "\033[0;33m"
13
+ NC = "\033[0m"
14
+
15
+ PROJECT_ROOT = Path(__file__).parent.parent.parent
16
+ AGENTS_DIR = PROJECT_ROOT / "agents"
17
+
18
+
19
+ def verify_triggers_and_mcps():
20
+ print(f"\n{BLUE}=== Skill Triggers and MCP Server Audit ==={NC}")
21
+
22
+ # 1. Parse MCP Servers
23
+ mcp_config_path = AGENTS_DIR / "templates/core/MCP_CONFIG_TEMPLATE.json"
24
+ with open(mcp_config_path, "r") as f:
25
+ mcp_data = json.load(f)
26
+
27
+ mcp_servers = set(mcp_data.get("mcpServers", {}).keys())
28
+ print(
29
+ f"{GREEN}✓ Loaded {len(mcp_servers)} MCP Servers from Config: {', '.join(list(mcp_servers)[:5])}...{NC}"
30
+ )
31
+
32
+ # 2. Parse 00-index.md to get Skill File -> Triggers map
33
+ skill_index_path = AGENTS_DIR / "skills/00-index.md"
34
+
35
+ skill_triggers = {}
36
+ all_triggers = set()
37
+
38
+ with open(skill_index_path, "r") as f:
39
+ for line in f:
40
+ if "|" in line and ".skill.md" in line:
41
+ # Format is usually: | Skill Name | `path/to/skill.skill.md` | trigger1, trigger2 | ... |
42
+ parts = [p.strip() for p in line.split("|")]
43
+ if len(parts) >= 4:
44
+ file_match = re.search(r"`([^`]+\.skill\.md)`", parts[2])
45
+ if file_match:
46
+ file_path = file_match.group(1)
47
+ basename = file_path.split("/")[-1].replace(".skill.md", "")
48
+
49
+ triggers = [t.strip() for t in parts[3].split(",")]
50
+ skill_triggers[basename] = triggers
51
+ all_triggers.update(triggers)
52
+
53
+ print(f"{GREEN}✓ Extracted triggers for {len(skill_triggers)} skills.{NC}")
54
+
55
+ # Check that Triggers aren't empty
56
+ empty_triggers = [s for s, t in skill_triggers.items() if not t or t == [""]]
57
+ if empty_triggers:
58
+ print(f"{RED}x FAIL: Skills with missing triggers in index: {empty_triggers}{NC}")
59
+ sys.exit(1)
60
+
61
+ # 3. Check Prompts in Docs
62
+ docs_to_check = [
63
+ PROJECT_ROOT / "README.md",
64
+ PROJECT_ROOT / "docs/README_FULL.md",
65
+ PROJECT_ROOT / "docs/QUICK_GUIDE.md",
66
+ PROJECT_ROOT / "docs/QUICK_COMMANDS.md",
67
+ ]
68
+
69
+ for folder in ["guides", "skills"]:
70
+ folder_path = AGENTS_DIR / folder
71
+ if folder_path.exists():
72
+ for root, _, files in os.walk(folder_path):
73
+ for f in files:
74
+ if f.endswith(".md"):
75
+ docs_to_check.append(Path(root) / f)
76
+
77
+ print(f"\n{BLUE}--- Validating Prompt Chaining across {len(docs_to_check)} files ---{NC}")
78
+
79
+ # Regex to find: "run X skill" or "use X skill"
80
+ prompt_skill_regex = re.compile(
81
+ r"(?:use|run)\s+(?:the\s+)?([a-zA-Z0-9-]+)\s*skill", re.IGNORECASE
82
+ )
83
+
84
+ stop_words = {
85
+ "a",
86
+ "this",
87
+ "that",
88
+ "any",
89
+ "some",
90
+ "which",
91
+ "your",
92
+ "my",
93
+ "our",
94
+ "one",
95
+ "another",
96
+ "these",
97
+ }
98
+
99
+ errors = 0
100
+ warnings = 0
101
+ for doc in docs_to_check:
102
+ if not doc.exists():
103
+ continue
104
+ with open(doc, "r") as f:
105
+ content = f.read()
106
+
107
+ mentions = prompt_skill_regex.findall(content)
108
+ for mention in mentions:
109
+ mention = mention.lower()
110
+ if mention in stop_words:
111
+ continue
112
+
113
+ # If it explicitly matches a skill filename or a registered trigger
114
+ if mention in skill_triggers or mention in all_triggers:
115
+ pass # valid
116
+ else:
117
+ print(
118
+ f"{YELLOW}! WARNING: Document '{doc.name}' uses skill/trigger '{mention}' which is not in the index.{NC}"
119
+ )
120
+ warnings += 1
121
+ # We won't strictly fail on this because natural language might say "use debugging skill" instead of "use debug skill",
122
+ # but it's a good sanity check.
123
+
124
+ # 4. Check specific Visual Design MCPs bindings
125
+ visual_skill_path = AGENTS_DIR / "skills/architecture/visual-whiteboarding.skill.md"
126
+ if visual_skill_path.exists():
127
+ with open(visual_skill_path, "r") as f:
128
+ visual_content = f.read()
129
+
130
+ required_mcps = ["drawio", "miro", "figma"]
131
+ for rmcp in required_mcps:
132
+ # We must check if the tool actually documents these specifically mapping to the exact keys in MCP JSON.
133
+ mcp_key = None
134
+ for key in mcp_servers:
135
+ if rmcp.lower() in key.lower() or key.lower() in rmcp.lower():
136
+ mcp_key = key
137
+ break
138
+
139
+ if mcp_key:
140
+ print(
141
+ f"{GREEN}✓ Mapped '{rmcp}' capability in visual skill to MCP Server key: {mcp_key}{NC}"
142
+ )
143
+ else:
144
+ print(
145
+ f"{RED}x FAIL: Visual skill requires '{rmcp}' but no matching MCP Server found in MCP_CONFIG_TEMPLATE.json!{NC}"
146
+ )
147
+ errors += 1
148
+
149
+ if errors > 0:
150
+ print(f"\n{RED}Audit Failed with {errors} errors.{NC}")
151
+ sys.exit(1)
152
+
153
+ print(
154
+ f"\n{GREEN}=== Audit Complete. All triggers, skills, and MCP bindings are chained correctly. ==={NC}"
155
+ )
156
+
157
+
158
+ if __name__ == "__main__":
159
+ verify_triggers_and_mcps()