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,305 @@
1
+ # Guide: SQL / NoSQL / Database Patterns
2
+ <!-- Migration-first development, PostgreSQL patterns, Redis, MongoDB -->
3
+
4
+ ---
5
+
6
+ ## Core Principle: Migration-First Development
7
+
8
+ **Define the schema first, derive the code from it — not the reverse.**
9
+
10
+ ```
11
+ 1. Design schema (ERD or text description)
12
+ 2. Write migration file (SQL or ORM migration)
13
+ 3. Generate/update ORM models from schema
14
+ 4. Write domain entities reflecting the schema
15
+ 5. Write tests against migration-created schema
16
+ ```
17
+
18
+ This ensures: reproducible environments, rollback safety, and team synchronization.
19
+
20
+ ---
21
+
22
+ ## SQL — PostgreSQL Best Practices
23
+
24
+ ### Naming Conventions
25
+
26
+ ```sql
27
+ -- Tables: plural, snake_case
28
+ CREATE TABLE user_accounts (...);
29
+ CREATE TABLE order_items (...);
30
+
31
+ -- Columns: snake_case, descriptive
32
+ user_id -- not "uid" or "userId"
33
+ created_at -- always timestamp with timezone
34
+ updated_at -- auto-maintained
35
+ deleted_at -- for soft deletes (nullable = not deleted)
36
+
37
+ -- Indexes: idx_[table]_[column(s)]
38
+ CREATE INDEX idx_users_email ON users(email);
39
+ CREATE INDEX idx_orders_user_status ON orders(user_id, status);
40
+
41
+ -- Foreign keys: fk_[child_table]_[parent_table]
42
+ ALTER TABLE orders ADD CONSTRAINT fk_orders_users
43
+ FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE;
44
+
45
+ -- Unique constraints: uq_[table]_[column(s)]
46
+ ALTER TABLE users ADD CONSTRAINT uq_users_email UNIQUE (email);
47
+ ```
48
+
49
+ ### Migration Safety Rules
50
+
51
+ ```sql
52
+ -- SAFE: Adding nullable column (backward compatible)
53
+ ALTER TABLE users ADD COLUMN phone_number VARCHAR(20) NULL;
54
+
55
+ -- SAFE: Adding column with default
56
+ ALTER TABLE users ADD COLUMN is_verified BOOLEAN NOT NULL DEFAULT false;
57
+
58
+ -- UNSAFE: Adding NOT NULL column without default (blocks migration on non-empty table)
59
+ -- BAD: ALTER TABLE users ADD COLUMN phone_number VARCHAR(20) NOT NULL;
60
+
61
+ -- SAFE rename strategy: add → populate → rename → drop
62
+ -- Step 1: Add new column
63
+ ALTER TABLE users ADD COLUMN full_name VARCHAR(255) NULL;
64
+ -- Step 2: Populate (run as data migration)
65
+ UPDATE users SET full_name = CONCAT(first_name, ' ', last_name);
66
+ -- Step 3 (next deploy): Add NOT NULL constraint
67
+ ALTER TABLE users ALTER COLUMN full_name SET NOT NULL;
68
+ -- Step 4 (next deploy): Drop old columns
69
+ ALTER TABLE users DROP COLUMN first_name, DROP COLUMN last_name;
70
+ ```
71
+
72
+ ### Index Strategy
73
+
74
+ ```sql
75
+ -- Index columns used in WHERE, ORDER BY, JOIN ON, GROUP BY
76
+ -- Rule: if your EXPLAIN shows "Seq Scan" on a large table, add an index
77
+
78
+ -- Composite index: column order matters — put most selective column first
79
+ CREATE INDEX idx_orders_user_status ON orders(user_id, status);
80
+ -- This index helps: WHERE user_id = X AND status = Y
81
+ -- This index helps: WHERE user_id = X (leftmost prefix)
82
+ -- This does NOT help: WHERE status = Y (no leftmost prefix)
83
+
84
+ -- Partial index: index only relevant rows
85
+ CREATE INDEX idx_orders_pending ON orders(created_at)
86
+ WHERE status = 'pending';
87
+
88
+ -- Expression index: for case-insensitive search
89
+ CREATE INDEX idx_users_email_lower ON users(LOWER(email));
90
+
91
+ -- Check slow queries: log_min_duration_statement = 1000ms in postgresql.conf
92
+ -- Or: pg_stat_statements extension
93
+ SELECT query, mean_exec_time, calls
94
+ FROM pg_stat_statements
95
+ ORDER BY mean_exec_time DESC LIMIT 20;
96
+ ```
97
+
98
+ ### PostgreSQL Advanced Patterns
99
+
100
+ ```sql
101
+ -- JSONB for flexible attributes (use sparingly — prefer normalized schema)
102
+ CREATE TABLE product_attributes (
103
+ product_id UUID REFERENCES products(id),
104
+ attributes JSONB NOT NULL DEFAULT '{}'
105
+ );
106
+ CREATE INDEX idx_product_attrs_gin ON product_attributes USING gin(attributes);
107
+ -- Query: WHERE attributes @> '{"color": "red"}'
108
+
109
+ -- Full-text search (avoid Elasticsearch for simple cases)
110
+ ALTER TABLE articles ADD COLUMN search_vector tsvector
111
+ GENERATED ALWAYS AS (
112
+ to_tsvector('english', COALESCE(title, '') || ' ' || COALESCE(body, ''))
113
+ ) STORED;
114
+ CREATE INDEX idx_articles_search ON articles USING gin(search_vector);
115
+ -- Query: WHERE search_vector @@ plainto_tsquery('english', 'search term')
116
+
117
+ -- Window functions (avoid N+1 for ranking/aggregation)
118
+ SELECT
119
+ user_id,
120
+ order_total,
121
+ RANK() OVER (PARTITION BY user_id ORDER BY order_total DESC) as rank
122
+ FROM orders;
123
+
124
+ -- Upsert (avoid race conditions on concurrent inserts)
125
+ INSERT INTO cache_entries (key, value, expires_at)
126
+ VALUES ($1, $2, $3)
127
+ ON CONFLICT (key) DO UPDATE
128
+ SET value = EXCLUDED.value, expires_at = EXCLUDED.expires_at;
129
+ ```
130
+
131
+ ---
132
+
133
+ ## Redis — Caching Patterns
134
+
135
+ ### When to Use Redis
136
+
137
+ ```
138
+ Cache: expensive computed results, session data, rate limit counters
139
+ Queue: job queues (BullMQ, Laravel Queue)
140
+ Pub/Sub: real-time notifications, event broadcasting
141
+ Rate limiting: sliding window counters
142
+ Leaderboards: sorted sets for rankings
143
+ ```
144
+
145
+ ### Key Naming Conventions
146
+
147
+ ```
148
+ Format: [service]:[entity]:[id]:[field]
149
+
150
+ Examples:
151
+ user:profile:123 → User profile cache
152
+ session:abc-token-xyz → Session data
153
+ rate_limit:login:192.168.1.1 → Rate limit counter
154
+ job:email:456 → Job data
155
+ lock:payment:order-789 → Distributed lock
156
+
157
+ Always set TTL:
158
+ SETEX user:profile:123 3600 "{...}" # expires in 1 hour
159
+ SET rate_limit:login:ip INCR EX 60 # expires in 1 minute
160
+ ```
161
+
162
+ ### Cache-Aside Pattern
163
+
164
+ ```typescript
165
+ // Read: check cache → if miss, query DB → populate cache
166
+ async function getUserById(id: string): Promise<User> {
167
+ const cacheKey = `user:profile:${id}`;
168
+ const cached = await redis.get(cacheKey);
169
+ if (cached) return JSON.parse(cached);
170
+
171
+ const user = await db.user.findUniqueOrThrow({ where: { id } });
172
+ await redis.setex(cacheKey, 3600, JSON.stringify(user)); // 1 hour TTL
173
+ return user;
174
+ }
175
+
176
+ // Write: update DB → invalidate cache (don't update cache on write)
177
+ async function updateUser(id: string, data: UpdateUserData): Promise<User> {
178
+ const user = await db.user.update({ where: { id }, data });
179
+ await redis.del(`user:profile:${id}`); // Invalidate — not update
180
+ return user;
181
+ }
182
+ ```
183
+
184
+ ### Rate Limiting with Redis
185
+
186
+ ```typescript
187
+ // Sliding window rate limiter
188
+ async function checkRateLimit(key: string, limit: number, windowSecs: number): Promise<boolean> {
189
+ const now = Date.now();
190
+ const windowStart = now - (windowSecs * 1000);
191
+
192
+ const pipeline = redis.pipeline();
193
+ pipeline.zremrangebyscore(key, 0, windowStart); // Remove old entries
194
+ pipeline.zadd(key, now, `${now}`); // Add current
195
+ pipeline.zcard(key); // Count in window
196
+ pipeline.expire(key, windowSecs); // Auto-cleanup
197
+
198
+ const results = await pipeline.exec();
199
+ const count = results![2][1] as number;
200
+ return count <= limit;
201
+ }
202
+ ```
203
+
204
+ ---
205
+
206
+ ## MongoDB — Schema Design Patterns
207
+
208
+ ### When to Use MongoDB
209
+
210
+ ```
211
+ Good fit:
212
+ - Document-oriented data (products with variable attributes)
213
+ - Hierarchical/nested data (comments with nested replies)
214
+ - Rapidly evolving schema (prototyping, early-stage products)
215
+ - High write throughput with flexible schema
216
+
217
+ Poor fit:
218
+ - Complex relationships requiring joins (use PostgreSQL)
219
+ - Financial/accounting data requiring ACID transactions
220
+ - Data requiring complex aggregations (use PostgreSQL window functions)
221
+ ```
222
+
223
+ ### Schema Design Principles
224
+
225
+ ```javascript
226
+ // Embed when: documents are always accessed together, 1:1 or 1:few
227
+ {
228
+ _id: ObjectId("..."),
229
+ userId: "uuid",
230
+ // Embedded address — always read with user
231
+ address: {
232
+ street: "123 Main St",
233
+ city: "Austin",
234
+ country: "US"
235
+ }
236
+ }
237
+
238
+ // Reference when: documents accessed independently, 1:many (large), many:many
239
+ // User document (separate collection)
240
+ { _id: ObjectId("user-1"), name: "Alice" }
241
+
242
+ // Order document (references user)
243
+ { _id: ObjectId("order-1"), userId: "user-1", total: 99.99 }
244
+ // Query: db.orders.find({ userId: "user-1" })
245
+ ```
246
+
247
+ ### Indexes
248
+
249
+ ```javascript
250
+ // Always index fields used in queries
251
+ db.users.createIndex({ email: 1 }, { unique: true });
252
+ db.orders.createIndex({ userId: 1, createdAt: -1 }); // compound
253
+ db.products.createIndex({ name: "text", description: "text" }); // text search
254
+
255
+ // Partial index (only index documents matching filter)
256
+ db.orders.createIndex(
257
+ { createdAt: 1 },
258
+ { partialFilterExpression: { status: "pending" } }
259
+ );
260
+ ```
261
+
262
+ ---
263
+
264
+ ## Migration Safety Checklist
265
+
266
+ ```
267
+ Before running any migration in production:
268
+ [ ] Tested on copy of production data (or realistic dataset size)
269
+ [ ] Rollback script written and tested
270
+ [ ] All application tests pass with new schema
271
+ [ ] Lock duration estimated (ALTER TABLE on large tables can lock for minutes)
272
+ [ ] Migration window planned (low-traffic period)
273
+ [ ] Backup confirmed before migration
274
+ [ ] Monitoring in place to detect errors immediately after migration
275
+ [ ] Rollback decision criteria defined ("if X happens, rollback immediately")
276
+ ```
277
+
278
+ ---
279
+
280
+ ## Agent-Readable Schema Documentation
281
+
282
+ Document your schema in a format agents can read and use:
283
+
284
+ ```markdown
285
+ ## Database Schema — [Project Name]
286
+
287
+ ### Table: users
288
+ | Column | Type | Constraints | Description |
289
+ |---|---|---|---|
290
+ | id | UUID | PK, not null | Primary key, auto-generated |
291
+ | email | VARCHAR(255) | UNIQUE, not null | User's email (lowercased) |
292
+ | password_hash | VARCHAR(255) | not null | bcrypt hash (never plaintext) |
293
+ | role | ENUM('admin','user','guest') | not null, default: 'user' | User's role |
294
+ | email_verified_at | TIMESTAMPTZ | nullable | null = not verified |
295
+ | created_at | TIMESTAMPTZ | not null, default: NOW() | Auto-set on insert |
296
+ | updated_at | TIMESTAMPTZ | not null | Auto-updated by trigger |
297
+
298
+ **Relationships:**
299
+ - users → has many → orders (orders.user_id FK)
300
+
301
+ **Business rules:**
302
+ - email must be unique and lowercased before storage
303
+ - password_hash must NEVER be returned in API responses
304
+ - Unverified users cannot access protected routes
305
+ ```
@@ -0,0 +1,36 @@
1
+ # IEEE, ACM, & ISO Engineering Standards Guide
2
+
3
+ ## 1. Introduction
4
+ While Agile methodologies revolutionized the speed of software delivery, the foundational bedrock of Computer Science and Software Engineering is defined by global bodies such as the **IEEE** (Institute of Electrical and Electronics Engineers), the **ACM** (Association for Computing Machinery), and the **ISO** (International Organization for Standardization).
5
+
6
+ Incorporating these standards elevates software from a "startup hack" to an academically and industrially verified engineered system.
7
+
8
+ ## 2. ISO/IEC/IEEE 42010 (Architecture Description)
9
+ This standard defines how system architectures should be communicated. The GABBE kit is fundamentally aligned with this standard.
10
+ - **Architectures vs. Architecture Descriptions**: The architecture is the system itself; the AD is the artifact (like a C4 model).
11
+ - **Stakeholders & Concerns**: Every diagram or document must exist to address a specific concern (e.g., Security, Performance) held by a specific Stakeholder (e.g., the CISO, the End User).
12
+ - **Viewpoints & Views**: A viewpoint is the *rules* for the diagram (e.g., "UML Sequence Diagram rules"). A view is the actual diagram applied to your system.
13
+
14
+ ## 3. ISO/IEC/IEEE 12207 (Software Life Cycle Processes)
15
+ This is the international standard for software lifecycle processes. It defines all tasks required for developing and maintaining software.
16
+ - It moves beyond just "coding" to emphasize formal **Verification** (Are we building the product right?) and **Validation** (Are we building the right product?).
17
+ - It strongly mandates rigorous Software Configuration Management (SCM)—meaning every requirement, test case, code change, and deployment manifest must be rigidly version-controlled and traceable.
18
+
19
+ ## 4. IEEE SWEBOK (Software Engineering Body of Knowledge)
20
+ Compiled by the IEEE Computer Society, SWEBOK defines the 15 Knowledge Areas (KAs) that a professional software engineer must understand.
21
+ When building systems in GABBE, agents will cross-reference architectural decisions against SWEBOK categories, particularly:
22
+ - **KA 2: Software Design** (Enforcing cohesion and minimizing coupling)
23
+ - **KA 4: Software Testing** (Unit, Integration, and System testing boundaries)
24
+ - **KA 10: Software Quality** (Static analysis, metrics, and technical debt measurement)
25
+
26
+ ## 5. ACM Code of Ethics and Professional Conduct
27
+ Software engineering has profound societal impacts. The ACM Code is the Hippocratic Oath of software developers.
28
+ 1. **Contribute to society and human well-being**, acknowledging that all people are stakeholders in computing.
29
+ 2. **Avoid harm**, taking action to prevent unintended consequences.
30
+ 3. **Be honest and trustworthy**, preventing deception in UX architectures (e.g., Dark Patterns).
31
+ 4. **Respect privacy and honor confidentiality**.
32
+
33
+ ## 6. Agentic Implementation
34
+ If your project is mission-critical, requires academic publication, or is being audited by a heavily regulated body (e.g., Aviation, Defense, Healthcare), invoke the `engineering-standards` skill.
35
+
36
+ The agent will systematically audit your codebase, design documentation, and CI/CD pipelines against these frameworks, producing an `ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md` to prove standard compliance.
@@ -0,0 +1,24 @@
1
+ # UN, ITU, & Global Open Source Standards Guide
2
+
3
+ ## 1. Introduction
4
+ Enterprise software does not exist in a vacuum. True interoperability and public-sector procurement require adherence to global treaties, non-governmental organizations (NGOs), and open-source foundations. This guide outlines the pillars of global software standardization.
5
+
6
+ ## 2. United Nations: Sustainable Development Goals (SDGs)
7
+ The UN's 17 SDGs are the blueprint for peace and prosperity. Software architecture primarily intersects with:
8
+ - **Goal 9 (Industry, Innovation, and Infrastructure)**: Ensuring your platform's APIs and data are open, bridging the digital divide, and providing robust (uptime > 99.9%) infrastructure that developing nations can rely on without exorbitant licensing costs.
9
+ - **Goal 10 (Reduced Inequalities)**: Following WCAG 2.1 AA/AAA accessibility standards natively so software is inclusive worldwide.
10
+ - **Goal 12 (Responsible Consumption and Production)**: Aligning directly with Green Software Engineering (see `green-software.skill.md`) to minimize datacenter e-waste.
11
+
12
+ ## 3. International Telecommunication Union (ITU)
13
+ The ITU is the UN specialized agency for ICTs (Information and Communication Technologies).
14
+ - **ITU-T X.509**: The foundational standard for public key infrastructure (PKI) and digital certificates defining how TLS/SSL operates globally.
15
+ - **ITU-T E.164**: The international public telecommunication numbering plan (why phone numbers look like `+1-555-0100`). Always store telephonic data in E.164 format.
16
+ - **ITU-T H-Series**: If building video conferencing or streaming tools, you are interacting with H.264/H.265 (HEVC) standards dictating packetization and compression.
17
+
18
+ ## 4. Worldwide Open Source Foundations
19
+ No modern software is written from scratch. Utilizing global Open Source effectively requires strict compliance:
20
+ - **Open Source Initiative (OSI)**: The steward of the Open Source Definition. Understand the difference between Permissive licenses (MIT, Apache 2.0) and Copyleft licenses (GPL, AGPL) to prevent legal liability in enterprise codebases.
21
+ - **OpenSSF (Open Source Security Foundation)**: The Linux Foundation project for securing the software supply chain. Implement the **SLSA** (Supply-chain Levels for Software Artifacts) framework to prevent dependency confusion and supply chain attacks (e.g., the SolarWinds hack).
22
+
23
+ ## 5. Agentic Implementation
24
+ When building systems targeting government procurement, international NGOs, or massive open-source integration, invoke the `global-standards` skill. The agent will audit the architecture against these international frameworks, generating a `GLOBAL_STANDARDS_AUDIT_TEMPLATE.md` to ensure your system represents global best-practices.
@@ -0,0 +1,33 @@
1
+ # Healthcare Interoperability & FHIR Guide
2
+
3
+ ## 1. Introduction
4
+ The Fast Healthcare Interoperability Resources (FHIR) standard is the modern framework for exchanging electronic health records (EHR). It was developed by HL7 (Health Level Seven International) combining the best features of previous standards (v2, v3, CDA) with modern web APIs.
5
+
6
+ ## 2. Why FHIR?
7
+ Historically, clinical data exchange relied on rigid, difficult-to-parse EDI messages (HL7 v2) or complex XML documents (CDA).
8
+ FHIR utilizes HTTP RESTful APIs, JSON/XML, and OAuth2, drastically lowering the barrier to entry for developers building clinical apps. Every major EHR vendor (Epic, Cerner, Meditech) now supports FHIR, mandated by global regulations (like the US 21st Century Cures Act).
9
+
10
+ ## 3. Core Concepts
11
+
12
+ ### Resources
13
+ FHIR is built on "Resources"—modular, standardized building blocks of clinical data.
14
+ - **Patient**: Demographics (Name, Gender, BirthDate, Contact).
15
+ - **Observation**: A single data point (Blood Pressure, Lab Result, Social History).
16
+ - **Condition**: A clinical diagnosis.
17
+ - **Encounter**: A visit between a patient and a practitioner.
18
+ - **MedicationRequest**: A prescription.
19
+
20
+ ### Profiles & Implementation Guides
21
+ The base FHIR standard is too broad: a "Patient" in the US requires a Race extension, but "Race" is illegal to track in France.
22
+ To solve this, FHIR uses **Profiles** which constrain the base resource. An **Implementation Guide (IG)** is a collection of profiles (e.g., US Core, UK Core, IPS). Your application must adhere to the specific IG of the region it operates in.
23
+
24
+ ## 4. Architectural Integration Models
25
+ - **RESTful API Endpoint**: Your application queries the EHR on-demand (e.g., `GET /Patient/123`).
26
+ - **SMART on FHIR**: A specific profile of OAuth2 allowing third-party apps to securely authorize against an EHR, embedding directly into the clinician's workflow without sharing passwords.
27
+ - **FHIR Subscriptions**: Pub/Sub model where the EHR sends a webhook payload to your system when a specific event occurs (e.g., ADT - Admission/Discharge/Transfer).
28
+
29
+ ## 5. Using the Skill
30
+ When tasked with integrating medical systems or interpreting clinical data schemas, use the `healthcare-fhir` skill. This ensures:
31
+ 1. Patient privacy (PHI) is explicitly handled.
32
+ 2. Clinical codes (SNOMED/LOINC) are used appropriately.
33
+ 3. The resulting `FHIR_INTEGRATION_TEMPLATE.md` maps local databases to globally compliant standards.
@@ -0,0 +1,33 @@
1
+ # Industrial IoT (IIoT) & Industry 4.0 Guide
2
+
3
+ ## 1. Introduction
4
+ The Industrial Internet of Things (IIoT) brings cloud compute, machine learning, and advanced telemetry to the factory floor. Unlike consumer IoT (smart thermostats), IIoT deals with mission-critical infrastructure where a millisecond of latency or a dropped connection can cause a halting of production lines, chemical spills, or physical danger.
5
+
6
+ ## 2. The Purdue Enterprise Reference Architecture
7
+ IIoT is structured topographically for security and reliability, known as the Purdue Model.
8
+ - **Level 0**: The Physical Process (the actual spinning motor).
9
+ - **Level 1**: Basic Control (PLCs, Remote I/O, Sensors).
10
+ - **Level 2**: Area Supervisory Control (SCADA systems, HMIs pointing to local machines).
11
+ - **Level 3**: Site Manufacturing Operations (MES, Historian databases).
12
+ - **Level 3.5 (DMZ)**: The Demilitarized Zone isolating the factory from the corporate network.
13
+ - **Level 4/5**: Enterprise IT and Cloud (ERP, AWS IoT, Big Data Analytics).
14
+
15
+ **Security Rule:** Data flows *up* relatively freely. Data flowing *down* (commands from Cloud to PLC) crosses extreme security boundaries and often requires human intervention or dedicated physical gateways (Data Diodes).
16
+
17
+ ## 3. Core Protocols
18
+ To bridge the gap between "Operational Technology" (OT - the factory) and "Information Technology" (IT - the cloud), two protocols dominate:
19
+
20
+ ### OPC UA (Open Platform Communications Unified Architecture)
21
+ - **Role**: The lingua franca of the factory floor.
22
+ - **How it works**: Client/Server model. It doesn't just send raw bytes (like `45.2`), it sends *semantic models* (e.g., "This is Sensor A on Pump 2, it measures Vibration, the unit is Hz, and the upper limit is 50Hz").
23
+ - **Where it's used**: Levels 1 to 3. PLCs talking to SCADA systems.
24
+
25
+ ### MQTT (Message Queuing Telemetry Transport)
26
+ - **Role**: The bridge to the cloud.
27
+ - **How it works**: Publish/Subscribe over TCP/IP. An edge gateway "publishes" telemetry to a central "Broker" (like AWS IoT Core), and multiple cloud microservices "subscribe" to that data.
28
+ - **Why it's used**: Extremely lightweight, handles flaky network connections gracefully, and decouples the sender from the receiver.
29
+
30
+ *Modern deployments often use an Edge IPC (Industrial PC) acting as a protocol translator—reading OPC UA from the machines and publishing MQTT to the cloud.*
31
+
32
+ ## 4. Agentic Implementation
33
+ When tasked to design a telemetry pipeline from a manufacturing facility, invoke the `industrial-iot` skill. The agent avoids naive architectures (like connecting a PLC directly to a public MySQL instance) and outputs a comprehensive mapping of Topics, Edge gateways, and TSDB (Time Series Database) storage using the `IOT_TELEMETRY_TEMPLATE.md`.
@@ -0,0 +1,34 @@
1
+ # Telecom Software & Networks Guide
2
+
3
+ ## 1. Introduction
4
+ Building software for the Telecommunications industry requires adhering to massive scale, high reliability ("Five Nines" 99.999% uptime), and strict global standards. Telecom architecture is generally split between IT (driving billing, catalogs, CRM) and the Core Network (hardware, antennas, packet cores).
5
+
6
+ ## 2. TM Forum & The Open Digital Architecture (ODA)
7
+ The TM Forum (TMF) is an alliance of global communication service providers. They maintain the standards for **OSS** (Operations Support Systems) and **BSS** (Business Support Systems).
8
+
9
+ ### TMF Open APIs
10
+ Never design custom REST APIs for basic telecom functions; always use TMF Open APIs.
11
+ - **TMF620 (Product Catalog Management)**: Defines the lifecycle of selling a telecom product.
12
+ - **TMF622 (Product Ordering)**: The standard for submitting an order for a new SIM or internet plan.
13
+ - **TMF666 (Account Management)**: Managing customer billing accounts.
14
+ - **TMF639 (Resource Inventory)**: Tracking physical routers or logical numbers (MSISDNs).
15
+
16
+ ### ODA (Open Digital Architecture)
17
+ ODA is a component-based software architecture replacing legacy, monolithic OSS/BSS platforms with cloud-native, plug-and-play microservices.
18
+
19
+ ## 3. Network Exposure & CAMARA
20
+ Historically, the capabilities of a 4G/5G cellular network (like knowing exactly where a phone is, or guaranteeing latency) were locked inside the carrier.
21
+
22
+ ### GSMA CAMARA Initiative
23
+ CAMARA is an open-source project defining standard APIs that expose network capabilities to third-party developers, regardless of which carrier the end-user is on.
24
+ - **Quality on Demand (QoD)**: An app can request a temporary slice of guaranteed 5G bandwidth (e.g., for a remote surgery or drone flight).
25
+ - **Device Location**: Query the cell towers to find a device, bypassing the phone's OS GPS spoofing.
26
+ - **SIM Swap**: A critical anti-fraud API for banks to check if a user's SIM card was recently ported to a hacker.
27
+
28
+ ## 4. eSIM and IoT (eUICC)
29
+ The physical plastic SIM card is being replaced by the eUICC (Embedded Universal Integrated Circuit Card).
30
+ - **Consumer Standard (SGP.22)**: End-user scans a QR code to download a profile from the carrier's SM-DP+ server.
31
+ - **IoT Standard (SGP.32)**: Remote provisioning of thousands of smart meters or fleet vehicles without user intervention.
32
+
33
+ ## 5. Agentic Implementation
34
+ When tasked with integrating enterprise systems with a cellular provider, or mocking a Telecom billing system, invoke the `telecom-networks` skill. The agent will restrict itself to TMF and CAMARA standards and output the required integration models in the `TELECOM_API_TEMPLATE.md`. This prevents building bespoke "spaghetti" integrations that carriers will reject.
@@ -0,0 +1,66 @@
1
+ # C# / .NET Project Guide
2
+
3
+ > **Audience:** agents writing or reviewing C#/.NET services. **Scope:** current
4
+ > stack, idioms, structure, testing, performance, and pitfalls for 2026.
5
+ > Versions verified 2026-06-10 (see sources at the end).
6
+
7
+ ## Recommended stack (2026)
8
+
9
+ - **Runtime:** **.NET 10 (LTS)** — released 2025-11, supported through Nov 2028.
10
+ Target `net10.0`; nullable reference types and implicit usings **on**.
11
+ - **Build:** `dotnet` CLI / MSBuild; `Directory.Build.props` for shared settings;
12
+ Central Package Management (`Directory.Packages.props`) for version pinning.
13
+ - **Web:** ASP.NET Core **Minimal APIs** for services; MVC/Razor/Blazor where a
14
+ UI or controller surface is warranted.
15
+ - **Data:** EF Core (LINQ + migrations) or Dapper for hot paths.
16
+ - **Testing:** xUnit + FluentAssertions + NSubstitute/Moq; **Testcontainers** for
17
+ integration; `WebApplicationFactory` for in-process API tests.
18
+ - **Quality:** nullable enabled, `TreatWarningsAsErrors`, Roslyn analyzers +
19
+ `dotnet format`; EditorConfig for style.
20
+
21
+ ## Idioms (current C#)
22
+
23
+ - **Records** and `record struct` for value/DTO types; `required` members +
24
+ primary constructors to enforce construction invariants.
25
+ - **Pattern matching** (`switch` expressions, list/property patterns) over
26
+ type-checking chains; `is not null`.
27
+ - `async`/`await` end-to-end — never `.Result`/`.Wait()` (deadlocks);
28
+ `CancellationToken` flows through every async boundary; `IAsyncEnumerable<T>`
29
+ for streaming.
30
+ - `System.Text.Json` (source-generated `JsonSerializerContext` for AOT/perf).
31
+ - Prefer `Span<T>`/`Memory<T>` and pooled buffers on allocation-sensitive paths.
32
+
33
+ ## Project structure (Clean Architecture)
34
+
35
+ ```
36
+ src/
37
+ Domain/ entities, value objects, domain events (no dependencies)
38
+ Application/ use-cases, ports/interfaces, validation
39
+ Infrastructure/ EF Core, external clients, implementations of ports
40
+ Api/ Minimal API endpoints, DI composition root
41
+ tests/ Unit (fast) + Integration (Testcontainers)
42
+ ```
43
+
44
+ Dependencies point inward; the API project is the composition root.
45
+
46
+ ## Performance & ops
47
+
48
+ - **Native AOT** for fast cold start / small footprint (CLIs, serverless,
49
+ high-density services) — validate trimming and that reflection-heavy libs are
50
+ AOT-compatible.
51
+ - Use the built-in DI, `IOptions<T>` for config, `ILogger<T>` structured logging,
52
+ and **OpenTelemetry** (`System.Diagnostics.Activity`) for traces/metrics.
53
+ - Health checks via `Microsoft.Extensions.Diagnostics.HealthChecks`.
54
+
55
+ ## Common pitfalls
56
+
57
+ - Sync-over-async (`.Result`) and missing `ConfigureAwait` in libraries.
58
+ - Capturing `DbContext` across threads (it is **not** thread-safe) or leaking it
59
+ beyond a scoped lifetime.
60
+ - Ignoring nullable warnings; over-using exceptions for control flow.
61
+ - N+1 from lazy loading; forgetting `AsNoTracking()` on read-only queries.
62
+
63
+ ## Sources (verified 2026-06-10)
64
+ - What's new in .NET 10: <https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-10/overview>
65
+ - .NET support policy (LTS = 3 years): <https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core>
66
+ - Native AOT: <https://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot/>