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,568 @@
1
+ # Guide: Diagramming Standards
2
+ <!-- When to use which diagram type, notation standards, Mermaid syntax reference -->
3
+ <!-- Diagram families: UML, C4, ER, BPMN, DFD, Domain, Infrastructure -->
4
+ <!-- Technology-agnostic. All diagrams expressed in Mermaid where possible. -->
5
+
6
+ ---
7
+
8
+ ## The Golden Rule of Diagrams
9
+
10
+ **One diagram answers ONE question for ONE audience.**
11
+
12
+ ```
13
+ Before drawing: ask "What question does this diagram answer?"
14
+ If no clear answer → don't draw it.
15
+ If the answer requires 2+ questions → split into 2 diagrams.
16
+
17
+ Good question: "What external actors interact with our system?" → System Context
18
+ Bad question: "Everything about our system" → No single diagram type
19
+ ```
20
+
21
+ ---
22
+
23
+ ## Diagram Selection Decision Tree
24
+
25
+ ```
26
+ Q: What are you trying to show?
27
+
28
+ ├── System structure / architecture
29
+ │ ├── Who uses it and what external systems interact?
30
+ │ │ → System Context Diagram (C4 Level 1)
31
+ │ ├── What are the major deployable units?
32
+ │ │ → Container Diagram (C4 Level 2)
33
+ │ ├── What components are inside one container?
34
+ │ │ → Component Diagram (C4 Level 3)
35
+ │ ├── How are classes/entities related in code?
36
+ │ │ → Class Diagram (UML)
37
+ │ └── How do packages/modules depend on each other?
38
+ │ → Package Diagram (UML) / Module Dependency Map
39
+ │
40
+ ├── Runtime behavior / interactions
41
+ │ ├── How do components/actors interact over time for one scenario?
42
+ │ │ → Sequence Diagram (UML)
43
+ │ ├── What decision logic or process flow?
44
+ │ │ → Activity Diagram (UML) / Flowchart
45
+ │ ├── What states can an object be in?
46
+ │ │ → State Machine Diagram (UML)
47
+ │ └── How does a business process work end-to-end?
48
+ │ → BPMN Process Diagram / Swimlane
49
+ │
50
+ ├── Data
51
+ │ ├── How are data entities related? (schema-level)
52
+ │ │ → Entity-Relationship Diagram (ER)
53
+ │ └── How does data flow through the system? (process-level)
54
+ │ → Data Flow Diagram (DFD)
55
+ │
56
+ ├── Deployment / infrastructure
57
+ │ └── Where does the system run?
58
+ │ → Deployment Diagram (C4 Deployment or UML)
59
+ │
60
+ └── Domain / business
61
+ ├── How do bounded contexts relate?
62
+ │ → Context Map
63
+ ├── What business capabilities exist?
64
+ │ → Capability Map
65
+ ├── What happened in what order?
66
+ │ → Event Storming / Timeline
67
+ └── Who does what, who makes decisions?
68
+ → Use Case Diagram (UML) or RACI Matrix
69
+ ```
70
+
71
+ ---
72
+
73
+ ## C4 Architecture Diagrams
74
+
75
+ The C4 model provides 4 levels of abstraction for software architecture.
76
+ Each level answers a different question for a different audience.
77
+
78
+ ```
79
+ Level 1 — System Context:
80
+ Question: Who uses the system? What external systems interact?
81
+ Audience: Everyone — business, technical, non-technical
82
+ Scope: The entire system as one box
83
+
84
+ Level 2 — Container:
85
+ Question: What are the major deployable units?
86
+ Audience: Technical (developers, architects, DevOps)
87
+ Scope: Inside the system boundary — one step of zoom
88
+
89
+ Level 3 — Component:
90
+ Question: What are the major components inside ONE container?
91
+ Audience: Technical (developers, architects)
92
+ Scope: Inside one container
93
+
94
+ Level 4 — Code:
95
+ Question: How is one component implemented internally?
96
+ Audience: Developers (code author's immediate team)
97
+ Scope: Classes, interfaces, functions
98
+ Note: Use sparingly — code changes too fast to maintain L4 diagrams
99
+ ```
100
+
101
+ ### C4 Mermaid Syntax
102
+
103
+ ```mermaid
104
+ %% Level 1 — System Context
105
+ C4Context
106
+ title System Context — [Name]
107
+ Person(id, "Label", "Description")
108
+ Person_Ext(id, "Label", "Description") %% external person
109
+ System(id, "Label", "Description")
110
+ System_Ext(id, "Label", "Description") %% external system
111
+ SystemDb(id, "Label", "Description") %% database system
112
+ Rel(from, to, "Label", "Protocol")
113
+ Rel_Back(from, to, "Label") %% reverse arrow
114
+ UpdateLayoutConfig($c4ShapeInRow="3")
115
+ ```
116
+
117
+ ```mermaid
118
+ %% Level 2 — Containers
119
+ C4Container
120
+ title Container Diagram — [Name]
121
+ Person(user, "User")
122
+ System_Boundary(sys, "System Name") {
123
+ Container(id, "Label", "Technology", "Description")
124
+ ContainerDb(id, "Label", "Technology", "Description")
125
+ ContainerQueue(id, "Label", "Technology", "Description")
126
+ }
127
+ System_Ext(ext, "External System")
128
+ Rel(from, to, "Label", "Protocol")
129
+ ```
130
+
131
+ ---
132
+
133
+ ## UML Structural Diagrams
134
+
135
+ ### Class / Domain Diagram
136
+
137
+ ```
138
+ Use when: showing the structure of domain objects, their attributes, and relationships.
139
+ In architecture context: use for domain model documentation (not database schema).
140
+
141
+ Relationship notation:
142
+ Association: A → B (A uses B)
143
+ Dependency: A --> B (A depends on B, weaker)
144
+ Aggregation: A <>-- B (B is part of A, but exists independently)
145
+ Composition: A *-- B (B is owned by A, destroyed with A)
146
+ Inheritance: A <|-- B (B extends A)
147
+ Realization: A <|.. B (B implements A's interface)
148
+
149
+ Multiplicity:
150
+ 1 exactly one
151
+ 0..1 zero or one
152
+ * zero or many
153
+ 1..* one or many
154
+ N..M between N and M
155
+ ```
156
+
157
+ ```mermaid
158
+ classDiagram
159
+ class Order {
160
+ +OrderId id
161
+ +CustomerId customerId
162
+ +OrderStatus status
163
+ +Money total
164
+ +place() void
165
+ +confirm(paymentId) void
166
+ +cancel(reason) void
167
+ }
168
+ class OrderItem {
169
+ +ProductId productId
170
+ +int quantity
171
+ +Money unitPrice
172
+ +lineTotal() Money
173
+ }
174
+ class Money {
175
+ +decimal amount
176
+ +string currency
177
+ +add(Money) Money
178
+ }
179
+ class OrderStatus {
180
+ <<enumeration>>
181
+ PENDING
182
+ CONFIRMED
183
+ SHIPPED
184
+ DELIVERED
185
+ CANCELLED
186
+ }
187
+ Order "1" *-- "1..*" OrderItem : contains
188
+ Order --> Money : totals to
189
+ OrderItem --> Money : priced in
190
+ Order --> OrderStatus : has
191
+ ```
192
+
193
+ ### Package / Module Diagram
194
+
195
+ ```
196
+ Use when: showing how code is organized into modules and their dependencies.
197
+ Rules:
198
+ - Arrows show dependency direction (A → B means A imports/uses B)
199
+ - Cyclic dependencies (A → B → A) are architectural violations
200
+ - Group related packages into namespace boundaries
201
+ ```
202
+
203
+ ```mermaid
204
+ graph LR
205
+ subgraph "Presentation Layer"
206
+ HTTP[HTTP Controllers]
207
+ end
208
+ subgraph "Application Layer"
209
+ UC[Use Cases]
210
+ end
211
+ subgraph "Domain Layer"
212
+ DOM[Domain Entities]
213
+ IFACE[Repository Interfaces]
214
+ end
215
+ subgraph "Infrastructure Layer"
216
+ REPO[Repository Implementations]
217
+ EXT[External Service Clients]
218
+ end
219
+
220
+ HTTP --> UC
221
+ UC --> DOM
222
+ UC --> IFACE
223
+ REPO --> IFACE
224
+ REPO --> DOM
225
+ EXT --> DOM
226
+ HTTP -.->|"FORBIDDEN"| REPO
227
+ ```
228
+
229
+ ---
230
+
231
+ ## UML Behavioral Diagrams
232
+
233
+ ### Sequence Diagram
234
+
235
+ ```
236
+ Use when: showing how actors/components interact for ONE specific scenario.
237
+ Best for: API flows, use case implementation, integration sequences.
238
+
239
+ Rules:
240
+ - One scenario per diagram (not all scenarios combined)
241
+ - Show actors (people) as stick figures; components as boxes
242
+ - Solid arrow: synchronous call (caller waits)
243
+ - Dashed arrow: return message
244
+ - Open arrowhead: async message (caller doesn't wait)
245
+ - Activation bars: show when an object is active
246
+ - Use alt/opt/loop for conditional branches (keep simple — split if complex)
247
+ ```
248
+
249
+ ```mermaid
250
+ sequenceDiagram
251
+ autonumber
252
+ actor Customer
253
+ participant API as Order API
254
+ participant Inventory
255
+ participant Payment as Payment Gateway
256
+
257
+ Customer->>+API: POST /orders {items, paymentMethod}
258
+
259
+ API->>+Inventory: checkAvailability(items)
260
+ Inventory-->>-API: {available: true}
261
+
262
+ API->>+Payment: authorize(paymentMethod, total)
263
+ Payment-->>-API: {authorized: true, authCode}
264
+
265
+ API->>API: createOrder()
266
+ API-->>-Customer: 201 {orderId, status: "CONFIRMED"}
267
+
268
+ Note over API,Inventory: Async: reserve inventory after response
269
+ ```
270
+
271
+ ### State Machine Diagram
272
+
273
+ ```
274
+ Use when: showing all valid states an entity can be in and how it transitions.
275
+ Best for: order lifecycle, user account states, subscription states.
276
+
277
+ Rules:
278
+ - [*]: initial state (filled circle) and final state (circle with ring)
279
+ - Transitions labeled with: event [guard] / action
280
+ - Every state must be reachable from the initial state
281
+ - No impossible transitions — every exit must have a guard if conditional
282
+ - Keep to ≤ 10 states per diagram; split complex lifecycles into sub-states
283
+ ```
284
+
285
+ ```mermaid
286
+ stateDiagram-v2
287
+ direction LR
288
+ [*] --> Pending : OrderPlaced
289
+ Pending --> Confirmed : PaymentReceived
290
+ Pending --> Cancelled : PaymentFailed\nor CustomerCancelled
291
+ Confirmed --> Processing : PickingStarted
292
+ Confirmed --> Cancelled : CustomerCancelled [before picking]
293
+ Processing --> Shipped : Dispatched
294
+ Shipped --> Delivered : DeliveryConfirmed
295
+ Shipped --> ReturnRequested : CustomerInitiatesReturn
296
+ Delivered --> ReturnRequested : CustomerInitiatesReturn [within 30 days]
297
+ ReturnRequested --> Refunded : ItemReturnedAndInspected
298
+ Delivered --> [*]
299
+ Refunded --> [*]
300
+ Cancelled --> [*]
301
+ ```
302
+
303
+ ### Activity Diagram / Flowchart
304
+
305
+ ```
306
+ Use when: showing decision logic, process flow, algorithmic steps, or workflow.
307
+ Best for: business process documentation, algorithm description.
308
+
309
+ Rules:
310
+ - Start and end nodes clearly shown
311
+ - Decision diamonds: binary outcomes labeled on both exits
312
+ - Parallel flows: fork/join bars for concurrent activities
313
+ - Keep to one level — use sub-diagrams for complex sub-processes
314
+ - Action verb phrases for activity labels
315
+ ```
316
+
317
+ ```mermaid
318
+ flowchart TD
319
+ Start([Order Received]) --> ValidateInput{Input Valid?}
320
+ ValidateInput -- No --> ReturnError[Return 400 Error]
321
+ ReturnError --> End1([End])
322
+ ValidateInput -- Yes --> CheckInventory{Items Available?}
323
+ CheckInventory -- No --> NotifyUnavailable[Notify: Items Unavailable]
324
+ NotifyUnavailable --> End2([End: Cancelled])
325
+ CheckInventory -- Yes --> ProcessPayment{Payment OK?}
326
+ ProcessPayment -- No --> RetryPayment{Retries < 3?}
327
+ RetryPayment -- Yes --> ProcessPayment
328
+ RetryPayment -- No --> ReleaseInventory[Release Reserved Inventory]
329
+ ReleaseInventory --> NotifyFailed[Notify: Payment Failed]
330
+ NotifyFailed --> End3([End: Cancelled])
331
+ ProcessPayment -- Yes --> ConfirmOrder[Confirm Order]
332
+ ConfirmOrder --> SendConfirmation[Send Confirmation Email]
333
+ SendConfirmation --> End4([End: Confirmed])
334
+ ```
335
+
336
+ ---
337
+
338
+ ## Entity-Relationship Diagrams (ER / Data Model)
339
+
340
+ ```
341
+ Use when: documenting the data model — entities, attributes, and relationships.
342
+ Note: Use for logical/conceptual model, not physical DB schema.
343
+ Physical schema is implementation — ER is business model.
344
+
345
+ Cardinality (crow's foot notation):
346
+ ||--|| : exactly one to exactly one
347
+ ||--o{ : exactly one to zero-or-many
348
+ ||--|{ : exactly one to one-or-many
349
+ }o--o{ : zero-or-many to zero-or-many
350
+ }|--|{ : one-or-many to one-or-many
351
+ ```
352
+
353
+ ```mermaid
354
+ erDiagram
355
+ CUSTOMER ||--o{ ORDER : "places"
356
+ ORDER ||--|{ ORDER_ITEM : "contains"
357
+ PRODUCT ||--o{ ORDER_ITEM : "referenced in"
358
+ ORDER }o--|| PAYMENT : "paid by"
359
+
360
+ CUSTOMER {
361
+ uuid customerId PK
362
+ string email "unique"
363
+ string fullName
364
+ date registeredAt
365
+ }
366
+ ORDER {
367
+ uuid orderId PK
368
+ uuid customerId FK
369
+ string status "PENDING|CONFIRMED|SHIPPED|DELIVERED|CANCELLED"
370
+ decimal totalAmount
371
+ datetime placedAt
372
+ }
373
+ ORDER_ITEM {
374
+ uuid itemId PK
375
+ uuid orderId FK
376
+ uuid productId FK
377
+ int quantity "min:1"
378
+ decimal unitPriceAtTime
379
+ }
380
+ PRODUCT {
381
+ uuid productId PK
382
+ string name
383
+ decimal currentPrice
384
+ int stockQuantity
385
+ }
386
+ PAYMENT {
387
+ uuid paymentId PK
388
+ uuid orderId FK
389
+ string status "PENDING|AUTHORIZED|CAPTURED|FAILED|REFUNDED"
390
+ decimal amount
391
+ datetime processedAt
392
+ }
393
+ ```
394
+
395
+ ---
396
+
397
+ ## Data Flow Diagrams (DFD)
398
+
399
+ ```
400
+ Use when: showing how data moves through a system — processes, stores, flows.
401
+ Best for: understanding data processing, compliance documentation.
402
+
403
+ DFD notation:
404
+ External Entity: rectangle (source or sink of data, outside system)
405
+ Process: rounded rectangle or circle (transforms data)
406
+ Data Store: parallel lines (persistent storage)
407
+ Data Flow: labeled arrow (data in motion)
408
+
409
+ Levels:
410
+ Level 0 (Context DFD): whole system as one process with all external entities
411
+ Level 1: Explode main process into sub-processes with their flows
412
+ Level 2+: Drill into sub-processes (use sparingly — only complex areas)
413
+
414
+ Mermaid approximation (no native DFD, use flowchart with shapes):
415
+ ```
416
+
417
+ ```mermaid
418
+ flowchart LR
419
+ Customer([Customer]):::ext
420
+ Admin([Admin]):::ext
421
+ PaymentGW([Payment Gateway]):::ext
422
+
423
+ subgraph "Order System"
424
+ P1([Process Order]):::process
425
+ P2([Validate Payment]):::process
426
+ P3([Manage Inventory]):::process
427
+ DS1[("Order Store")]:::store
428
+ DS2[("Product Store")]:::store
429
+ end
430
+
431
+ Customer -->|"Order Request"| P1
432
+ P1 -->|"Stock Query"| DS2
433
+ DS2 -->|"Stock Level"| P1
434
+ P1 -->|"Payment Details"| P2
435
+ P2 -->|"Charge Request"| PaymentGW
436
+ PaymentGW -->|"Auth Result"| P2
437
+ P2 -->|"Order Data"| DS1
438
+ P2 -->|"Reserve"| P3
439
+ P3 -->|"Updated Stock"| DS2
440
+ Admin -->|"Inventory Update"| P3
441
+ DS1 -->|"Confirmation"| Customer
442
+
443
+ classDef ext fill:#f9f,stroke:#333
444
+ classDef process fill:#bbf,stroke:#333
445
+ classDef store fill:#bfb,stroke:#333
446
+ ```
447
+
448
+ ---
449
+
450
+ ## BPMN / Swimlane Diagrams
451
+
452
+ ```
453
+ Use when: showing who does what in a business process — multiple actors.
454
+ Best for: business process modeling, regulatory documentation.
455
+
456
+ Swimlane rules:
457
+ - One lane per actor/role
458
+ - Activities (tasks): in the lane of who performs them
459
+ - Decision gates (diamonds): in the lane of who decides
460
+ - Sequence flows: connect activities across lanes with arrows
461
+ - Events (circles): start/end markers per lane
462
+ - External systems: typically represented as separate pools/lanes
463
+ ```
464
+
465
+ ```mermaid
466
+ flowchart LR
467
+ subgraph Customer
468
+ C1([Start]) --> C2[Browse & Add to Cart]
469
+ C2 --> C3[Checkout]
470
+ C3 --> C4{Payment OK?}
471
+ C4 -->|Yes| C5[Receive Confirmation]
472
+ C4 -->|No| C6[Update Payment]
473
+ C6 --> C3
474
+ end
475
+ subgraph "Order System"
476
+ OS1[Validate Order] --> OS2[Reserve Inventory]
477
+ OS2 --> OS3[Process Payment]
478
+ OS3 --> OS4{Payment Result}
479
+ OS4 -->|Success| OS5[Confirm Order]
480
+ OS4 -->|Fail| OS6[Release Inventory]
481
+ end
482
+ subgraph "Fulfilment"
483
+ F1[Pick Items] --> F2[Pack Order]
484
+ F2 --> F3[Ship]
485
+ F3 --> F4([End: Delivered])
486
+ end
487
+
488
+ C3 --> OS1
489
+ OS5 --> C5
490
+ OS6 --> C4
491
+ OS5 --> F1
492
+ ```
493
+
494
+ ---
495
+
496
+ ## Diagram Review Checklist
497
+
498
+ Before finalizing any diagram:
499
+
500
+ ```
501
+ Content:
502
+ □ Title: clear, descriptive, present tense ("Order Placement Flow")
503
+ □ Scope: what's IN the diagram is clear (system boundary, time boundary)
504
+ □ Audience: the diagram is pitched at the right level for its reader
505
+ □ Accuracy: reflects the ACTUAL system, not the aspirational system
506
+ □ Completeness: all significant elements included (not an exhaustive catalog)
507
+
508
+ Clarity:
509
+ □ All elements labeled (no unlabeled arrows or boxes)
510
+ □ Legend included if custom notation used
511
+ □ Consistent level of abstraction throughout (no mixing levels)
512
+ □ Key message visible at first glance (not buried in detail)
513
+ □ Clutter: anything that can be removed without loss? Remove it.
514
+
515
+ Maintenance:
516
+ □ Date/version noted on the diagram or in filename
517
+ □ Owner identified (who is responsible for keeping this current?)
518
+ □ Review trigger: "Update when [X] changes"
519
+ □ Source file (Mermaid code) stored with the diagram, not just the image
520
+ ```
521
+
522
+ ---
523
+
524
+ ## Tool Recommendations
525
+
526
+ ```
527
+ Mermaid: Text-based, renders in GitHub/GitLab/Notion/VS Code
528
+ Best for: C4, Sequence, State, ER, Flowchart, Class
529
+ Source: mermaid.js.org
530
+
531
+ PlantUML: Text-based, broader UML support, requires Java
532
+ Best for: complex UML, timing diagrams
533
+ Source: plantuml.com
534
+
535
+ draw.io (diagrams.net): GUI, XML-based, stores as XML in repo
536
+ Best for: freeform diagrams, whiteboards, mixed notation
537
+ Source: diagrams.net
538
+
539
+ Structurizr: Purpose-built C4 model tool
540
+ Best for: large system C4 diagrams with many views
541
+ Source: structurizr.com
542
+
543
+ Excalidraw: Collaborative whiteboard, hand-drawn style
544
+ Best for: early-stage exploration, event storming
545
+ Source: excalidraw.com
546
+
547
+ Lucidchart/Miro: Collaborative GUI tools
548
+ Best for: team workshops, stakeholder presentations
549
+ ```
550
+
551
+ ---
552
+
553
+ ## Diagram Naming Conventions
554
+
555
+ ```
556
+ File naming:
557
+ [system]-[view-type]-[context].md or .mermaid
558
+
559
+ Examples:
560
+ orderservice-sequence-place-order.md
561
+ platform-container-diagram.md
562
+ domain-context-map.md
563
+ customer-lifecycle-state-machine.md
564
+ data-model-order-management.md
565
+
566
+ Version in filename only if multiple significant versions need to coexist:
567
+ architecture-container-v2.md (v2 = major redesign)
568
+ ```
@@ -0,0 +1,103 @@
1
+ # Evaluation Strategy Guide (for agentic / LLM systems)
2
+
3
+ When the system under construction is — or relies on — an LLM, "does it pass?" is the
4
+ wrong question. Output is probabilistic, so the right question is "how good is it, on
5
+ average, on the inputs we care about, and is it getting worse?". This guide covers how
6
+ GABBE evaluates probabilistic systems alongside its normal deterministic testing.
7
+
8
+ ## 1. Tests vs Evals — two different jobs
9
+
10
+ These are complementary, not competing. You need both.
11
+
12
+ - **Tests** verify **determinism**. The same input must always produce the same output.
13
+ The verdict is binary pass/fail, it is cheap, and it runs on every commit/PR in CI. This
14
+ is everything in `testing-strategy.md` — static analysis, unit, integration, contract,
15
+ E2E.
16
+ - **Evals** score **probabilistic quality**. The same input may produce different output
17
+ each run. The verdict is **graded** (a score, not a boolean), it **samples** the input
18
+ space rather than covering it exhaustively, and it tolerates variance by running many
19
+ times.
20
+
21
+ Rule of thumb: if you can write a deterministic assertion, write a **test**. Reach for an
22
+ **eval** only for the part that is genuinely probabilistic (the model's judgment, phrasing,
23
+ or reasoning).
24
+
25
+ ## 2. The Eval Pyramid
26
+
27
+ Like the testing pyramid, push work down to the cheapest, most-deterministic layer that
28
+ can express the check. Climb only when you must.
29
+
30
+ 1. **Deterministic assertions (base)** — exact match, regex, JSON-schema validation, set
31
+ membership. Cheap, instant, 100% reproducible. Most "quality" checks are secretly
32
+ deterministic — catch them here.
33
+ 2. **Semantic similarity** — embedding cosine similarity against a reference answer, with
34
+ a threshold. Tolerates wording differences while still being mostly reproducible.
35
+ 3. **LLM-as-judge** — a model scores the output against a rubric. Expensive, subjective,
36
+ non-deterministic; use for quality dimensions no formula captures (clarity, helpfulness).
37
+ 4. **Human review (tip)** — the gold standard and the calibration anchor for everything
38
+ below it. Slowest and most expensive; reserve for high-stakes output and for keeping the
39
+ judges honest.
40
+
41
+ Each layer up costs more and is less reproducible. A good eval suite is fat at the base.
42
+
43
+ ## 3. Eval-first, alongside test-first
44
+
45
+ Test-first says: write the failing test before the code. Eval-first extends this to
46
+ probabilistic work: **define the golden dataset and the rubric before building the
47
+ system**. The golden dataset is the executable form of the spec — it states, in concrete
48
+ input/expected pairs, what "good" means. Writing it first forces you to define success
49
+ before you can fool yourself into thinking you have it. See `eval-driven-development.skill`
50
+ for the full workflow (start small, grow the dataset from every real failure).
51
+
52
+ ## 4. Where evals plug into GABBE's SDLC
53
+
54
+ - **S05 / S06 (implementation / testing)** — eval **checkpoints**, owned by the **eng-qa**
55
+ persona. As the skill/system is built, it is scored against the golden dataset and rubric
56
+ defined earlier. A failing eval checkpoint blocks the same way a failing test does, once
57
+ the scores are stable enough to gate on (see section 6).
58
+ - **S12 (Day-2 / evolve)** — **continuous eval**. The system runs against the eval suite on
59
+ a schedule so quality drift (model updates, prompt edits, data shift) is caught after
60
+ release, not by users. New production failures become new golden-dataset rows here.
61
+
62
+ The relevant skills slot in by layer: `llm-as-judge.skill` for the Tier-3 judging layer,
63
+ `rag-evaluation.skill` when the system retrieves context (score retrieval and generation
64
+ separately), and `agent-trajectory-eval.skill` when you must grade the *path* an agent took
65
+ (tool calls, intermediate steps), not just its final answer.
66
+
67
+ ## 5. Nondeterminism — why we run N times and report pass^k
68
+
69
+ A single run is a single sample from a distribution. Published agent-quality estimates
70
+ vary by roughly **2–6 points** between runs of the *same* system on the *same* tasks, so a
71
+ one-shot number is noise as often as signal. To get a stable read:
72
+
73
+ - Run each case **N times** (e.g., N=5).
74
+ - Report **pass^k** (passes in *all* k runs) for reliability/CI gating — it measures
75
+ consistency, which is what production needs. Report **pass@k** (passes in *at least one*
76
+ of k runs) when you only want to know whether the capability exists at all.
77
+ - Record temperature and seeds so a run can be reproduced.
78
+
79
+ A system that scores 0.95 on pass@5 but 0.55 on pass^5 is not reliable — it can do the task
80
+ but won't do it dependably.
81
+
82
+ ## 6. Eval-driven CI — earn the right to block
83
+
84
+ Eval scores are noisy at first, and a flaky gate that fails good PRs trains everyone to
85
+ ignore it. So introduce evals into CI in two stages:
86
+
87
+ 1. **Non-blocking nightly first** — run the full suite on a schedule, publish the
88
+ scorecard, watch the variance. Regressions are reported, not enforced.
89
+ 2. **Blocking gates only once scores are stable** — promote a check to a PR-blocking gate
90
+ only after it has shown low run-to-run variance. Gate on the deterministic Tier-1/Tier-2
91
+ slice first; keep noisy LLM-judge checks advisory until they calibrate.
92
+
93
+ This mirrors how E2E tests earn their place in CI: prove they are not flaky before you let
94
+ them block the build.
95
+
96
+ ---
97
+
98
+ **Honesty note**: Evals **raise confidence**; they do not **prove** correctness. A green
99
+ scorecard means "no regression detected on the sampled cases", never "correct on all
100
+ inputs" — so keep growing the golden dataset from real failures. And the LLM judge is
101
+ **biased-but-useful**: a fast, scalable proxy that is never ground truth and must be
102
+ **calibrated against human labels**. When you stop calibrating, you stop knowing what your
103
+ scores mean.
@@ -0,0 +1,35 @@
1
+ # The 2030 Horizon: Future-Proofing Your Stack
2
+
3
+ Software engineering moves fast. In 2026, we are building the foundations for 2030.
4
+
5
+ ## 1. The 6G Era: "Internet of Everything" (IoE)
6
+ - **What**: Not just faster phones. 6G connects *surfaces*, *sensors*, and *biological* data.
7
+ - **Speed**: 1 Terabit/s peak. < 1ms latency.
8
+ - **Arch Impact**: The "Cloud" dissolves into a "Continuum". Applications must be **Edge-Native**, dynamically moving compute to where the user is.
9
+
10
+ ## 2. Agentic IoT & Matter
11
+ - **Old IoT**: "Dumb" sensors sending JSON to AWS.
12
+ - **New IoT**: AI Agents running on-chip (NPU), talking via **Matter** to other devices locally.
13
+ - **Arch Impact**: Your toaster negotiates energy usage with your solar panel. No cloud involved.
14
+
15
+ ## 3. Vector Computing & Semantic Memory
16
+ - **The Shift**: From `SELECT * WHERE name="Bob"` to `SELECT * WHERE meaning="Customer Frustration"`.
17
+ - **The Stack**: Vector Databases (Pinecone, pgvector) are the long-term memory for AI agents.
18
+ - **Arch Impact**: Apps need a "RAG Pipeline" (Retrieval-Augmented Generation) as a core architectural component, alongside the traditional DB.
19
+
20
+ ## 4. Local-First & CRDTs
21
+ - **The Problem**: Cloud-dependence makes apps slow and fragile.
22
+ - **The Solution**: Local-First. The app lives on the device. Syncs when possible.
23
+ - **CRDTs**: Mathematical magic that allows two users to edit the same offline document and merge perfectly when online.
24
+ - **Tools**: Automerge, Yjs, ElectricSQL.
25
+
26
+ ## 5. WebAssembly (WASM): The Universal Runtime
27
+ - **Promise**: Write in Rust/Go/Typescript, run *anywhere* safely at near-native speed.
28
+ - **Use Case**:
29
+ - **Browser**: Photoshop in the web.
30
+ - **Server**: "Nano-containers" that start in microseconds (faster than Docker).
31
+ - **Plugins**: Allow users to extend your SaaS with untrusted code.
32
+
33
+ ## 6. Post-Quantum Cryptography (PQC)
34
+ - **Threat**: Quantum computers (2030+) will break RSA/ECC encryption.
35
+ - **Action**: Start adopting NIST-approved PQC algorithms (CRYSTALS-Kyber) for long-term data storage.