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,54 @@
1
+ # Human–Agent Collaboration Principles
2
+
3
+ > The most important interface GABBE has is the one between the **human** (the
4
+ > developer / engineer / architect) and the **agent** (Claude Code, Cursor,
5
+ > Antigravity, OpenCode, a raw LLM…). This guide makes that interface a
6
+ > first-class design concern, not an afterthought.
7
+
8
+ ## Why this matters
9
+ Autonomy is only trustworthy when the human keeps an **accurate mental model** of
10
+ what the agent is doing. No amount of capability is safe if the human cannot tell
11
+ what the agent is trying to do, how it is doing it, or how to intervene. A good
12
+ collaboration interface is the quality bar for "fully working in the best ways."
13
+
14
+ ## The three questions the human must always be able to answer
15
+ Drawn from ordinary mental-model and system-legibility principles, a well-behaved
16
+ agent keeps three questions answerable at every step:
17
+
18
+ | Facet | Question | GABBE's obligation | Satisfied in GABBE by |
19
+ |---|---|---|---|
20
+ | **Purpose** | "What is this for?" | Bound the agent's job — its domain, goals, and explicit **non-goals**. A "do anything" agent creates friction and false expectations. | CONSTITUTION scope + project-specific articles; the S01 Requirements gate / spec (`spec-driven`). |
21
+ | **Transparency** | "How is it working?" | Make reasoning, tool selection, and self-correction legible — never operate invisibly. | **Observability** (decision/span trace, token + cost attribution, `audit-trail`/`agent-analytics`, `AUDIT_LOG.md`). |
22
+ | **Control** | "How do I steer it?" | Provide affordances to **intervene** — pause, inject constraints, correct a plan, approve/reject high-stakes actions. | Human-in-the-Loop gates (AGENTS.md §9), the `GABBE_AUTONOMY` posture, `clarify.skill`. |
23
+
24
+ ## The collaboration stance: manager, not operator
25
+ The healthiest division of labour is for the human to act as a **manager** and the
26
+ agent as a **delegate**:
27
+
28
+ > *delegate the objective → observe progress → intervene on exceptions.*
29
+
30
+ This implies an **asynchronous, observable surface** — a synchronous
31
+ request/response UI for a ten-minute agent task forces the wrong mental model.
32
+ GABBE's observable surface (memory logs + the audit/decision trace + the task/gate
33
+ board in `project/TASKS.md`) is what makes delegation trustworthy. The three parties
34
+ of the collaboration are:
35
+
36
+ - **Human = manager / delegator** (developer, engineer, architect) — sets the
37
+ objective, reviews at gates, handles exceptions.
38
+ - **Agent = delegate** — executes the AGENTS.md operating loop / RARV cycle.
39
+ - **The observable shared surface = the connective tissue** — memory, audit
40
+ trace, and the task/gate board that keep the human's mental model accurate.
41
+
42
+ ## How GABBE operationalizes it
43
+ - **Purpose** → keep scope and non-goals explicit (CONSTITUTION + spec); the
44
+ architect persona bounds what the agent is and is *not* to do.
45
+ - **Transparency** → observability is non-negotiable (every run traced; see the
46
+ Observability mandate in AGENTS.md §5 and CONSTITUTION Article VI).
47
+ - **Control** → HITL gates + autonomy levels (L0–L3, `self-optimize.skill`) scale
48
+ intervention frequency to the autonomy the human has granted.
49
+
50
+ ## Final-review checklist (apply at integrity-check / S08)
51
+ A change is only "done" when all three facets hold:
52
+ - [ ] **Purpose** — scope/non-goals are explicit; the work maps to a spec/requirement.
53
+ - [ ] **Transparency** — the run is traced and legible (decisions, tools, cost) — no black box.
54
+ - [ ] **Control** — the right HITL gates fired for the autonomy level; high-stakes/irreversible actions were human-approved.
@@ -0,0 +1,61 @@
1
+ # The Undying Tech Stack: Legacy Systems in 2025
2
+
3
+ Legacy systems are not "dead" code. They are "proven" code.
4
+
5
+ > **Statistic**: In 2025, many of the world's banking transactions still touch a Mainframe. 95% of ATM swipes invoke COBOL.
6
+
7
+ ## 1. The Critical Stack
8
+
9
+ ### COBOL (Common Business Oriented Language)
10
+ - **Why it survives**: Unmatched decimal precision (money handling) and massive throughput.
11
+ - **Where lies**: Core Banking, Insurance Claims, Government (IRS/Social Security).
12
+ - **Risk**: Talent shortage. The average COBOL dev is 55+ years old.
13
+
14
+ ### Fortran (Formula Translation)
15
+ - **Why it survives**: Speed. It is still faster than C/C++ for certain linear algebra operations.
16
+ - **Where lies**: Weather forecasting, Nuclear simulation, Aerospace (NASA/Boeing).
17
+
18
+ ### Mainframe (IBM Z-Series)
19
+ - **Why it survives**: Reliability (5 9s default). Vertical scaling (adding CPUs while running). Security (Hardware encryption).
20
+ - **Modern**: Z-Series now runs Linux and OpenShift (K8s) alongside legacy z/OS.
21
+
22
+ ## 2. Modernization Strategies "In Place"
23
+
24
+ ### The "Mullet" Architecture
25
+ - **Front:** Modern Web/Mobile (React/iOS).
26
+ - **Back:** Legacy Mainframe.
27
+ - **Glue:** API Gateway / Middleware.
28
+
29
+ ### Zowe (Modern Mainframe DevOps)
30
+ The **Open Mainframe Project** created **Zowe**, which opens the mainframe to modern tools:
31
+ - **CLI**: Control mainframe via command line (not green screen).
32
+ - **API Mediation Layer**: Securely expose z/OS services as REST APIs.
33
+ - **Explorer**: VS Code extension to edit COBOL/JCL remotely.
34
+
35
+ ## 3. How to Read COBOL (Crash Course)
36
+
37
+ COBOL is verbose. It reads like English.
38
+
39
+ ```cobol
40
+ IDENTIFICATION DIVISION.
41
+ PROGRAM-ID. HELLO-WORLD.
42
+
43
+ DATA DIVISION.
44
+ WORKING-STORAGE SECTION.
45
+ 01 WS-NAME PICTURE X(20).
46
+
47
+ PROCEDURE DIVISION.
48
+ DISPLAY "ENTER NAME: ".
49
+ ACCEPT WS-NAME.
50
+ DISPLAY "HELLO, " WS-NAME.
51
+ STOP RUN.
52
+ ```
53
+
54
+ - **DIVISIONS**: The 4 major blocks (ID, ENV, DATA, PROCEDURE).
55
+ - **PICTURE (PIC)**: Defines data types. `9(5)` = 5 digit integer. `X(20)` = 20 char string. `V99` = 2 decimal places.
56
+
57
+ ## 4. Risk Mitigation Checklist
58
+
59
+ 1. **Identify the "Bus":** If Bob is the only one who knows the billing module, Bob is a single point of failure. **Pair program with Bob immediately.**
60
+ 2. **Characterization Tests:** Before fixing a bug, write a script that sends 1000 inputs and records 1000 outputs. Ensure your fix doesn't change outputs for non-bug inputs.
61
+ 3. **Documentation:** Use AI to generate explanation docs for complex subroutines.
@@ -0,0 +1,103 @@
1
+ # Mathematical Foundations for Software Engineering
2
+
3
+ Mathematics is the quiet substrate under most of what software engineers do well. You rarely write a proof at
4
+ work, but the *habits* of mathematical reasoning — precise definitions, invariants, case analysis, reasoning
5
+ about scale — are what separate code that happens to pass its examples from code that is correct by
6
+ construction. This guide is a reference for the mathematical topics that the SWEBOK v4 "Mathematical
7
+ Foundations" knowledge area treats as core, and for each one it points at where the idea actually surfaces in
8
+ day-to-day engineering. It is a foundations reference, not a course; the goal is recognition and orientation,
9
+ not derivation.
10
+
11
+ ## Propositional and predicate logic
12
+
13
+ Logic is the algebra of true/false statements and of statements quantified over values ("for all", "there
14
+ exists"). Propositional logic gives you `and`/`or`/`not`/`implies` and their identities; predicate logic adds
15
+ quantifiers and variables.
16
+
17
+ Where it shows up: every boolean condition, guard, and short-circuit you write is propositional logic, and
18
+ getting De Morgan's laws right is the difference between a correct negation and a subtle bug. More deeply,
19
+ **invariants** — properties that must hold for all valid states — are predicate-logic statements over your
20
+ program's data. This is exactly the raw material of property-based testing: an invariant like "decode of
21
+ encode is the identity for all inputs" is a quantified logical claim, and `pbt-strategy.skill` exists to
22
+ generate inputs that try to falsify it. Preconditions, postconditions, and loop invariants are the same idea
23
+ applied to a single function.
24
+
25
+ ## Sets, relations, and functions
26
+
27
+ A set is an unordered collection of distinct elements; a relation is a set of tuples linking elements; a
28
+ function is a relation that maps each input to exactly one output. Operations like union, intersection,
29
+ difference, and the notions of injective/surjective/bijective are the vocabulary.
30
+
31
+ Where it shows up: collections and deduplication are set operations; database joins, foreign keys, and
32
+ many-to-many tables are relations made concrete; referential integrity is a constraint on a relation. Knowing
33
+ that a function must be single-valued is what tells you when a mapping is actually ambiguous, and knowing when
34
+ a relation is an equivalence relation is what justifies partitioning data into clean, non-overlapping classes.
35
+
36
+ ## Graphs and trees
37
+
38
+ A graph is a set of nodes connected by edges (directed or undirected, weighted or not); a tree is a connected
39
+ acyclic graph with a hierarchy. Reachability, cycles, topological order, and shortest paths are the standard
40
+ questions.
41
+
42
+ Where it shows up: dependency analysis is graph work end to end. Build graphs, module import graphs, and
43
+ package dependency trees must be acyclic, and detecting a cycle is detecting a design problem; topological
44
+ sort is what produces a valid build or migration order. Call graphs, state machines, data-flow graphs, and
45
+ the object graphs a garbage collector traces are all graphs. Trees underlie file systems, the DOM, ASTs in
46
+ compilers, and most index structures.
47
+
48
+ ## Combinatorics
49
+
50
+ Combinatorics counts configurations: permutations, combinations, the multiplication and addition principles,
51
+ and the explosion of states as independent choices multiply.
52
+
53
+ Where it shows up: it is the backbone of **test-case design**. The number of combinations of input
54
+ conditions is combinatorial, which is precisely why exhaustive testing is usually infeasible and why
55
+ techniques like equivalence partitioning, boundary-value analysis, and pairwise (all-pairs) testing exist —
56
+ they are combinatorial reduction strategies that cover the interactions that matter without enumerating the
57
+ full product. Combinatorics also explains why feature-flag and configuration matrices blow up so fast, and
58
+ why caching keyed on many dimensions has a huge possible key space.
59
+
60
+ ## Probability and statistics
61
+
62
+ Probability quantifies uncertainty; statistics infers from samples to populations. Distributions,
63
+ expectation, variance, percentiles, significance, effect size, and confidence intervals are the working
64
+ tools.
65
+
66
+ Where it shows up: estimation is probabilistic, not deterministic — the P50/P90 ranges in
67
+ `estimation-sizing.skill` are percentiles of an outcome distribution, and treating them as such is what keeps
68
+ an estimate honest. Tail latencies (p95, p99) are percentiles of a response-time distribution and matter far
69
+ more than the mean for user experience. Reasoning about benchmark noise, A/B-test outcomes, sampling, and
70
+ "is this difference real or noise?" is statistical inference, which is the territory of
71
+ `empirical-methods.skill`. The central honesty rule travels with the math: an association is not a cause, and
72
+ a significant result is not necessarily an important one.
73
+
74
+ ## Proof techniques and formal reasoning
75
+
76
+ The standard proof methods — direct proof, proof by contradiction, proof by cases, and especially
77
+ mathematical induction — are ways to establish that a claim holds for *all* cases rather than the few you
78
+ tried.
79
+
80
+ Where it shows up: induction is the natural way to reason about recursion and about loops (the inductive step
81
+ is the loop body preserving the invariant). Reasoning by cases is what makes exhaustive `switch`/`match`
82
+ handling and total functions trustworthy. Formal methods and lightweight specification push this further,
83
+ proving properties of a design before code exists; even without full formality, the *posture* — define
84
+ precisely, then argue every case is covered — is what produces robust software.
85
+
86
+ ## Asymptotics and Big-O
87
+
88
+ Asymptotic analysis (Big-O, Big-Theta, Big-Omega) describes how cost grows with input size, abstracting away
89
+ constants and hardware. It is part discrete math, part analysis, and it is the lens for scalability.
90
+
91
+ Where it shows up: choosing the data structure or algorithm whose growth rate survives your real input sizes
92
+ is the everyday application, and it is owned in execution by `time-complexity.skill`. The math here tells you
93
+ *why* an O(n^2) inner loop that is fine in a test becomes an outage at production scale, and why constant
94
+ factors still matter once two options share the same asymptotic class.
95
+
96
+ ## Honest scope note
97
+
98
+ This is a foundations *reference*, not a mathematics course. Each topic above is a doorway: the entries name
99
+ the concept and show where it lands in engineering so you can recognize it and reach for the right execution
100
+ skill (`pbt-strategy.skill`, `estimation-sizing.skill`, `empirical-methods.skill`, `time-complexity.skill`,
101
+ and the test-design practices). It does not teach the underlying theorems, derivations, or formal notation —
102
+ for genuine depth, consult dedicated texts in discrete mathematics, probability, and the theory of
103
+ computation. The aim here is fluency in *where the math matters*, not a substitute for learning the math.
@@ -0,0 +1,97 @@
1
+ # Software Engineering Models and Methods
2
+
3
+ A model is a deliberate simplification of a system built to answer a specific question — "what are the
4
+ entities and how do they relate?", "what happens when this event arrives?", "how do these services
5
+ communicate?". A method is a disciplined procedure for building and using such models. Engineers model
6
+ constantly, usually informally on a whiteboard; this guide supplies the taxonomy underneath that practice so
7
+ you can choose the right model type, language, and degree of rigor on purpose rather than by reflex. It is
8
+ grounded in the SWEBOK v4 "Software Engineering Models and Methods" knowledge area and is meant as the
9
+ method-selection spine that sits behind the hands-on modeling skills.
10
+
11
+ ## Model types: information, structural, behavioral
12
+
13
+ Models fall into three broad families by the question they answer.
14
+
15
+ - **Information models** describe the data: the entities, their attributes, and the relationships and
16
+ constraints among them — independent of any behavior. Entity-relationship models and domain models live
17
+ here; they answer "what does the system know about, and what are the rules on that knowledge?". This is the
18
+ core of `domain-model.skill`.
19
+ - **Structural models** describe the static composition: components, modules, services, their interfaces, and
20
+ how they are arranged and depend on one another. Component, package, and deployment views, and C4's context
21
+ and container levels, are structural; they answer "what are the parts and how are they wired?". This is the
22
+ territory of `systems-architecture.skill`.
23
+ - **Behavioral models** describe dynamics over time: states and transitions, sequences of interaction,
24
+ control flow, and processes. State machines, sequence diagrams, activity flows, and BPMN processes are
25
+ behavioral; they answer "what happens, in what order, in response to what?".
26
+
27
+ A real design usually needs one model from more than one family — an information model of the data, a
28
+ structural model of the components, and a behavioral model of the critical flows — because each hides what the
29
+ others reveal.
30
+
31
+ ## Modeling languages
32
+
33
+ Languages give models a shared, communicable vocabulary. The common ones map cleanly onto the model types:
34
+
35
+ - **UML** (Unified Modeling Language) is the broad general-purpose set: class diagrams (information/
36
+ structural), component and deployment diagrams (structural), and sequence, state, and activity diagrams
37
+ (behavioral). Powerful but easy to over-apply.
38
+ - **C4** is a lightweight structural notation with four zoom levels — system Context, Container, Component,
39
+ and Code — designed to keep architecture diagrams legible to mixed audiences. It is well suited to
40
+ `systems-architecture.skill`.
41
+ - **ER** (entity-relationship) models data structure and is the natural language for information models and
42
+ the bridge to relational schema design.
43
+ - **BPMN** (Business Process Model and Notation) is a behavioral language specialized for business processes,
44
+ workflows, and the hand-offs between roles and systems.
45
+
46
+ The rendering mechanics — diagram-as-code, tooling, and house style — are owned by `diagramming.skill` and
47
+ the conventions in the guide `principles/diagramming-standards.md`; this guide is about which *language* fits
48
+ which *question*, not how to draw it.
49
+
50
+ ## Formal, semi-formal, and informal methods
51
+
52
+ Methods sit on a spectrum of rigor, and the spectrum is a cost/precision trade-off.
53
+
54
+ - **Informal methods** use natural language, sketches, and ad-hoc diagrams. Cheap, fast, excellent for
55
+ communication and early exploration — but ambiguous and unverifiable. Most whiteboard work is here, and for
56
+ most situations that is the right level.
57
+ - **Semi-formal methods** use a defined notation with structure but without complete mathematical semantics —
58
+ UML, C4, ER, BPMN. They constrain ambiguity and enable shared review and some tooling, while staying
59
+ approachable. This band covers the large majority of practical modeling need.
60
+ - **Formal methods** use mathematically precise specification languages (for example state-based or
61
+ algebraic specifications, model checkers, theorem provers) with defined semantics that permit proof and
62
+ automated verification. They can demonstrate properties hold for *all* cases — invaluable for
63
+ safety-critical, concurrent, or protocol-level designs where a missed case is catastrophic — but they are
64
+ expensive in skill, time, and maintenance.
65
+
66
+ The honest rule is that rigor should match the cost of being wrong. Reach for formal methods where failure is
67
+ unacceptable and the design is small and critical enough to be tractable; stay semi-formal or informal
68
+ everywhere else.
69
+
70
+ ## Method-selection criteria
71
+
72
+ Choosing a model and method is itself a small engineering decision. Weigh:
73
+
74
+ - **Cost of error.** Higher stakes (safety, money, security, irreversible effects) justify more rigor; a
75
+ throwaway internal tool does not.
76
+ - **Audience.** Mixed or non-technical stakeholders favor C4 context views and informal sketches; an
77
+ implementation team can use detailed UML or formal specs.
78
+ - **Question being asked.** Match the model family to the question — information, structural, or behavioral —
79
+ and resist modeling dimensions nobody needs to decide on.
80
+ - **Longevity and maintenance.** A model that must stay accurate over time costs upkeep; informal sketches
81
+ rot fast, formal specs demand discipline to keep true. Prefer the lightest model that survives as long as
82
+ it must.
83
+ - **Tooling and verifiability.** Use formal or strongly-typed models where you actually intend to verify or
84
+ generate from them; otherwise the added precision is overhead.
85
+
86
+ The default is to model the minimum that resolves the open question at the lowest rigor that is still
87
+ unambiguous enough — and to escalate rigor only where the cost of being wrong demands it.
88
+
89
+ ## Honest scope note
90
+
91
+ In practice, most modeling need is already met by two skills: `domain-model.skill` for the information model
92
+ of the domain and `diagramming.skill` (with `systems-architecture.skill` and the
93
+ `principles/diagramming-standards.md` conventions) for structural and behavioral views. This guide does not
94
+ duplicate that hands-on work; it adds the method-taxonomy spine — the model-type families, the language map,
95
+ the formality spectrum, and the selection criteria — so that the choice of *which* model and *how much* rigor
96
+ is made deliberately. It is an orientation reference, not a tutorial in UML, formal specification, or any
97
+ single notation; for depth in a specific language or formal technique, consult dedicated material.
@@ -0,0 +1,84 @@
1
+ # No-Code & Low-Code Integration Guide
2
+
3
+ **Bridge the gap between Pro-Code Agents and Citizen Developers.**
4
+
5
+ This guide explains how to integrate the Agentic Engineering Kit with No-Code platforms (n8n, Make, Zapier) to create hybrid workflows.
6
+
7
+ ---
8
+
9
+ ## 1. The Hybrid Architecture
10
+
11
+ in 2026, the strongest systems use a Hybrid approach:
12
+ * **Agents (Code):** Handle complex reasoning, edge cases, and deeply custom logic.
13
+ * **No-Code (Visual):** Handle standard triggers, simple data piping, and approval flows.
14
+
15
+ ### Architecture Pattern: "The Agent Node"
16
+ Instead of replacing No-Code, the Agent becomes a "Super Node" inside the No-Code flow.
17
+
18
+ `[ Webhook ] --> [ Transformation ] --> [ **AGENT NODE** ] --> [ CRM Update ] --> [ Slack Notify ]`
19
+
20
+ ---
21
+
22
+ ## 2. Platforms & Protocols
23
+
24
+ ### n8n (Self-Hostable)
25
+ * **Best For:** Heavy data processing, privacy-conscious deployments.
26
+ * **Integration:**
27
+ * **LangChain Node:** Use n8n's native LangChain integration to call your Agent.
28
+ * **HTTP Request:** Call your Agent's API Endpoint (see `eng-api` persona).
29
+ * **Pattern:** Agent returns structured JSON, n8n maps it to the next node.
30
+
31
+ ### Make.com (formerly Integromat)
32
+ * **Best For:** Visualizing complex logic branches.
33
+ * **Integration:**
34
+ * Use the "HTTP / Make Request" module.
35
+ * Set `Content-Type: application/json`.
36
+ * **Timeout Warning:** Agents can be slow. Set Make timeout to > 60s or use Webhooks (Async pattern).
37
+
38
+ ### Zapier
39
+ * **Best For:** Simple "If This Then That" flows.
40
+ * **Integration:**
41
+ * **Zapier AI Actions:** Expose your Agent's tools as Zapier Actions.
42
+ * **Webhooks:** Standard Request/Response.
43
+
44
+ ---
45
+
46
+ ## 3. The "Citizen Developer" Bridge
47
+
48
+ How to let non-coders control your Agent:
49
+
50
+ 1. **Configuration Schemas:**
51
+ * Agent exposes a `config.json` or YAML.
52
+ * No-Code tool reads this config to generate a Form.
53
+ * User fills Form -> Agent executes logic.
54
+
55
+ 2. **Approval Gates (Human-in-the-Loop):**
56
+ * Agent performs work -> Pauses -> Sends Webhook to Slack/Teams.
57
+ * User clicks "Approve" (No-Code button).
58
+ * No-Code tool calls Agent's "Resume" endpoint.
59
+
60
+ ---
61
+
62
+ ## 4. Generating No-Code Assets
63
+
64
+ The Agent can *write* the No-Code configuration for you.
65
+
66
+ * **n8n:** Agent generates the JSON definition of a Workflow. You import it.
67
+ * **OpenAPI:** Agent generates `openapi.yaml`. You import it into Custom Connectors (Zapier/PowerAutomate).
68
+
69
+ ### Example Prompt for Agent:
70
+ > "Generate an n8n workflow JSON that triggers on a Webhook, sends the body to my Summarizer Agent API, and posts the result to Slack."
71
+
72
+ ---
73
+
74
+ ## 5. Security & Governance
75
+
76
+ * **API Keys:** Never hardcode keys in No-Code tools. Use their Credential Managers.
77
+ * **Rate Limiting:** Protect your Agent API from run-away No-Code loops.
78
+ * **Validation:** Agent must strictly validate all inputs coming from No-Code sources (Zod/Pydantic).
79
+
80
+ ---
81
+
82
+ **Related Skills:**
83
+ * `architecture/api-design.skill.md`: How to build the API your No-Code tool calls.
84
+ * `coding/tool-construction.skill.md`: Building tools that Agents can use.
@@ -0,0 +1,97 @@
1
+ # Comprehensive Testing Strategy Guide (2025)
2
+
3
+ Testing is not just about "finding bugs" — it's about **confidence at speed**. This guide outlines modern testing strategies for robust applications.
4
+
5
+ ## 1. Core Models: Where to focus?
6
+
7
+ ### The Testing Pyramid (Classic)
8
+ **Shape**: Wide base of Unit tests, middle layer of Integration, tiny tip of E2E.
9
+ - **Best for**: Backend monoliths, Libraries, Complex Algorithms.
10
+ - **Why**: Unit tests are millisecond-fast. If your complexity is in the logic, test the logic.
11
+
12
+ ### The Testing Trophy (Modern)
13
+ **Shape**: "Static" base, small "Unit" neck, **HUGE "Integration" belly**, small "E2E" head.
14
+ - **Best for**: Frontend apps, Microservices, CRUD apps.
15
+ - **Why**: "Write tests. Not too many. Mostly integration." (Kent C. Dodds).
16
+ - **Logic**: In modern apps, the complexity is often in how components *interact*, not in the components themselves.
17
+
18
+ ## 2. Test Levels Defined
19
+
20
+ ### Level 0: Static Analysis (The Base)
21
+ Catch typos and type errors before code runs.
22
+ - **Tools**: TypeScript, ESLint, Prettier.
23
+ - **Cost**: Nearly zero (running in editor).
24
+
25
+ ### Level 1: Unit Testing
26
+ Verify a single function/class in isolation.
27
+ - **Mocking**: Heavily mocked dependencies.
28
+ - **Speed**: < 10ms per test.
29
+ - **Goal**: Does `add(1, 2)` return `3`?
30
+
31
+ ### Level 2: Integration Testing
32
+ Verify that units work together.
33
+ - **Frontend**: Does clicking the button trigger the form submit handler? (Render the component, but mock the network).
34
+ - **Backend**: Does the API endpoint return 200/400 correctly? (Spin up the server, use an in-memory DB).
35
+ - **Cost**: Medium.
36
+
37
+ ### Level 3: Contract Testing (Microservices)
38
+ Verify that Service A can talk to Service B.
39
+ - **Problem**: E2E tests are slow/flaky. Integration tests often mock too much.
40
+ - **Solution**: **Pact**.
41
+ - *Consumer* defines a contract ("I expect field `user_id`").
42
+ - *Provider* verifies it honors that contract in its CI.
43
+
44
+ ### Level 4: End-to-End (E2E) Testing
45
+ Verify the whole system as a user sees it.
46
+ - **Tools**: Playwright, Cypress.
47
+ - **Environment**: Real browser, real database (or realistic seed), real network.
48
+ - **Cost**: High (Slow, Flaky).
49
+ - **Strategy**: Smoke tests only. Test "Critical User Journeys" (Login, Checkout).
50
+
51
+ ### Level 5: Evaluation-Driven (for agentic / LLM work)
52
+ When the system *is* an agent (or uses one), correctness is probabilistic, so the
53
+ acceptance bar must be defined **before** the agent is built and must **co-evolve**
54
+ with it.
55
+ - **Evals before implementation**: write the success criteria / eval set at the spec stage (S01–S02), not after — they are the executable form of the spec (golden thread).
56
+ - **Component-level evals**: evaluate each persona/gate/sub-step on its own, not only end-to-end. One sub-agent's slightly-wrong output becomes the next one's hopelessly-wrong input, so end-to-end checks alone hide where it broke.
57
+ - **Regression evals**: keep a growing fixture set of past failures; re-run on every change (ties to `CONTINUITY.md` and `self-heal`).
58
+ - **Judge/verifier pass**: for high-stakes output, an independent verifier/judge persona scores against the rubric before human sign-off (see `coordination/persona-selector.skill` voting + `core/final-review.skill`).
59
+ - **Metric shift**: measure decision quality, cost-efficiency, and reliability — not lines of code.
60
+
61
+ ## 2b. Beyond Examples: Advanced Tiers (2025)
62
+
63
+ Example-based unit and integration tests only cover the cases a human imagined. Four
64
+ advanced tiers close the remaining gaps and now sit alongside the pyramid/trophy:
65
+ - **Property-Based Testing (PBT)**: declare invariants and let a generator (Hypothesis,
66
+ fast-check) fuzz thousands of inputs and shrink failures to a minimal counterexample —
67
+ ideal for parsers, codecs (round-trips), and pure logic. See `pbt-strategy.skill`.
68
+ - **Metamorphic Testing**: when there is no exact oracle (ML, ranking, LLM pipelines),
69
+ assert *relations between related inputs* instead of absolute outputs. See
70
+ `metamorphic-testing.skill`.
71
+ - **Chaos / Fault-Injection**: deliberately inject failures (latency, dropped packets,
72
+ dependency 500s, killed processes) and assert graceful degradation. See
73
+ `chaos-fault-injection.skill`.
74
+ - **Mutation Testing**: inject small faults into the source (mutmut, Stryker) and measure
75
+ the **mutation score** (killed ÷ total mutants) as a test-quality metric far stronger
76
+ than line coverage.
77
+
78
+ Crucially, **tests verify determinism; evals score probabilistic quality.** Deterministic
79
+ code earns a green/red test; agentic and LLM-driven behavior is graded by evals against a
80
+ rubric (see Level 5 above and `eval-driven-development.skill`). Use both — never substitute
81
+ a passing test suite for an eval on probabilistic output, or vice versa.
82
+
83
+ ## 3. Visual Regression Testing
84
+ For frontend, "code correctness" doesn't mean "visual correctness".
85
+ - **Tools**: Percy, Chromatic, Playwright visual comparisons.
86
+ - **Goal**: Catch CSS regressions (e.g., button turned invisible).
87
+
88
+ ## 4. Test Data Management
89
+ - **Seeding**: Creating a known state before tests run.
90
+ - **Factories**: Using libraries (like `faker`) to generate realistic random data.
91
+ - **Cleanup**: ensuring tests don't leave garbage data that breaks other tests.
92
+
93
+ ## 5. CI/CD Pipeline Strategy
94
+ 1. **Commit Hook**: Lint + Type Check.
95
+ 2. **Pull Request**: Unit + Integration Tests.
96
+ 3. **Merge to Main**: Smoke E2E Tests + Contract Tests.
97
+ 4. **Release candidate**: Full Regression Suite.
@@ -0,0 +1,44 @@
1
+ # Visual Design System Guide
2
+
3
+ ## Why a Design System?
4
+ A design system is the "single source of truth" for UI components and visuals. It prevents:
5
+ - **Inconsistency**: 50 shades of gray.
6
+ - **Redundancy**: Re-implementing the "Button" 10 times.
7
+ - **Accessibility failures**: Ensuring checking happens once, centrally.
8
+
9
+ ## Core Elements (The Tokens)
10
+
11
+ ### 1. Color Palette
12
+ Defined in `templates/coding/DESIGN_TOKENS_TEMPLATE.json`.
13
+ - **Primary**: Brand identity.
14
+ - **Surface**: Backgrounds (Light/Dark).
15
+ - **Semantic**: Success (Green), Warning (Orange), Error (Red).
16
+
17
+ ### 2. Typography
18
+ - **Headings**: `Inter Tight`, `Poppins` (Display).
19
+ - **Body**: `Inter`, `Roboto` (Readability).
20
+ - **Code**: `Fira Code`, `JetBrains Mono`.
21
+
22
+ ### 3. Spacing (The Grid)
23
+ Always use multiples of **4px** (0.25rem).
24
+ - `4px` (xs)
25
+ - `8px` (sm)
26
+ - `16px` (md)
27
+ - `24px` (lg)
28
+ - `32px` (xl)
29
+
30
+ ## Component Lifecycle
31
+
32
+ 1. **Design** (`ui-design` persona): Defines the look in `tokens.json` or Figma.
33
+ 2. **Implementation** (`eng-frontend` persona): Builds the React/Vue component.
34
+ 3. **Documentation**: Adds to Storybook or `/docs/components`.
35
+
36
+ ## Accessibility (a11y)
37
+ - **Contrast**: Text must be 4.5:1 against background.
38
+ - **Focus**: Never remove `outline` without providing a custom style.
39
+ - **Motion**: Respect `prefers-reduced-motion`.
40
+
41
+ ## Tools
42
+ - **Tailwind CSS**: The preferred engine for utility-first styling.
43
+ - **Class Variance Authority (CVA)**: For managing component variants.
44
+ - **Radix UI / Headless UI**: For accessible primitives.