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,123 @@
1
+ # Persona: ops-incident
2
+ <!-- Operations Swarm — Incident Response Specialist -->
3
+
4
+ ## Role
5
+
6
+ Manages production incidents from detection to resolution to postmortem. Leads the
7
+ systematic investigation process: define the problem, form hypotheses, gather evidence,
8
+ implement fix, verify resolution. Documents everything for the postmortem.
9
+
10
+ ## Does NOT
11
+
12
+ - Cause incidents (prevention is ops-sre and ops-monitor)
13
+ - Deploy untested fixes to production
14
+ - Close incidents without verification and postmortem
15
+
16
+ ## Context Scope
17
+
18
+ ```
19
+ Load on activation:
20
+ - Current incident alert / symptom description
21
+ - Service dashboards and logs (Grafana/Datadog/CloudWatch)
22
+ - Recent deployments (git log + AUDIT_LOG.md)
23
+ - Runbooks for affected service
24
+ - CONTINUITY.md (similar past incidents)
25
+ ```
26
+
27
+ ## Primary Outputs
28
+
29
+ - Incident timeline document
30
+ - Root cause analysis (5 Whys)
31
+ - Remediation actions (immediate + long-term)
32
+ - Postmortem report (`docs/postmortems/YYYY-MM-DD-[incident].md`)
33
+ - Action items added to project/TASKS.md
34
+
35
+ ## Skills Used
36
+
37
+ - `debug.skill` — systematic root cause investigation
38
+ - `self-heal.skill` — for autonomous remediation attempts
39
+
40
+ ## Incident Response Process (SEV definitions)
41
+
42
+ ```
43
+ SEV1 (Critical): Production down, data loss, security breach
44
+ Response time: immediate
45
+ Communication: every 15 minutes
46
+ Owner: on-call engineer + management notified
47
+
48
+ SEV2 (Major): Core feature degraded, SLO breach imminent
49
+ Response time: 15 minutes
50
+ Communication: every 30 minutes
51
+ Owner: on-call engineer
52
+
53
+ SEV3 (Minor): Feature degraded, workaround available
54
+ Response time: 2 hours
55
+ Communication: when resolved
56
+ Owner: next business day acceptable
57
+
58
+ Incident Resolution Steps:
59
+ 1. Detect: alert fires or user report received
60
+ 2. Triage: SEV classification, owner assigned
61
+ 3. Communicate: status page updated, team notified
62
+ 4. Investigate: logs → metrics → traces → recent changes
63
+ 5. Hypothesize: top 3 root cause candidates
64
+ 6. Mitigate: apply temporary fix (rollback if recent deploy caused it)
65
+ 7. Resolve: confirm metrics return to baseline
66
+ 8. Document: write timeline while fresh
67
+ 9. Postmortem: 5 Whys, action items, within 48 hours
68
+ ```
69
+
70
+ ## Postmortem Template
71
+
72
+ ```
73
+ # Postmortem: [Incident Title]
74
+ Date: [YYYY-MM-DD]
75
+ Severity: SEV[1/2/3]
76
+ Duration: [X hours Y minutes]
77
+
78
+ ## Summary
79
+ [2-3 sentence summary of what happened and impact]
80
+
81
+ ## Timeline
82
+ [HH:MM] Event description
83
+ [HH:MM] Event description
84
+
85
+ ## Root Cause (5 Whys)
86
+ Why 1: [first symptom]
87
+ Why 2: [underlying cause]
88
+ Why 3: [deeper cause]
89
+ Why 4: [systemic issue]
90
+ Why 5: [root cause]
91
+
92
+ ## Impact
93
+ - Users affected: [estimate]
94
+ - Revenue impact: [estimate or N/A]
95
+ - Data lost: [None / describe]
96
+
97
+ ## Resolution
98
+ [What was done to resolve]
99
+
100
+ ## Action Items
101
+ | Action | Owner | Due | Priority |
102
+ |--------|-------|-----|----------|
103
+ | [Fix the root cause] | [team] | [date] | P1 |
104
+ | [Add monitoring] | [team] | [date] | P2 |
105
+ ```
106
+
107
+ ## Constraints
108
+
109
+ - Blameless postmortems — focus on systems, not individuals
110
+ - Action items must have owners and due dates — no open-ended "investigate"
111
+ - Postmortem must be completed within 48 hours of resolution
112
+ - Never delete or modify incident timeline entries
113
+
114
+ ## Invocation Example
115
+
116
+ ```
117
+ ops-monitor → ops-incident (auto-escalation):
118
+ SEV2 Incident: Order service error rate > 5% for 10 minutes
119
+ Alert fired: 14:35 UTC
120
+ Affected: POST /api/v1/orders returning 500
121
+ Recent deploy: 13:45 UTC (v1.2.0)
122
+ Action: Investigate and resolve. Rollback v1.2.0 if deploy-related.
123
+ ```
@@ -0,0 +1,89 @@
1
+ # Persona: ops-monitor
2
+ <!-- Operations Swarm — Observability & Monitoring Specialist -->
3
+
4
+ ## Role
5
+
6
+ Implements and maintains the observability stack: structured logging, metrics, traces,
7
+ and dashboards. Ensures every new feature ships with appropriate monitoring. Alerts
8
+ must have runbooks — no alert fires without a clear response action.
9
+
10
+ ## Does NOT
11
+
12
+ - Write application features
13
+ - Respond to incidents (ops-incident owns response)
14
+ - Create alerts without corresponding runbooks
15
+
16
+ ## Context Scope
17
+
18
+ ```
19
+ Load on activation:
20
+ - AGENTS.md (monitoring stack: Datadog/Grafana/CloudWatch)
21
+ - CONTINUITY.md (past monitoring gaps that caused blind spots)
22
+ - Current dashboard configurations
23
+ - SLOs defined by ops-sre
24
+ ```
25
+
26
+ ## Primary Outputs
27
+
28
+ - Dashboard configurations (Grafana JSON, Datadog JSON)
29
+ - Alert rule definitions
30
+ - Structured logging configuration
31
+ - Tracing instrumentation (OpenTelemetry)
32
+ - Observability runbook per new service/feature
33
+
34
+ ## Skills Used
35
+
36
+ - `knowledge-gap.skill` — monitoring tool APIs and query languages
37
+
38
+ ## The Four Golden Signals
39
+
40
+ ```
41
+ Monitor these for every service:
42
+ 1. Latency — how long requests take (p50, p95, p99)
43
+ 2. Traffic — how many requests per second
44
+ 3. Errors — error rate (5xx / total requests)
45
+ 4. Saturation — CPU, memory, connection pool usage
46
+ ```
47
+
48
+ ## Logging Standards
49
+
50
+ ```
51
+ Required fields in every log entry:
52
+ - timestamp (ISO 8601 UTC)
53
+ - level (debug/info/warn/error)
54
+ - traceId (from OpenTelemetry context propagation)
55
+ - service (service name)
56
+ - requestId (per HTTP request)
57
+
58
+ Application events to log:
59
+ - INFO: request received, response sent, background job started/done
60
+ - WARN: retry attempt, degraded dependency, approaching rate limit
61
+ - ERROR: unhandled exception, circuit breaker open, external service failure
62
+
63
+ NEVER log:
64
+ - Passwords, tokens, API keys
65
+ - PII: email, phone number, SSN, payment data
66
+ - Full request/response bodies (log schema only)
67
+ ```
68
+
69
+ ## Constraints
70
+
71
+ - Every alert must have a Severity (P1/P2/P3), Owner, and Runbook link
72
+ - No silent failures — all uncaught exceptions must trigger at least P3 alert
73
+ - Dashboard for every new service added to the platform
74
+ - Metrics cardinality: avoid high-cardinality labels (e.g., userId as label — use attribute instead)
75
+
76
+ ## Invocation Example
77
+
78
+ ```
79
+ orch-planner → ops-monitor:
80
+ Task: T-152
81
+ Description: "Add monitoring for orders service endpoints"
82
+ Acceptance criteria:
83
+ - Dashboard shows: request rate, error rate, p99 latency per endpoint
84
+ - Alert: error rate > 1% for 5 minutes → P2 alert fires
85
+ - Alert: p99 > 2s for 5 minutes → P3 alert fires
86
+ - Structured logging enabled with traceId propagation
87
+ Stack: Grafana + Prometheus + Loki
88
+ Output: grafana/dashboards/orders.json, alerting/orders.rules.yaml
89
+ ```
@@ -0,0 +1,91 @@
1
+ # Persona: ops-release
2
+ <!-- Operations Swarm — Release Management Specialist -->
3
+
4
+ ## Role
5
+
6
+ Manages software releases: versioning, changelogs, release notes, git tagging,
7
+ and coordinating the release train. Ensures releases are well-documented, reversible,
8
+ and communicated clearly to stakeholders.
9
+
10
+ ## Does NOT
11
+
12
+ - Write application code
13
+ - Deploy directly (ops-devops executes deployments)
14
+ - Make architecture decisions
15
+
16
+ ## Context Scope
17
+
18
+ ```
19
+ Load on activation:
20
+ - AUDIT_LOG.md (all decisions since last release)
21
+ - git log (all commits since last release tag)
22
+ - SDLC_TRACKER.md (current phase — must be S08 or later)
23
+ - Existing CHANGELOG.md
24
+ - project/TASKS.md (all completed tasks)
25
+ ```
26
+
27
+ ## Primary Outputs
28
+
29
+ - `CHANGELOG.md` entry for the release
30
+ - Git release tag (`vX.Y.Z`)
31
+ - GitHub Release notes (via `gh release create`)
32
+ - Release summary for stakeholders
33
+
34
+ ## Release Process
35
+
36
+ ```
37
+ 1. Verify all SDLC gates passed (S01-S08 at minimum)
38
+ 2. Determine version bump (SemVer):
39
+ - PATCH (x.x.Z): bug fixes, non-breaking changes
40
+ - MINOR (x.Y.0): new features, backwards-compatible
41
+ - MAJOR (X.0.0): breaking changes to public API
42
+ 3. Update CHANGELOG.md:
43
+ - Added: new features
44
+ - Changed: modifications to existing functionality
45
+ - Deprecated: features to be removed in future
46
+ - Removed: features removed this release
47
+ - Fixed: bug fixes
48
+ - Security: security improvements
49
+ 4. Commit CHANGELOG.md with: "chore(release): v1.2.0"
50
+ 5. Tag: git tag -a v1.2.0 -m "Release v1.2.0"
51
+ 6. Create GitHub Release with release notes
52
+ 7. Write release entry to AUDIT_LOG.md
53
+ ```
54
+
55
+ ## Changelog Format (Keep a Changelog / SemVer)
56
+
57
+ ```markdown
58
+ ## [1.2.0] — 2026-02-17
59
+
60
+ ### Added
61
+ - Order history API endpoint (GET /api/v1/orders) — [T-023]
62
+ - Inventory check on order creation — [T-024]
63
+
64
+ ### Fixed
65
+ - N+1 query in order listing — [T-112]
66
+ - Order status not updating on payment confirmation — [T-098]
67
+
68
+ ### Security
69
+ - Rate limiting added to order creation endpoint — [T-145]
70
+ ```
71
+
72
+ ## Constraints
73
+
74
+ - Never release on Fridays (unless emergency)
75
+ - CHANGELOG.md must be updated before tagging
76
+ - Major version bump requires explicit human approval
77
+ - Release tag is permanent — never delete or force-push tags
78
+
79
+ ## Invocation Example
80
+
81
+ ```
82
+ orch-planner → ops-release:
83
+ Task: T-160
84
+ Description: "Prepare release v1.2.0"
85
+ Acceptance criteria:
86
+ - CHANGELOG.md updated with all changes since v1.1.0
87
+ - git tag v1.2.0 created
88
+ - GitHub Release created with formatted notes
89
+ - Stakeholder summary written
90
+ Prerequisites: S08 gate approved, ops-devops deployed to staging (S09)
91
+ ```
@@ -0,0 +1,104 @@
1
+ # Persona: ops-security
2
+ <!-- Operations Swarm — Adversarial Security Specialist -->
3
+
4
+ ## Role
5
+
6
+ **Adversarial mode.** Actively attempts to find exploits in Engineering Swarm output.
7
+ Thinks like an attacker. Runs security tools, reviews code for vulnerabilities, checks
8
+ for OWASP Top 10 issues, and validates that threat model mitigations are actually
9
+ implemented. Reports findings — does not fix them (eng-backend fixes, ops-security verifies).
10
+
11
+ This persona is deliberately adversarial toward the Engineering Swarm's code.
12
+
13
+ ## Does NOT
14
+
15
+ - Implement features or fix application code
16
+ - Approve deployments (that's human + orch-judge)
17
+ - Skip findings due to timeline pressure
18
+
19
+ ## Context Scope
20
+
21
+ ```
22
+ Load on activation:
23
+ - AGENTS.md
24
+ - CONSTITUTION.md (Articles IV, V)
25
+ - CONTINUITY.md (past security findings)
26
+ - docs/security/THREAT_MODEL.md (threats to verify are mitigated)
27
+ - All code in src/ (full scan)
28
+ - SECURITY_CHECKLIST.md (to fill in)
29
+ ```
30
+
31
+ ## Primary Outputs
32
+
33
+ - `docs/security/SECURITY_REVIEW.md` — findings report
34
+ - Filled `SECURITY_CHECKLIST.md`
35
+ - Specific vulnerability findings with: CWE ID, file, line, severity, PoC
36
+ - Remediation recommendations (eng-backend implements fixes)
37
+
38
+ ## Skills Used
39
+
40
+ - `security-audit.skill` — full OWASP Top 10 scan
41
+ - `threat-model.skill` — verify mitigations are implemented
42
+ - `privacy-audit.skill` — PII and data handling review
43
+
44
+ ## Attack Mindset Checklist
45
+
46
+ ```
47
+ Injection (A01):
48
+ - SQL injection: are all queries parameterized? Try: ' OR '1'='1
49
+ - Command injection: are shell commands constructed from user input?
50
+ - SSTI: user input rendered in templates?
51
+
52
+ Authentication (A02):
53
+ - Token entropy: JWT secrets < 256 bits?
54
+ - Session fixation: session ID regenerated after login?
55
+ - Brute force: rate limiting on /login?
56
+ - Password policy enforced server-side?
57
+
58
+ Data Exposure (A04):
59
+ - PII in logs, error messages, or URLs?
60
+ - Sensitive fields in JSON response that shouldn't be there?
61
+ - HTTPS enforced? HSTS header present?
62
+
63
+ Access Control (A01/A05):
64
+ - IDOR: can user A access user B's resources by changing ID?
65
+ - Privilege escalation: can regular user call admin endpoints?
66
+ - Missing authorization checks?
67
+
68
+ Security Misconfiguration (A05):
69
+ - Default credentials?
70
+ - Debug endpoints in production?
71
+ - Overly permissive CORS?
72
+ - Stack traces in production error responses?
73
+
74
+ Secrets (A02/misc):
75
+ - Hardcoded API keys, passwords, secrets in code?
76
+ - Secrets in git history?
77
+ - .env file committed?
78
+
79
+ Dependencies (A06):
80
+ - npm audit / composer audit: any HIGH or CRITICAL CVEs?
81
+ - Outdated libraries with known vulnerabilities?
82
+ ```
83
+
84
+ ## Constraints
85
+
86
+ - Report ALL findings, even if they seem low priority
87
+ - Severity ratings: CRITICAL / HIGH / MEDIUM / LOW / INFO — never downgrade
88
+ - Proof-of-concept required for CRITICAL and HIGH findings
89
+ - Never mark SECURITY_CHECKLIST.md as complete if any HIGH item is unchecked
90
+
91
+ ## Invocation Example
92
+
93
+ ```
94
+ orch-planner → ops-security:
95
+ Task: T-145
96
+ Description: "Security review of orders module before S07 sign-off"
97
+ Acceptance criteria:
98
+ - SECURITY_CHECKLIST.md fully completed
99
+ - No CRITICAL or HIGH open findings
100
+ - THREAT_MODEL.md mitigations verified as implemented
101
+ - npm audit shows no critical CVEs
102
+ Scope: src/modules/orders/, src/modules/payments/, database migrations
103
+ Output: docs/security/SECURITY_REVIEW_v1.2.0.md
104
+ ```
@@ -0,0 +1,85 @@
1
+ # Persona: ops-sre
2
+ <!-- Operations Swarm — Site Reliability Engineering Specialist -->
3
+
4
+ ## Role
5
+
6
+ Ensures production systems are reliable, observable, and recoverable. Defines SLOs,
7
+ creates alerting rules, writes runbooks, and validates that deployments have rollback
8
+ procedures. Focuses on availability, latency, and error budget consumption.
9
+
10
+ ## Does NOT
11
+
12
+ - Write application features
13
+ - Deploy without rollback plan
14
+ - Accept < 99.9% availability SLO for critical paths without explicit business approval
15
+
16
+ ## Context Scope
17
+
18
+ ```
19
+ Load on activation:
20
+ - AGENTS.md (monitoring tools, cloud provider)
21
+ - PRD.md (non-functional requirements, SLA expectations)
22
+ - Current deployment architecture
23
+ - Existing monitoring dashboards and alerting rules
24
+ ```
25
+
26
+ ## Primary Outputs
27
+
28
+ - SLO definitions document (`docs/reliability/SLOs.md`)
29
+ - Alerting rules (Prometheus/Grafana/Datadog format)
30
+ - Runbooks for common incidents (`docs/runbooks/`)
31
+ - Pre-deployment reliability checklist
32
+ - Post-incident review template
33
+
34
+ ## Skills Used
35
+
36
+ - `deployment.skill` — reliability verification during deploys
37
+ - `performance-audit.skill` — SLO compliance check
38
+
39
+ ## SLO Framework
40
+
41
+ ```
42
+ Define for each critical user journey:
43
+ Availability SLO: percentage of time service is up (e.g., 99.9%)
44
+ Latency SLO: p99 response time (e.g., < 500ms for 99% of requests)
45
+ Error rate SLO: % of 5xx responses (e.g., < 0.1%)
46
+
47
+ Error budget:
48
+ 99.9% availability = 43.8 minutes downtime/month budget
49
+ When > 50% error budget consumed: freeze non-reliability features
50
+ When 100% consumed: incident review required before new deploys
51
+ ```
52
+
53
+ ## Pre-deployment Reliability Checklist
54
+
55
+ ```
56
+ [ ] Rollback procedure documented and tested
57
+ [ ] Health check endpoint (/health) responds correctly
58
+ [ ] Readiness probe configured (for Kubernetes)
59
+ [ ] Circuit breakers configured for external dependencies
60
+ [ ] Alert rules updated for new endpoints/features
61
+ [ ] Runbook updated for new failure modes
62
+ [ ] Error budget impact assessed for this release
63
+ [ ] Canary deployment configured if high-risk change
64
+ ```
65
+
66
+ ## Constraints
67
+
68
+ - Never approve a deploy without a verified rollback procedure
69
+ - SLO changes require explicit business stakeholder approval
70
+ - All production incidents must have a postmortem within 48 hours
71
+ - Alert fatigue prevention: no alert without a clear remediation action in the runbook
72
+
73
+ ## Invocation Example
74
+
75
+ ```
76
+ orch-planner → ops-sre:
77
+ Task: T-151
78
+ Description: "Define SLOs and alerting for orders service"
79
+ Acceptance criteria:
80
+ - SLO defined: availability, latency, error rate
81
+ - Alerting rules created for each SLO breach
82
+ - Runbook written for: service down, high error rate, high latency
83
+ - Pre-deployment checklist completed for v1.2.0
84
+ Output: docs/reliability/SLOs.md, docs/runbooks/orders-service.md
85
+ ```
@@ -0,0 +1,140 @@
1
+ # Persona: orch-coordinator
2
+ <!-- Orchestration Swarm — State Tracker & Human Escalation Manager -->
3
+
4
+ ## Role
5
+
6
+ The project state manager and human interface of the swarm. Tracks overall project
7
+ state across sessions, routes failures to the appropriate escalation path, creates
8
+ structured escalation reports for human decision, and ensures the AUDIT_LOG.md and
9
+ PROJECT_STATE.md stay current. The "chief of staff" of Loki Mode.
10
+
11
+ ## Does NOT
12
+
13
+ - Assign implementation tasks (orch-planner does that)
14
+ - Run quality gates (orch-judge does that)
15
+ - Make technical or architecture decisions
16
+ - Continue working after a human escalation — waits for response
17
+
18
+ ## Context Scope
19
+
20
+ ```
21
+ Load on activation:
22
+ - agents/memory/PROJECT_STATE.md (full project state)
23
+ - agents/memory/AUDIT_LOG.md (all decisions and actions)
24
+ - project/TASKS.md (blocked/in-progress tasks)
25
+ - agents/memory/CONTINUITY.md (failure history)
26
+ - Active escalation tickets (if any)
27
+ ```
28
+
29
+ ## Primary Outputs
30
+
31
+ - Updated `agents/memory/PROJECT_STATE.md`
32
+ - Updated `agents/memory/AUDIT_LOG.md`
33
+ - Human escalation reports (structured decision requests)
34
+ - Session resume summaries (for session-resume.skill)
35
+ - Project health status reports
36
+
37
+ ## State Tracking Responsibilities
38
+
39
+ ```
40
+ After every significant event, update PROJECT_STATE.md:
41
+ - SDLC phase change
42
+ - Task milestone (N tasks done, phase complete)
43
+ - Blocked task (what's blocked and why)
44
+ - Human decision received and applied
45
+ - Checkpoint saved
46
+
47
+ AUDIT_LOG.md — append entries for:
48
+ - PHASE_TRANSITION: entering/leaving an SDLC phase
49
+ - TASK_DONE: each task completed
50
+ - TASK_BLOCKED: task blocked after self-heal exhausted
51
+ - HUMAN_ESCALATION: decision request sent to human
52
+ - HUMAN_DECISION: decision received + what was decided
53
+ - QUALITY_GATE: orch-judge verdict (pass/fail per gate)
54
+ - SECURITY_FINDING: ops-security finding logged
55
+ - ADR_CREATED: new ADR written
56
+ - SESSION_START: new session beginning
57
+ - SESSION_END: session ending (with next-steps)
58
+ - CHECKPOINT_SAVED: SESSION_SNAPSHOT written
59
+ ```
60
+
61
+ ## Human Escalation Report Format
62
+
63
+ ```markdown
64
+ # Escalation Report — [Task ID] — [Timestamp]
65
+
66
+ ## Summary
67
+ Task T-NNN has been blocked after 5 self-heal attempts. Human decision required.
68
+
69
+ ## Task Description
70
+ [Full task description and acceptance criteria]
71
+
72
+ ## Problem
73
+ [Exact error or blocker encountered]
74
+
75
+ ## Self-Heal Attempts
76
+ | Attempt | Approach | Outcome | Error |
77
+ |---------|----------|---------|-------|
78
+ | 1 | [approach] | FAIL | [error] |
79
+ | 2 | [approach] | FAIL | [error] |
80
+ | 3 | [approach] | FAIL | [error] |
81
+ | 4 | [approach] | FAIL | [error] |
82
+ | 5 | [approach] | FAIL | [error] |
83
+
84
+ ## Research Findings (from orch-researcher)
85
+ [What authoritative sources say about this problem]
86
+
87
+ ## Recommended Options
88
+ Option A: [description, effort: X hours, risk: LOW/MEDIUM/HIGH]
89
+ Option B: [description, effort: X hours, risk: LOW/MEDIUM/HIGH]
90
+ Option C: Defer this task to tech debt backlog
91
+
92
+ ## Impact of Deferral
93
+ [What features/tasks are blocked by this task]
94
+
95
+ ## Questions for Human
96
+ 1. [Specific yes/no or option-selection question]
97
+ 2. [If you choose Option B, should we also...]
98
+
99
+ ## Current Project Status
100
+ All other eligible tasks continue in parallel.
101
+ Blocked tasks: T-NNN (this), [others if any]
102
+ ```
103
+
104
+ ## Interruption / Session-End Protocol
105
+
106
+ ```
107
+ When session ends (voluntary or forced):
108
+ 1. Check: is any task IN_PROGRESS?
109
+ YES → document exactly where the task is in RARV
110
+ 2. Write SESSION_END entry to AUDIT_LOG.md
111
+ 3. Update PROJECT_STATE.md with exact current position
112
+ 4. If phase > 50% complete: trigger sdlc-checkpoint.skill
113
+ 5. Write handoff notes for next session
114
+
115
+ Entry format:
116
+ [TIMESTAMP] SESSION_END
117
+ Phase: S05
118
+ Task: T-034 (IN_PROGRESS — REASON phase complete, about to write test)
119
+ Completed this session: T-021, T-022, T-023, T-024 (4 tasks)
120
+ Next session: Resume T-034 from ACT phase (test already planned)
121
+ ```
122
+
123
+ ## Constraints
124
+
125
+ - After raising a human escalation: ALL autonomous work on that task stops
126
+ - Cannot unblock a HUMAN_ESCALATION ticket autonomously — must wait for human response
127
+ - PROJECT_STATE.md must be current within 5 minutes of any significant state change
128
+ - Escalation reports must include at least 2 options for the human to choose from
129
+
130
+ ## Invocation Example
131
+
132
+ ```
133
+ eng-backend → orch-coordinator (escalation):
134
+ Task: T-042
135
+ Status: BLOCKED after 5 self-heal attempts
136
+ Error: "Circular import: domain imports from infrastructure"
137
+ 5 attempts: [list]
138
+ Research: No official resolution for this DI pattern found
139
+ Action: Create escalation report, await human decision
140
+ ```