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,59 @@
1
+ ---
2
+ name: design-patterns
3
+ description: Identifies, implements, and refactors code using standard Design Patterns (GoF + Modern).
4
+ triggers: [design pattern, refactor pattern, strategy pattern, observer pattern, factory pattern, singleton]
5
+ tags: [architecture]
6
+ context_cost: low
7
+ ---
8
+ # Design Patterns Skill
9
+
10
+ ## Goal
11
+ To improve code maintainability, flexibility, and readability by applying proven solutions to common design problems.
12
+
13
+ ## Supported Patterns (2025 Context)
14
+
15
+ ### Creational
16
+ - **Factory / Builder**: For complex object construction (e.g., configuring LLM clients).
17
+ - **Singleton**: Use sparingly (e.g., for Database connections or Logging service).
18
+
19
+ ### Structural
20
+ - **Adapter**: Connecting legacy code or external APIs (e.g., standardizing different LLM APIs).
21
+ - **Facade**: Simplifying complex subsystems (e.g., a simple `WebScraper` class wrapping Puppeteer).
22
+ - **Composite**: For tree structures (e.g., parsing code ASTs).
23
+
24
+ ### Behavioral
25
+ - **Strategy**: Swappable algorithms (e.g., switching between 'Fast' and 'Smart' search).
26
+ - **Observer**: Event handling (e.g., updating UI when data changes).
27
+ - **State**: Managing complex entity lifecycles (e.g., Order status: Pending -> Paid -> Shipped).
28
+
29
+ ### Modern / Cloud
30
+ - **Circuit Breaker**: Preventing cascading failures in distributed calls.
31
+ - **Sidecar**: Offloading infra concerns (logging, proxying) to a separate process/container.
32
+ - **BFF (Backend for Frontend)**: API layer tailored to specific UIs.
33
+
34
+ ## Steps
35
+ 1. **Identify the Problem**: "I have a lot of `if/else` statements for different payment methods."
36
+ 2. **Match Pattern**: "This looks like a use case for the **Strategy Pattern**."
37
+ 3. **Refactor**:
38
+ - Define the Interface.
39
+ - Implement Concrete Strategies.
40
+ - Inject the Strategy into the Context.
41
+ 4. **Document**: Add a comment or use `DESIGN_PATTERN_USAGE.md` if complex.
42
+
43
+ ## Anti-Patterns to Avoid
44
+ - **God Object**: Class that does everything.
45
+ - **Golden Hammer**: Using the same pattern everywhere (e.g., everything is a Singleton).
46
+
47
+ ## Security & Guardrails
48
+
49
+ ### 1. Skill Security (Design Patterns)
50
+ - **Pattern Implementation Integrity**: When the agent generates code for complex patterns like `Facade` or `Adapter`, it must not inadvertently bypass existing security checks. For example, if an `Adapter` wraps an older API, the agent must ensure it does not accidentally strip out authentication headers or input sanitization routines present in the original call chain.
51
+ - **Singleton State Exhaustion**: If the agent implements a `Singleton` for a shared resource (like a DB connection pool), it must explicitly define maximum bounds and timeout values. An unbound Singleton can be exploited to cause a Denial of Service (DoS) by exhausting memory or connections globally across the application.
52
+
53
+ ### 2. System Integration Security
54
+ - **Proxy/Sidecar Bypass**: When the architecture uses a `Sidecar` or `BFF` for security concerns (like TLS termination or global rate limiting), the agent must physically or logically isolate the backend service so it ONLY accepts traffic from the Sidecar/BFF. Any network configuration allowing a direct request to the backend service bypasses the security pattern entirely.
55
+ - **Observer Data Leakage**: In the `Observer` pattern, state changes are broadcast to all subscribed listeners. The agent must verify that sensitive data (e.g., unhashed passwords, PII) is scrubbed from the event payload *before* it is broadcast, ensuring that an arbitrary internal listener cannot silently capture regulated data.
56
+
57
+ ### 3. LLM & Agent Guardrails
58
+ - **Complexity-Driven Vulnerabilities**: The LLM might propose an overly convoluted combination of `Strategy`, `Factory`, and `Decorator` patterns to solve a simple problem. This extreme abstraction (the "Lasagna Architecture") makes it nearly impossible for human reviewers to trace the execution flow and identify authorization bugs. The agent must prioritize the "Keep It Simple, Stupid" (KISS) principle for security-critical pathways.
59
+ - **Hallucinated Thread-Safety**: The agent must definitively know the concurrency model of the target language. If the agent generates a `Singleton` in a multi-threaded language (like Java or Go), it is strictly forbidden from generating naive, thread-unsafe initializations which could lead to race conditions and unpredictable authorization state.
@@ -0,0 +1,380 @@
1
+ ---
2
+ name: "diagramming"
3
+ description: Choose and create the right diagram type (UML, C4, ER, BPMN, domain) in standard notation; Mermaid-compatible output.
4
+ triggers: ["create diagram", "draw diagram", "which diagram", "diagram this", "visualize", "sequence diagram", "class diagram", "flowchart", "architecture diagram", "ER diagram", "state diagram", "activity diagram", "context diagram", "swimlane"]
5
+ tags: ["architecture"]
6
+ context_cost: "low"
7
+ ---
8
+ # Diagramming Skill
9
+
10
+ ## Goal
11
+
12
+ Select the appropriate diagram type for the communication need, create it using correct
13
+ notation and standards, and produce output in Mermaid syntax (or PlantUML as fallback).
14
+ Diagrams are communication tools — choose based on what question the reader needs answered.
15
+
16
+ ---
17
+
18
+ ## Diagram Selection Guide
19
+
20
+ ```
21
+ Question being answered → Diagram type
22
+
23
+ "What IS the system and who uses it?" → System Context (C4 Level 1)
24
+ "What are the major deployable parts?" → Container Diagram (C4 Level 2)
25
+ "What are the components inside a container?" → Component Diagram (C4 Level 3)
26
+ "How are business objects structured?" → Domain Class Diagram
27
+ "How are data tables related?" → Entity-Relationship Diagram
28
+ "What packages/modules exist?" → Package Diagram
29
+ "How does process X flow step by step?" → Sequence Diagram
30
+ "What are all the paths through a use case?" → Activity Diagram
31
+ "What states can object X be in?" → State Machine Diagram
32
+ "Who does what in a process?" → Swimlane Diagram (BPMN or Activity)
33
+ "How does the business process work end-to-end?" → BPMN Process Diagram
34
+ "What are all the use cases for an actor?" → Use Case Diagram
35
+ "Where is the system deployed physically?" → Deployment Diagram (C4 or UML)
36
+ "How does data flow through the system?" → Data Flow Diagram (DFD)
37
+ "What are the business capabilities?" → Capability Map
38
+ "How do domains relate to each other?" → Context Map
39
+ "What happened in what order (events)?" → Event Storming / Timeline
40
+ ```
41
+
42
+ ---
43
+
44
+ ## Diagram Standards by Type
45
+
46
+ ### C4 Architecture Diagrams (Mermaid C4)
47
+
48
+ ```
49
+ Level of abstraction:
50
+ Level 1 — System Context: whole system as one box + external actors
51
+ Level 2 — Container: major deployable units (apps, databases, services)
52
+ Level 3 — Component: major components inside ONE container
53
+ Level 4 — Code: class/entity level (use sparingly)
54
+
55
+ Rules:
56
+ - Each diagram has ONE level of zoom
57
+ - Include title, description for each element
58
+ - Show communication protocol on relationship arrows
59
+ - External systems in grey/different color
60
+ - Boundary boxes for systems
61
+
62
+ Mermaid C4 syntax:
63
+ C4Context, C4Container, C4Component, C4Deployment
64
+ Person(), System(), System_Ext(), Container(), ContainerDb()
65
+ Rel(from, to, "label", "protocol")
66
+ ```
67
+
68
+ **Mermaid C4 Context Example:**
69
+ ```mermaid
70
+ C4Context
71
+ title System Context — Order Management System
72
+ Person(customer, "Customer", "Registered user placing orders")
73
+ Person(admin, "Admin", "Internal staff managing orders")
74
+ System(oms, "Order Management", "Handles order lifecycle")
75
+ System_Ext(payment, "Payment Gateway", "Processes payments")
76
+ System_Ext(email, "Email Service", "Sends notifications")
77
+ Rel(customer, oms, "Places orders", "HTTPS")
78
+ Rel(admin, oms, "Manages orders", "HTTPS")
79
+ Rel(oms, payment, "Charges customer", "HTTPS/API")
80
+ Rel(oms, email, "Sends confirmation", "HTTPS")
81
+ ```
82
+
83
+ ---
84
+
85
+ ### Sequence Diagram (interaction over time)
86
+
87
+ ```
88
+ Use when: showing how components/actors interact in a specific scenario.
89
+ Strengths: clear temporal ordering, shows synchronous vs async, highlights round-trips.
90
+
91
+ Rules:
92
+ - Show ONE use case scenario per diagram (not all scenarios in one)
93
+ - Label all arrows with the operation/message name
94
+ - Use activation bars for synchronous calls
95
+ - Show return messages explicitly (dashed arrows)
96
+ - Use alt/opt/loop for conditional flows
97
+
98
+ Anti-patterns:
99
+ - Too many actors (> 6) — split into smaller diagrams
100
+ - Showing all edge cases in one diagram — use separate diagrams
101
+ - Missing return arrows — always show response
102
+ ```
103
+
104
+ **Mermaid Sequence Example:**
105
+ ```mermaid
106
+ sequenceDiagram
107
+ autonumber
108
+ actor Customer
109
+ participant OrderService
110
+ participant InventoryService
111
+ participant PaymentGateway
112
+
113
+ Customer->>OrderService: POST /orders {items, paymentToken}
114
+ OrderService->>InventoryService: checkStock(items)
115
+ InventoryService-->>OrderService: stockAvailable: true
116
+ OrderService->>PaymentGateway: chargeCard(paymentToken, amount)
117
+ PaymentGateway-->>OrderService: paymentConfirmed: {transactionId}
118
+ OrderService-->>Customer: 201 Created {orderId}
119
+ ```
120
+
121
+ ---
122
+
123
+ ### State Machine Diagram (object lifecycle)
124
+
125
+ ```
126
+ Use when: showing all valid states an entity can be in and transitions between them.
127
+ Strengths: captures business rules about what transitions are allowed.
128
+
129
+ Rules:
130
+ - Start state: filled circle (●)
131
+ - End state: filled circle with ring (⊙)
132
+ - Transitions labeled with: trigger [guard condition] / action
133
+ - Every state should be reachable from start
134
+ - Every non-terminal state should have at least one exit
135
+
136
+ Anti-patterns:
137
+ - Missing guard conditions (ambiguous transitions)
138
+ - No final state (infinite loop entity)
139
+ ```
140
+
141
+ **Mermaid State Example:**
142
+ ```mermaid
143
+ stateDiagram-v2
144
+ [*] --> Pending : OrderPlaced
145
+ Pending --> Confirmed : PaymentReceived
146
+ Pending --> Cancelled : PaymentFailed / timeout
147
+ Confirmed --> Shipped : FulfilmentCompleted
148
+ Confirmed --> Cancelled : CustomerCancelled [before shipping]
149
+ Shipped --> Delivered : DeliveryConfirmed
150
+ Shipped --> ReturnRequested : CustomerReturns
151
+ Delivered --> ReturnRequested : CustomerReturns [within 30 days]
152
+ ReturnRequested --> Refunded : ReturnReceived
153
+ Cancelled --> [*]
154
+ Delivered --> [*]
155
+ Refunded --> [*]
156
+ ```
157
+
158
+ ---
159
+
160
+ ### Entity-Relationship Diagram (data model)
161
+
162
+ ```
163
+ Use when: showing data model — tables, entities, and relationships.
164
+ Strengths: precise notation for cardinality, clear data ownership.
165
+
166
+ Cardinality notation (Chen / crow's foot):
167
+ ||--|| : exactly one to exactly one
168
+ ||--o{ : exactly one to zero-or-more
169
+ }o--o{ : zero-or-more to zero-or-more
170
+ ||--|{ : exactly one to one-or-more
171
+
172
+ Rules:
173
+ - Every entity has a primary key attribute
174
+ - Relationship lines include cardinality
175
+ - Attribute names use domain language (not column names)
176
+ - Foreign key relationships shown as lines, not as duplicate attributes
177
+ ```
178
+
179
+ **Mermaid ER Example:**
180
+ ```mermaid
181
+ erDiagram
182
+ CUSTOMER ||--o{ ORDER : "places"
183
+ ORDER ||--|{ ORDER_ITEM : "contains"
184
+ PRODUCT ||--o{ ORDER_ITEM : "included in"
185
+ CUSTOMER {
186
+ uuid id PK
187
+ string email
188
+ string name
189
+ timestamp createdAt
190
+ }
191
+ ORDER {
192
+ uuid id PK
193
+ uuid customerId FK
194
+ string status
195
+ decimal total
196
+ timestamp placedAt
197
+ }
198
+ ORDER_ITEM {
199
+ uuid id PK
200
+ uuid orderId FK
201
+ uuid productId FK
202
+ int quantity
203
+ decimal unitPrice
204
+ }
205
+ PRODUCT {
206
+ uuid id PK
207
+ string name
208
+ decimal price
209
+ int stockQuantity
210
+ }
211
+ ```
212
+
213
+ ---
214
+
215
+ ### Activity / Flowchart (process flow)
216
+
217
+ ```
218
+ Use when: showing decision logic, algorithmic flow, or business process steps.
219
+ Strengths: clear decision branches, parallelism notation.
220
+
221
+ Rules:
222
+ - Start and end nodes clearly marked
223
+ - Decision nodes (diamond) have labeled branches for each outcome
224
+ - Parallel flows shown with fork/join bars
225
+ - Use swimlanes to show who does what
226
+ ```
227
+
228
+ **Mermaid Flowchart Example:**
229
+ ```mermaid
230
+ flowchart TD
231
+ A([Start: Order Received]) --> B{Inventory Check}
232
+ B -->|Available| C[Reserve Inventory]
233
+ B -->|Unavailable| D[Notify Customer: Out of Stock]
234
+ D --> Z([End: Order Cancelled])
235
+ C --> E{Payment Processing}
236
+ E -->|Success| F[Confirm Order]
237
+ E -->|Failure| G{Retry count < 3?}
238
+ G -->|Yes| E
239
+ G -->|No| H[Release Inventory]
240
+ H --> I[Notify Customer: Payment Failed]
241
+ I --> Z
242
+ F --> J[Schedule Fulfilment]
243
+ J --> K[Send Confirmation Email]
244
+ K --> Z2([End: Order Confirmed])
245
+ ```
246
+
247
+ ---
248
+
249
+ ### Data Flow Diagram (DFD)
250
+
251
+ ```
252
+ Use when: showing how data moves through a system across processes and stores.
253
+ DFD uses a specific notation:
254
+ External Entity: rectangle (data source/sink outside system)
255
+ Process: rounded rectangle or circle (transforms data)
256
+ Data Store: open-ended rectangle (persistent storage)
257
+ Data Flow: labeled arrow (data moving)
258
+
259
+ Levels:
260
+ Level 0 (Context DFD): System as one process, all external entities, all data flows
261
+ Level 1 (System DFD): Explode main process into sub-processes
262
+ Level 2: Explode one sub-process further (only if needed)
263
+
264
+ Rules:
265
+ - Data stores: data at rest (not processes)
266
+ - Processes: always transform input to output (labeled as verb phrases)
267
+ - All flows must be labeled with what data flows
268
+ - External entities: actors or systems outside system boundary
269
+ ```
270
+
271
+ **DFD in Mermaid (approximation using flowchart):**
272
+ ```mermaid
273
+ flowchart LR
274
+ Customer([Customer])
275
+ Admin([Admin])
276
+ subgraph "Order System"
277
+ P1[Process Order]
278
+ P2[Validate Payment]
279
+ P3[Update Inventory]
280
+ DS1[(Order Store)]
281
+ DS2[(Product Store)]
282
+ end
283
+ PaymentGateway([Payment Gateway])
284
+
285
+ Customer -->|"Order Request"| P1
286
+ P1 -->|"Payment Details"| P2
287
+ P2 -->|"Charge Request"| PaymentGateway
288
+ PaymentGateway -->|"Payment Result"| P2
289
+ P2 -->|"Confirmed Order"| DS1
290
+ P1 -->|"Stock Query"| DS2
291
+ DS2 -->|"Stock Level"| P1
292
+ P2 -->|"Reserve Items"| P3
293
+ P3 -->|"Updated Stock"| DS2
294
+ Admin -->|"Inventory Update"| P3
295
+ DS1 -->|"Order Confirmation"| Customer
296
+ ```
297
+
298
+ ---
299
+
300
+ ### Context Map Diagram (domain relationships)
301
+
302
+ ```
303
+ Use when: showing how bounded contexts relate to each other.
304
+ See domain-model.skill.md for context map patterns.
305
+ ```
306
+
307
+ **Mermaid Context Map Example:**
308
+ ```mermaid
309
+ graph TB
310
+ subgraph "Order Management [U]"
311
+ OM[Order Management]
312
+ end
313
+ subgraph "Identity [U]"
314
+ IAM[Identity & Access]
315
+ end
316
+ subgraph "Payment [U]"
317
+ PAY[Payment]
318
+ end
319
+ subgraph "Notification [D]"
320
+ NOT[Notification]
321
+ end
322
+ subgraph "Catalog [U]"
323
+ CAT[Product Catalog]
324
+ end
325
+
326
+ IAM -->|"OHS/PL\nUser Identity API"| OM
327
+ CAT -->|"OHS/PL\nProduct API"| OM
328
+ OM -->|"Customer/Supplier\nPayment Intent"| PAY
329
+ OM -->|"OHS\nOrderEvent"| NOT
330
+ PAY -->|"Published Language\nPaymentEvent"| NOT
331
+
332
+ style OM fill:#dae8fc
333
+ style IAM fill:#d5e8d4
334
+ style PAY fill:#d5e8d4
335
+ style CAT fill:#d5e8d4
336
+ style NOT fill:#fff2cc
337
+ ```
338
+
339
+ ---
340
+
341
+ ## Diagram Review Checklist
342
+
343
+ ```
344
+ Before finalizing any diagram:
345
+ □ Title: is there a clear, descriptive title?
346
+ □ Scope: is it clear what's IN and what's OUTSIDE the diagram?
347
+ □ Labels: are all elements and arrows labeled clearly?
348
+ □ Legend: does the diagram need a legend for custom notation?
349
+ □ Level: is this diagram one consistent level of abstraction?
350
+ □ Audience: would the target reader understand it without explanation?
351
+ □ Accuracy: does this match the actual system (not wishful thinking)?
352
+ □ Completeness: are all significant elements shown?
353
+ □ Clutter: is there anything that can be removed to improve clarity?
354
+ ```
355
+
356
+ ---
357
+
358
+ ## Constraints
359
+
360
+ - One diagram = one question answered. Do not mix levels of abstraction.
361
+ - Diagrams must match reality — no aspirational architecture in current-state diagrams
362
+ - Prefer Mermaid for text-based portability (renders in GitHub, VS Code, Notion)
363
+ - If Mermaid can't represent the diagram type, describe in structured text with explicit notation
364
+ - Include diagram title and date — diagrams without metadata become unreliable
365
+ - Simple is better — if a diagram needs extensive explanation, simplify the diagram
366
+
367
+ ## Security & Guardrails
368
+
369
+ ### Steps
370
+ ## 1. Skill Security (Diagramming)
371
+ - **Visual IP Leakage**: The agent must not include highly specific, sensitive configuration details (e.g., hardcoded IP subnets, plaintext API keys, precise firewall port numbers) within the generated Mermaid diagrams. Diagrams act as a high-level topographical map; embedding literal secrets turns the documentation into a target for credential scraping.
372
+ - **Malicious Syntax Injection**: The agent must sanitize any user-provided names or labels before injecting them into Mermaid or PlantUML syntax. An attacker providing a component name like `"); DROP TABLE users;` must not be able to break the markdown renderer or cause HTML injection/XSS when the diagram is visualized in a browser.
373
+
374
+ ### 2. System Integration Security
375
+ - **Threat Model Anchoring**: When generating a System Context (Level 1) or Container (Level 2) diagram, the agent must ensure that all external boundaries and trust domains align perfectly with the application's Threat Model. A diagram that omits an external third-party service creates a blind spot where zero security controls will be applied.
376
+ - **Data Classification in DFDs**: When creating Data Flow Diagrams (DFDs), the agent should distinguish the flow of highly sensitive data (e.g., marking PCI/PHI flows in red or with specific labels). This provides visual proof to auditors that regulated data is exclusively traversing encrypted, approved pathways.
377
+
378
+ ### 3. LLM & Agent Guardrails
379
+ - **Aspirational Architecture Bias**: The LLM might hallucinate security components (e.g., drawing a "WAF" or "KMS" box) simply because it mathematically associates them with enterprise deployments, even if they explicitly do not exist in the current system. The agent must strictly adhere to rendering *only* the verified, ground-truth architecture, preventing a false sense of security.
380
+ - **Protocol Hallucination**: The agent must accurately reflect communication protocols (e.g., `HTTPS` vs `HTTP`, `TLS` vs `TCP`). If the agent "guesses" that an internal connection uses `HTTPS` when it actually uses plaintext `HTTP`, it actively orchestrates a critical vulnerability misrepresentation. If the protocol is unknown, it must be labeled `[UNKNOWN]`, not assumed secure.