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,250 @@
1
+ <#
2
+ .SYNOPSIS
3
+ GABBE Agentic Kit - Context Setup Script (PowerShell)
4
+ .DESCRIPTION
5
+ Wires up the agents/ directory to various AI coding tools on Windows.
6
+ Creates necessary symlinks (or copies if non-admin) and initializes memory.
7
+ .NOTES
8
+ Usage: .\setup-context.ps1
9
+ #>
10
+
11
+ $ErrorActionPreference = "Stop"
12
+
13
+ # --- Configuration ---
14
+ $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
15
+ $AgentsDir = Resolve-Path "$ScriptDir\.."
16
+ $ProjectRoot = Resolve-Path "$AgentsDir\.."
17
+
18
+ # Colors for Output
19
+ function Write-Green($text) { Write-Host $text -ForegroundColor Green }
20
+ function Write-Yellow($text) { Write-Host $text -ForegroundColor Yellow }
21
+ function Write-Blue($text) { Write-Host $text -ForegroundColor Cyan }
22
+ function Write-Red($text) { Write-Host $text -ForegroundColor Red }
23
+
24
+ # Helper: Create Symlink with Fallback
25
+ function New-SymlinkOrCopy {
26
+ param (
27
+ [string]$SourcePath,
28
+ [string]$TargetPath,
29
+ [bool]$IsDirectory = $false
30
+ )
31
+
32
+ $Source = $SourcePath
33
+ $Target = $TargetPath
34
+
35
+ # Remove existing target if it exists
36
+ if (Test-Path $Target) {
37
+ if ((Get-Item $Target).LinkType -in @('SymbolicLink', 'Junction', 'HardLink')) {
38
+ # It's a link (symlink/junction/hardlink) — safe to remove the link itself.
39
+ # LinkType avoids misclassifying a regular file/dir as a link (which would
40
+ # delete the user's real file); a directory Junction must be in this set or
41
+ # it falls into the "real dir" branch and Move-Item would relocate its target.
42
+ Remove-Item $Target -Force -Recurse -ErrorAction SilentlyContinue
43
+ } else {
44
+ # It's a real file/dir, backup first
45
+ Write-Yellow "! Backing up existing $Target to $Target.bak"
46
+ Move-Item $Target "$Target.bak" -Force
47
+ }
48
+ }
49
+
50
+ # Ensure parent dir exists
51
+ $ParentDir = Split-Path $Target -Parent
52
+ if (-not (Test-Path $ParentDir)) {
53
+ New-Item -ItemType Directory -Path $ParentDir -Force | Out-Null
54
+ }
55
+
56
+ try {
57
+ # Try Creating Symlink (Requires Admin usually, or Dev Mode)
58
+ New-Item -ItemType SymbolicLink -Path $Target -Target $Source -Force | Out-Null
59
+ Write-Green "✓ Linked $(Split-Path $Target -Leaf) -> $Source"
60
+ }
61
+ catch {
62
+ Write-Yellow "! Symlink failed (requires Admin or Dev Mode). Falling back to Copy..."
63
+ try {
64
+ if ($IsDirectory) {
65
+ Copy-Item -Path $Source -Destination $Target -Recurse -Force
66
+ } else {
67
+ Copy-Item -Path $Source -Destination $Target -Force
68
+ }
69
+ Write-Green "✓ Copied $(Split-Path $Target -Leaf) (Fallback)"
70
+ }
71
+ catch {
72
+ Write-Red "x Failed to copy: $_"
73
+ }
74
+ }
75
+ }
76
+
77
+ Write-Host ""
78
+ Write-Blue "======================================"
79
+ Write-Blue " Agentic Engineering Kit — Setup "
80
+ Write-Blue "======================================"
81
+ Write-Host ""
82
+
83
+ # -----------------------------------------------------------------------------
84
+ # Step 1: Unifying Context (AGENTS.md -> Tools)
85
+ # -----------------------------------------------------------------------------
86
+ Write-Yellow "Step 1: Unifying agent context (AGENTS.md -> all tools)"
87
+
88
+ # Paths
89
+ $AgentsMd = "$AgentsDir\AGENTS.md"
90
+
91
+ # Claude
92
+ New-SymlinkOrCopy -SourcePath $AgentsMd -TargetPath "$ProjectRoot\.claude\CLAUDE.md"
93
+
94
+ # Cursor
95
+ New-SymlinkOrCopy -SourcePath $AgentsMd -TargetPath "$ProjectRoot\.cursorrules"
96
+
97
+ # Gemini / Antigravity
98
+ if (-not (Test-Path "$ProjectRoot\.gemini")) { New-Item -ItemType Directory -Path "$ProjectRoot\.gemini" | Out-Null }
99
+ if (-not (Test-Path "$ProjectRoot\.gemini\settings.json")) {
100
+ $SettingsJson = @{
101
+ agent_instructions_file = "..\agents\AGENTS.md"
102
+ skills_directory = "..\agents\skills\"
103
+ notes = "Managed by agents\setup-context.ps1"
104
+ } | ConvertTo-Json -Depth 2
105
+ Set-Content -Path "$ProjectRoot\.gemini\settings.json" -Value $SettingsJson
106
+ Write-Green "✓ .gemini\settings.json created"
107
+ } else {
108
+ Write-Yellow "! .gemini\settings.json already exists (skipped)"
109
+ }
110
+
111
+ # GitHub Copilot
112
+ New-SymlinkOrCopy -SourcePath $AgentsMd -TargetPath "$ProjectRoot\.github\copilot-instructions.md"
113
+
114
+ Write-Host ""
115
+
116
+ # -----------------------------------------------------------------------------
117
+ # Step 2: Wiring Skills
118
+ # -----------------------------------------------------------------------------
119
+ Write-Yellow "Step 2: Wiring skills directories"
120
+
121
+ $SkillsDir = "$AgentsDir\skills"
122
+
123
+ # Claude Skills
124
+ New-SymlinkOrCopy -SourcePath $SkillsDir -TargetPath "$ProjectRoot\.claude\skills" -IsDirectory $true
125
+
126
+ # Agent Skills (Gemini)
127
+ New-SymlinkOrCopy -SourcePath $SkillsDir -TargetPath "$ProjectRoot\.agent\skills" -IsDirectory $true
128
+
129
+ # Cursor & VS Code (Compile)
130
+ $CompileScript = "$AgentsDir\scripts\compile_skills.py"
131
+ if (Test-Path $CompileScript) {
132
+ Write-Yellow "Compiling skills for Cursor and VS Code..."
133
+
134
+ # Check for Python
135
+ try {
136
+ python --version | Out-Null
137
+
138
+ # Cursor
139
+ python "$CompileScript" --platform "Cursor" --skills-dir "$SkillsDir" --target-dir "$ProjectRoot\.cursor\rules" --project-root "$ProjectRoot"
140
+
141
+ # VS Code
142
+ python "$CompileScript" --platform "VS Code" --skills-dir "$SkillsDir" --target-dir "$ProjectRoot\.github\skills" --project-root "$ProjectRoot"
143
+ }
144
+ catch {
145
+ Write-Red "x Python not found or error running compile_skills.py. Skipping compilation."
146
+ }
147
+ } else {
148
+ Write-Red "x compile_skills.py not found at $CompileScript"
149
+ }
150
+
151
+ Write-Host ""
152
+
153
+ # -----------------------------------------------------------------------------
154
+ # Step 3: Initialize Memory
155
+ # -----------------------------------------------------------------------------
156
+ Write-Yellow "Step 3: Initializing loki\memory structure"
157
+
158
+ $MemoryDir = "$AgentsDir\memory"
159
+ New-Item -ItemType Directory -Path "$MemoryDir\episodic\SESSION_SNAPSHOT" -Force | Out-Null
160
+ New-Item -ItemType Directory -Path "$MemoryDir\semantic" -Force | Out-Null
161
+ Write-Green "✓ loki\memory structure created"
162
+
163
+ Write-Host ""
164
+
165
+ # -----------------------------------------------------------------------------
166
+ # Step 4: Initialize Memory Files
167
+ # -----------------------------------------------------------------------------
168
+ Write-Yellow "Step 4: Initializing memory files"
169
+
170
+ # We use the existing logic to check if they exist, but creating them in PS is verbose.
171
+ # Ideally these should be templates copied from agents\templates\ if possible,
172
+ # or we just write short placeholders like the bash script.
173
+
174
+ function Create-MemoryFile($FileName, $Content) {
175
+ $Path = "$MemoryDir\$FileName"
176
+ if (-not (Test-Path $Path)) {
177
+ Set-Content -Path $Path -Value $Content -Encoding UTF8
178
+ Write-Green "✓ Created $FileName"
179
+ } else {
180
+ Write-Yellow "! $FileName already exists (skipped)"
181
+ }
182
+ }
183
+
184
+ $ProjectStateContent = @"
185
+ # PROJECT_STATE.md — Master Project State
186
+ > Updated by: sdlc-checkpoint.skill
187
+
188
+ ## Current SDLC Phase
189
+ Phase: S00_INITIALIZED
190
+ Status: NOT_STARTED
191
+
192
+ ## Next Actions
193
+ 1. Fill in AGENTS.md
194
+ 2. Run spec-writer.skill
195
+ "@
196
+
197
+ Create-MemoryFile "PROJECT_STATE.md" $ProjectStateContent
198
+
199
+ $AuditLogContent = @"
200
+ # AUDIT_LOG.md — Project Audit Trail
201
+ > APPEND ONLY. Updated by: audit-trail.skill
202
+
203
+ | Timestamp | Session | Agent/Human | Action Type | Description | Outcome |
204
+ |---|---|---|---|---|---|
205
+ | INIT | S00 | setup-context.ps1 | PHASE_TRANSITION | Kit initialized | SUCCESS |
206
+ "@
207
+
208
+ Create-MemoryFile "AUDIT_LOG.md" $AuditLogContent
209
+
210
+ $ContinuityContent = @"
211
+ # CONTINUITY.md — Project Memory: Past Failures & Lessons
212
+ > Read at START of reason phase.
213
+
214
+ ## Past Failures & Lessons
215
+ _No entries yet._
216
+ "@
217
+
218
+ Create-MemoryFile "CONTINUITY.md" $ContinuityContent
219
+
220
+ Write-Host ""
221
+
222
+ # -----------------------------------------------------------------------------
223
+ # Step 5: Update .gitignore
224
+ # -----------------------------------------------------------------------------
225
+ Write-Yellow "Step 5: Updating .gitignore"
226
+
227
+ $GitIgnore = "$ProjectRoot\.gitignore"
228
+ if (-not (Test-Path $GitIgnore)) { New-Item -ItemType File -Path $GitIgnore | Out-Null }
229
+
230
+ $CurrentIgnore = Get-Content $GitIgnore -Raw -ErrorAction SilentlyContinue
231
+ $AppendContent = ""
232
+
233
+ if ($CurrentIgnore -notmatch "\.env") { $AppendContent += "`n.env`n" }
234
+ if ($CurrentIgnore -notmatch "\.env\.local") { $AppendContent += ".env.local`n" }
235
+ if ($CurrentIgnore -notmatch "\.env\.*\.local") { $AppendContent += ".env.*.local`n" }
236
+
237
+ if ($AppendContent -ne "") {
238
+ Add-Content -Path $GitIgnore -Value $AppendContent
239
+ Write-Green "✓ Updated .gitignore"
240
+ } else {
241
+ Write-Yellow "! .gitignore already up to date"
242
+ }
243
+
244
+ Write-Host ""
245
+ Write-Green "======================================"
246
+ Write-Green " Context Unification Complete! "
247
+ Write-Green "======================================"
248
+ Write-Host "Kit is ready. Next steps:"
249
+ Write-Host " 1. Fill in AGENTS.md placeholders"
250
+ Write-Host " 2. Tell your AI: 'Read AGENTS.md and start with spec-writer skill'"
@@ -0,0 +1,398 @@
1
+ #!/usr/bin/env bash
2
+ # setup-context.sh — Context Unification Script
3
+ # Run once per project to wire up agents/ kit for all AI coding tools.
4
+ #
5
+ # Usage: chmod +x agents/setup-context.sh && agents/setup-context.sh
6
+ #
7
+ # What this does:
8
+ # 1. Symlinks AGENTS.md -> all tool-specific context files
9
+ # 2. Symlinks agents/skills/ -> tool-specific skill directories
10
+ # 3. Creates agents/memory/ directory structure
11
+ # 4. Initializes starter memory files
12
+ # 5. Creates .gitignore entries for local-only files
13
+
14
+ set -e
15
+
16
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
17
+ AGENTS_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
18
+ PROJECT_ROOT="$(cd "${AGENTS_DIR}/.." && pwd)"
19
+
20
+ GREEN='\033[0;32m'
21
+ YELLOW='\033[1;33m'
22
+ BLUE='\033[0;34m'
23
+ RED='\033[0;31m'
24
+ NC='\033[0m' # No Color
25
+
26
+ echo ""
27
+ echo -e "${BLUE}======================================${NC}"
28
+ echo -e "${BLUE} Agentic Engineering Kit — Setup ${NC}"
29
+ echo -e "${BLUE}======================================${NC}"
30
+ echo ""
31
+
32
+ # ─────────────────────────────────────────────────────────────────────────────
33
+ # Step 1: Symlink AGENTS.md to all AI tool context locations
34
+ # ─────────────────────────────────────────────────────────────────────────────
35
+ echo -e "${YELLOW}Step 1: Unifying agent context (AGENTS.md -> all tools)${NC}"
36
+
37
+ # Claude Code: .claude/CLAUDE.md
38
+ if [ ! -d "${PROJECT_ROOT}/.claude" ]; then
39
+ mkdir -p "${PROJECT_ROOT}/.claude"
40
+ fi
41
+ if [ -L "${PROJECT_ROOT}/.claude/CLAUDE.md" ]; then
42
+ rm "${PROJECT_ROOT}/.claude/CLAUDE.md"
43
+ fi
44
+ if [ ! -f "${PROJECT_ROOT}/.claude/CLAUDE.md" ]; then
45
+ # Relative path: from .claude/ to agents/AGENTS.md
46
+ ln -sf "../agents/AGENTS.md" "${PROJECT_ROOT}/.claude/CLAUDE.md"
47
+ echo -e " ${GREEN}✓${NC} .claude/CLAUDE.md -> ../agents/AGENTS.md"
48
+ else
49
+ echo -e " ${YELLOW}!${NC} .claude/CLAUDE.md already exists (not a symlink — skipped)"
50
+ fi
51
+
52
+ # Cursor: .cursorrules
53
+ if [ -L "${PROJECT_ROOT}/.cursorrules" ]; then
54
+ rm "${PROJECT_ROOT}/.cursorrules"
55
+ fi
56
+ if [ ! -f "${PROJECT_ROOT}/.cursorrules" ]; then
57
+ # Relative path: from root to agents/AGENTS.md
58
+ ln -sf "agents/AGENTS.md" "${PROJECT_ROOT}/.cursorrules"
59
+ echo -e " ${GREEN}✓${NC} .cursorrules -> agents/AGENTS.md"
60
+ else
61
+ echo -e " ${YELLOW}!${NC} .cursorrules already exists (not a symlink — skipped)"
62
+ fi
63
+
64
+ # Gemini / Antigravity: .gemini/settings.json (agent_instructions field)
65
+ # Note: We create a wrapper settings.json that references AGENTS.md
66
+ if [ ! -d "${PROJECT_ROOT}/.gemini" ]; then
67
+ mkdir -p "${PROJECT_ROOT}/.gemini"
68
+ fi
69
+ if [ ! -f "${PROJECT_ROOT}/.gemini/settings.json" ]; then
70
+ cat > "${PROJECT_ROOT}/.gemini/settings.json" << 'EOF'
71
+ {
72
+ "agent_instructions_file": "../agents/AGENTS.md",
73
+ "skills_directory": "../agents/skills/",
74
+ "notes": "Managed by agents/setup-context.sh — do not edit manually"
75
+ }
76
+ EOF
77
+ echo -e " ${GREEN}✓${NC} .gemini/settings.json created (references agents/AGENTS.md)"
78
+ else
79
+ echo -e " ${YELLOW}!${NC} .gemini/settings.json already exists (skipped)"
80
+ fi
81
+
82
+ # Codex / OpenAI: .codex/AGENTS.md
83
+ if [ ! -d "${PROJECT_ROOT}/.codex" ]; then
84
+ mkdir -p "${PROJECT_ROOT}/.codex"
85
+ fi
86
+ if [ -L "${PROJECT_ROOT}/.codex/AGENTS.md" ]; then
87
+ rm "${PROJECT_ROOT}/.codex/AGENTS.md"
88
+ fi
89
+ if [ ! -f "${PROJECT_ROOT}/.codex/AGENTS.md" ]; then
90
+ # Relative path: from .codex/ to agents/AGENTS.md
91
+ ln -sf "../agents/AGENTS.md" "${PROJECT_ROOT}/.codex/AGENTS.md"
92
+ echo -e " ${GREEN}✓${NC} .codex/AGENTS.md -> ../agents/AGENTS.md"
93
+ else
94
+ echo -e " ${YELLOW}!${NC} .codex/AGENTS.md already exists (not a symlink — skipped)"
95
+ fi
96
+
97
+ # GitHub Copilot: .github/copilot-instructions.md
98
+ if [ ! -d "${PROJECT_ROOT}/.github" ]; then
99
+ mkdir -p "${PROJECT_ROOT}/.github"
100
+ fi
101
+ if [ -L "${PROJECT_ROOT}/.github/copilot-instructions.md" ]; then
102
+ rm "${PROJECT_ROOT}/.github/copilot-instructions.md"
103
+ fi
104
+ if [ ! -f "${PROJECT_ROOT}/.github/copilot-instructions.md" ]; then
105
+ # Relative path: from .github/ to agents/AGENTS.md
106
+ ln -sf "../agents/AGENTS.md" "${PROJECT_ROOT}/.github/copilot-instructions.md"
107
+ echo -e " ${GREEN}✓${NC} .github/copilot-instructions.md -> ../agents/AGENTS.md"
108
+ else
109
+ echo -e " ${YELLOW}!${NC} .github/copilot-instructions.md already exists (not a symlink — skipped)"
110
+ fi
111
+
112
+ echo ""
113
+
114
+ # ─────────────────────────────────────────────────────────────────────────────
115
+ # Step 2: Symlink agents/skills/ to tool-specific skill directories
116
+ # ─────────────────────────────────────────────────────────────────────────────
117
+ echo -e "${YELLOW}Step 2: Wiring skills directories${NC}"
118
+
119
+ # Claude Code: .claude/skills/
120
+ if [ ! -d "${PROJECT_ROOT}/.claude" ]; then
121
+ mkdir -p "${PROJECT_ROOT}/.claude"
122
+ fi
123
+ if [ -L "${PROJECT_ROOT}/.claude/skills" ]; then
124
+ rm "${PROJECT_ROOT}/.claude/skills"
125
+ fi
126
+ if [ ! -d "${PROJECT_ROOT}/.claude/skills" ]; then
127
+ # Relative path: from .claude/ to agents/skills/
128
+ ln -sf "../agents/skills" "${PROJECT_ROOT}/.claude/skills"
129
+ echo -e " ${GREEN}✓${NC} .claude/skills/ -> ../agents/skills/"
130
+ else
131
+ echo -e " ${YELLOW}!${NC} .claude/skills/ already exists (not a symlink — skipped)"
132
+ fi
133
+
134
+ # Antigravity / Gemini: .agent/skills/
135
+ if [ ! -d "${PROJECT_ROOT}/.agent" ]; then
136
+ mkdir -p "${PROJECT_ROOT}/.agent"
137
+ fi
138
+ if [ -L "${PROJECT_ROOT}/.agent/skills" ]; then
139
+ rm "${PROJECT_ROOT}/.agent/skills"
140
+ fi
141
+ if [ ! -d "${PROJECT_ROOT}/.agent/skills" ]; then
142
+ # Relative path: from .agent/ to agents/skills/
143
+ ln -sf "../agents/skills" "${PROJECT_ROOT}/.agent/skills"
144
+ echo -e " ${GREEN}✓${NC} .agent/skills/ -> ../agents/skills/"
145
+ else
146
+ echo -e " ${YELLOW}!${NC} .agent/skills/ already exists (not a symlink — skipped)"
147
+ fi
148
+
149
+ # Cursor and VS Code: Compile skills
150
+ if [ -f "${AGENTS_DIR}/scripts/compile_skills.py" ]; then
151
+ echo -e "${YELLOW}Compiling skills for Cursor and VS Code...${NC}"
152
+
153
+ # Cursor
154
+ python3 "${AGENTS_DIR}/scripts/compile_skills.py" \
155
+ --platform "Cursor" \
156
+ --skills-dir "${AGENTS_DIR}/skills" \
157
+ --target-dir "${PROJECT_ROOT}/.cursor/rules" \
158
+ --project-root "${PROJECT_ROOT}"
159
+
160
+ # VS Code / Copilot
161
+ python3 "${AGENTS_DIR}/scripts/compile_skills.py" \
162
+ --platform "VS Code" \
163
+ --skills-dir "${AGENTS_DIR}/skills" \
164
+ --target-dir "${PROJECT_ROOT}/.github/skills" \
165
+ --project-root "${PROJECT_ROOT}"
166
+ else
167
+ echo -e "${RED}x Warning: compile_skills.py not found. Skipping Cursor/VS Code skill generation.${NC}"
168
+ fi
169
+
170
+ echo ""
171
+
172
+ # ─────────────────────────────────────────────────────────────────────────────
173
+ # Step 3: Create agents/memory/ directory structure
174
+ # ─────────────────────────────────────────────────────────────────────────────
175
+ echo -e "${YELLOW}Step 3: Initializing agents/memory/ directory structure${NC}"
176
+
177
+ MEMORY_DIR="${AGENTS_DIR}/memory"
178
+ mkdir -p "${MEMORY_DIR}/episodic/SESSION_SNAPSHOT"
179
+ mkdir -p "${MEMORY_DIR}/semantic"
180
+ echo -e " ${GREEN}✓${NC} agents/memory/episodic/SESSION_SNAPSHOT/ created"
181
+ echo -e " ${GREEN}✓${NC} agents/memory/semantic/ created"
182
+
183
+ echo ""
184
+
185
+ # ─────────────────────────────────────────────────────────────────────────────
186
+ # Step 4: Initialize starter memory files (if not already present)
187
+ # ─────────────────────────────────────────────────────────────────────────────
188
+ echo -e "${YELLOW}Step 4: Initializing memory files${NC}"
189
+
190
+ # PROJECT_STATE.md
191
+ if [ ! -f "${MEMORY_DIR}/PROJECT_STATE.md" ]; then
192
+ cat > "${MEMORY_DIR}/PROJECT_STATE.md" << 'EOF'
193
+ # PROJECT_STATE.md — Master Project State
194
+
195
+ > Updated by: sdlc-checkpoint.skill
196
+ > Read by: session-resume.skill, loki-mode.skill
197
+
198
+ ## Current SDLC Phase
199
+
200
+ ```
201
+ Phase: S00_INITIALIZED
202
+ Status: NOT_STARTED
203
+ Last checkpoint: [DATE]
204
+ Last checkpoint by: [agent/human]
205
+ ```
206
+
207
+ ## SDLC Progress
208
+
209
+ | Phase | Status | Started | Completed | Gate Criteria Met |
210
+ |---|---|---|---|---|
211
+ | S01 Requirements | NOT_STARTED | — | — | — |
212
+ | S02 Design | NOT_STARTED | — | — | — |
213
+ | S03 Specification | NOT_STARTED | — | — | — |
214
+ | S04 Tasks | NOT_STARTED | — | — | — |
215
+ | S05 Implementation | NOT_STARTED | — | — | — |
216
+ | S06 Testing | NOT_STARTED | — | — | — |
217
+ | S07 Security | NOT_STARTED | — | — | — |
218
+ | S08 Review | NOT_STARTED | — | — | — |
219
+ | S09 Staging | NOT_STARTED | — | — | — |
220
+ | S10 Production | NOT_STARTED | — | — | — |
221
+
222
+ ## Current Blockers
223
+
224
+ _None yet_
225
+
226
+ ## Next Actions
227
+
228
+ 1. Fill in AGENTS.md placeholders for this project
229
+ 2. Run spec-writer.skill to create initial PRD.md
230
+
231
+ ## Open Human Decisions
232
+
233
+ _None pending_
234
+
235
+ ## Last Test Status
236
+
237
+ ```
238
+ Last run: never
239
+ Pass: — Fail: — Skip: —
240
+ Coverage: —
241
+ ```
242
+
243
+ ## Key Artifacts
244
+
245
+ ```
246
+ PRD.md: does not exist
247
+ SPEC.md: does not exist
248
+ PLAN.md: does not exist
249
+ project/TASKS.md: does not exist
250
+ ```
251
+ EOF
252
+ echo -e " ${GREEN}✓${NC} agents/memory/PROJECT_STATE.md initialized"
253
+ else
254
+ echo -e " ${YELLOW}!${NC} agents/memory/PROJECT_STATE.md already exists (skipped)"
255
+ fi
256
+
257
+ # AUDIT_LOG.md
258
+ if [ ! -f "${MEMORY_DIR}/AUDIT_LOG.md" ]; then
259
+ cat > "${MEMORY_DIR}/AUDIT_LOG.md" << 'EOF'
260
+ # AUDIT_LOG.md — Project Audit Trail
261
+
262
+ > APPEND ONLY — never delete or modify existing entries.
263
+ > Updated by: audit-trail.skill
264
+ > Read by: session-resume.skill (last 50 entries), integrity-check.skill
265
+
266
+ ## Log Format
267
+
268
+ | Timestamp | Session | Agent/Human | Action Type | Description | Outcome | References |
269
+ |---|---|---|---|---|---|---|
270
+
271
+ ## Action Types
272
+ - DECISION — a choice was made between options
273
+ - PHASE_TRANSITION — SDLC phase changed
274
+ - TASK_DONE — a task was completed
275
+ - TASK_BLOCKED — a task is stuck, human needed
276
+ - QUALITY_GATE — gate pass/fail result
277
+ - SECURITY_FINDING — security issue found
278
+ - ADR_CREATED — architecture decision recorded
279
+ - HUMAN_ESCALATION — agent escalated to human
280
+ - SELF_HEAL_ATTEMPT — agent tried to fix itself
281
+ - RESEARCH_FINDING — authoritative source found
282
+ - ERROR — unexpected error encountered
283
+ - ROLLBACK — change was reverted
284
+
285
+ ## Log Entries
286
+
287
+ | Timestamp | Session | Agent/Human | Action Type | Description | Outcome | References |
288
+ |---|---|---|---|---|---|---|
289
+ | INIT | S00 | setup-context.sh | PHASE_TRANSITION | Kit initialized | SUCCESS | README_FULL.md |
290
+
291
+ EOF
292
+ echo -e " ${GREEN}✓${NC} agents/memory/AUDIT_LOG.md initialized"
293
+ else
294
+ echo -e " ${YELLOW}!${NC} agents/memory/AUDIT_LOG.md already exists (skipped)"
295
+ fi
296
+
297
+ # CONTINUITY.md
298
+ if [ ! -f "${MEMORY_DIR}/CONTINUITY.md" ]; then
299
+ cat > "${MEMORY_DIR}/CONTINUITY.md" << 'EOF'
300
+ # CONTINUITY.md — Project Memory: Past Failures & Lessons
301
+
302
+ > Read this at the START of every RARV Reason phase.
303
+ > Prevents repeating failed approaches across sessions.
304
+ > Updated by: self-heal.skill (on escalation), audit-trail.skill
305
+
306
+ ## How to Add Entries
307
+
308
+ When an approach fails after multiple attempts, add an entry:
309
+
310
+ ```markdown
311
+ ### [DATE] — [Brief title of the failure]
312
+ **Context:** What were you trying to do?
313
+ **Approach tried:** What did you try?
314
+ **Why it failed:** Root cause
315
+ **Resolution:** What actually worked (or "unresolved — awaiting human decision")
316
+ **Tags:** [library-conflict | type-error | test-failure | architecture | security | performance]
317
+ ```
318
+
319
+ ## Past Failures & Lessons
320
+
321
+ _No entries yet. Entries are added automatically by self-heal.skill on escalation._
322
+
323
+ EOF
324
+ echo -e " ${GREEN}✓${NC} agents/memory/CONTINUITY.md initialized"
325
+ else
326
+ echo -e " ${YELLOW}!${NC} agents/memory/CONTINUITY.md already exists (skipped)"
327
+ fi
328
+
329
+ echo ""
330
+
331
+ # ─────────────────────────────────────────────────────────────────────────────
332
+ # Step 5: Update .gitignore
333
+ # ─────────────────────────────────────────────────────────────────────────────
334
+ echo -e "${YELLOW}Step 5: Updating .gitignore${NC}"
335
+
336
+ GITIGNORE="${PROJECT_ROOT}/.gitignore"
337
+
338
+ add_to_gitignore() {
339
+ local entry="$1"
340
+ local comment="$2"
341
+ if ! grep -qF "$entry" "$GITIGNORE" 2>/dev/null; then
342
+ echo "" >> "$GITIGNORE"
343
+ echo "# $comment" >> "$GITIGNORE"
344
+ echo "$entry" >> "$GITIGNORE"
345
+ echo -e " ${GREEN}✓${NC} Added $entry to .gitignore"
346
+ else
347
+ echo -e " ${YELLOW}!${NC} $entry already in .gitignore (skipped)"
348
+ fi
349
+ }
350
+
351
+ # Create .gitignore if it doesn't exist
352
+ if [ ! -f "$GITIGNORE" ]; then
353
+ touch "$GITIGNORE"
354
+ echo -e " ${GREEN}✓${NC} Created .gitignore"
355
+ fi
356
+
357
+ add_to_gitignore ".env" "Environment secrets"
358
+ add_to_gitignore ".env.local" "Local environment overrides"
359
+ add_to_gitignore ".env.*.local" "Environment-specific local overrides"
360
+
361
+ # Note: we do NOT gitignore agents/memory/ — project memory should be committed
362
+ # to preserve continuity across team members and CI/CD environments.
363
+ # Individual developers may add local-only entries to .git/info/exclude.
364
+
365
+ echo ""
366
+
367
+ # ─────────────────────────────────────────────────────────────────────────────
368
+ # Optional: Global skills symlink (for cross-project availability)
369
+ # ─────────────────────────────────────────────────────────────────────────────
370
+ echo -e "${YELLOW}Optional: Global skills setup${NC}"
371
+ echo -e " To make these skills available globally across all projects, run:"
372
+ echo -e " ${BLUE}mkdir -p ~/.claude/skills && ln -sf ${AGENTS_DIR}/skills/* ~/.claude/skills/${NC}"
373
+ echo -e " Or for Gemini/Antigravity:"
374
+ echo -e " ${BLUE}mkdir -p ~/.agent/skills && ln -sf ${AGENTS_DIR}/skills/* ~/.agent/skills/${NC}"
375
+ echo ""
376
+
377
+ # ─────────────────────────────────────────────────────────────────────────────
378
+ # Done
379
+ # ─────────────────────────────────────────────────────────────────────────────
380
+ echo -e "${GREEN}======================================${NC}"
381
+ echo -e "${GREEN} Context Unification Complete! ${NC}"
382
+ echo -e "${GREEN}======================================${NC}"
383
+ echo ""
384
+ echo -e "Kit is ready. Next steps:"
385
+ echo -e " 1. ${BLUE}Fill in AGENTS.md placeholders${NC} for your project"
386
+ echo -e " 2. ${BLUE}Adapt CONSTITUTION.md${NC} — keep universal articles, add project-specific ones"
387
+ echo -e " 3. Tell your AI agent: ${BLUE}\"Read AGENTS.md and start with spec-writer skill\"${NC}"
388
+ echo ""
389
+ echo -e "Files created/linked:"
390
+ echo -e " .claude/CLAUDE.md -> agents/AGENTS.md"
391
+ echo -e " .cursorrules -> agents/AGENTS.md"
392
+ echo -e " .codex/AGENTS.md -> agents/AGENTS.md"
393
+ echo -e " .github/copilot-instructions.md -> agents/AGENTS.md"
394
+ echo -e " .gemini/settings.json (references agents/AGENTS.md)"
395
+ echo -e " .claude/skills/ -> agents/skills/"
396
+ echo -e " .agent/skills/ -> agents/skills/"
397
+ echo -e " agents/memory/ (initialized)"
398
+ echo ""