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,259 @@
1
+ # Technical Specification: [Feature Name]
2
+ <!-- Derived from: PRD.md — do not start before PRD is approved -->
3
+ <!-- Created by: prod-architect / agent | Date: [date] -->
4
+
5
+ ---
6
+
7
+ ## 1. Overview
8
+
9
+ **Feature:** [Name from PRD]
10
+ **PRD Reference:** [link to PRD.md]
11
+ **SDLC Phase:** S03 — Specification
12
+ **Spec author:** [agent/human]
13
+
14
+ ---
15
+
16
+ ## 2. Architecture Impact
17
+
18
+ **Affected layers:**
19
+ - [ ] Domain (new entities, value objects, domain events)
20
+ - [ ] Application (new use cases, command/query handlers)
21
+ - [ ] Adapters (new controllers, presenters, gateways)
22
+ - [ ] Infrastructure (new repository implementations, external API clients)
23
+ - [ ] Main/Bootstrap (new wiring)
24
+
25
+ **New services/modules:**
26
+ - `[ModuleName]` — [brief purpose]
27
+
28
+ **Modified existing files:**
29
+ - `[file path]` — [what changes]
30
+
31
+ **New files to create:**
32
+ - `[file path]` — [purpose]
33
+
34
+ ---
35
+
36
+ ## 3. Database Changes
37
+
38
+ ### New Tables
39
+ ```sql
40
+ CREATE TABLE [table_name] (
41
+ id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
42
+ [field] [type] NOT NULL,
43
+ created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
44
+ updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
45
+ );
46
+
47
+ CREATE INDEX idx_[table]_[field] ON [table_name]([field]);
48
+ ```
49
+
50
+ ### Modified Tables
51
+ ```sql
52
+ -- Migration: [migration_name]
53
+ ALTER TABLE [table_name] ADD COLUMN [field] [type] [constraints];
54
+ ```
55
+
56
+ ### Rollback Plan
57
+ ```sql
58
+ -- Rollback
59
+ ALTER TABLE [table_name] DROP COLUMN IF EXISTS [field];
60
+ ```
61
+
62
+ ### ORM Schema (Prisma example)
63
+ ```prisma
64
+ model [ModelName] {
65
+ id String @id @default(uuid())
66
+ [field] [Type]
67
+ createdAt DateTime @default(now())
68
+ updatedAt DateTime @updatedAt
69
+
70
+ @@map("[table_name]")
71
+ }
72
+ ```
73
+
74
+ ---
75
+
76
+ ## 4. API Contracts
77
+
78
+ ### Endpoints
79
+
80
+ #### POST /api/v1/[resource]
81
+ ```yaml
82
+ Request:
83
+ Content-Type: application/json
84
+ Authorization: Bearer {token}
85
+ Body:
86
+ [field]: string (required, max: 255)
87
+ [field]: string (required, email format)
88
+
89
+ Response 201 Created:
90
+ Content-Type: application/json
91
+ Body:
92
+ id: uuid
93
+ [field]: string
94
+ createdAt: ISO 8601 datetime
95
+
96
+ Response 422 Unprocessable Entity:
97
+ Body:
98
+ error:
99
+ code: "VALIDATION_ERROR"
100
+ message: "Validation failed"
101
+ details:
102
+ - field: "[field_name]"
103
+ code: "REQUIRED"
104
+ message: "[field] is required"
105
+
106
+ Response 401 Unauthorized:
107
+ Body:
108
+ error:
109
+ code: "UNAUTHORIZED"
110
+ message: "Authentication required"
111
+ ```
112
+
113
+ ---
114
+
115
+ ## 5. Domain Model
116
+
117
+ ### Entities
118
+
119
+ ```typescript
120
+ // src/domain/[entity].ts
121
+ interface [Entity] {
122
+ id: string; // UUID
123
+ [field]: string; // [constraints]
124
+ createdAt: Date;
125
+ updatedAt: Date;
126
+ }
127
+
128
+ // Domain invariants:
129
+ // - [field] must be [constraint]
130
+ // - [entity] cannot be [invalid state]
131
+ ```
132
+
133
+ ### Domain Events
134
+
135
+ ```typescript
136
+ // Events emitted by this feature
137
+ interface [EntityCreatedEvent] {
138
+ type: '[ENTITY]_CREATED';
139
+ payload: { id: string; [field]: string; };
140
+ occurredAt: Date;
141
+ }
142
+ ```
143
+
144
+ ### Value Objects
145
+
146
+ ```typescript
147
+ // src/domain/value-objects/[name].ts
148
+ class [ValueObjectName] {
149
+ private readonly value: string;
150
+
151
+ private constructor(value: string) {
152
+ this.value = value;
153
+ }
154
+
155
+ static create(value: string): Result<[ValueObjectName], ValidationError> {
156
+ if (!isValid(value)) {
157
+ return Result.fail(new ValidationError('[validation message]'));
158
+ }
159
+ return Result.ok(new [ValueObjectName](value));
160
+ }
161
+
162
+ toString(): string { return this.value; }
163
+ }
164
+ ```
165
+
166
+ ---
167
+
168
+ ## 6. Use Cases / Application Services
169
+
170
+ ```typescript
171
+ // src/application/[feature]/[action]-[entity].use-case.ts
172
+
173
+ interface [Action][Entity]Command {
174
+ [field]: string;
175
+ }
176
+
177
+ interface [Action][Entity]Result {
178
+ id: string;
179
+ [field]: string;
180
+ }
181
+
182
+ class [Action][Entity]UseCase {
183
+ constructor(
184
+ private readonly [entity]Repository: I[Entity]Repository,
185
+ private readonly eventBus: IEventBus,
186
+ ) {}
187
+
188
+ async execute(command: [Action][Entity]Command): Promise<[Action][Entity]Result> {
189
+ // 1. Validate input (domain validation)
190
+ // 2. Apply business rules
191
+ // 3. Persist via repository
192
+ // 4. Emit domain event
193
+ // 5. Return result DTO
194
+ }
195
+ }
196
+ ```
197
+
198
+ ---
199
+
200
+ ## 7. Testing Strategy
201
+
202
+ ### Unit Tests
203
+ ```
204
+ src/domain/[entity].test.ts
205
+ - validates [field] format correctly
206
+ - rejects invalid [field] values
207
+ - domain event is emitted on creation
208
+
209
+ src/application/[feature]/[action]-[entity].use-case.test.ts
210
+ - creates [entity] with valid input
211
+ - returns 422 when [field] is invalid
212
+ - calls repository.save() with correct data
213
+ - emits [ENTITY_CREATED] event on success
214
+ ```
215
+
216
+ ### Integration Tests
217
+ ```
218
+ tests/integration/api/[resource].test.ts
219
+ - POST /api/v1/[resource] with valid body returns 201
220
+ - POST /api/v1/[resource] with missing field returns 422
221
+ - POST /api/v1/[resource] without auth returns 401
222
+ - GET /api/v1/[resource] returns paginated list
223
+ ```
224
+
225
+ ### Coverage Target
226
+ - Domain layer: > 99%
227
+ - Application layer: > 85%
228
+ - Adapters layer: > 99% (integration tests)
229
+
230
+ ---
231
+
232
+ ## 8. Security Decisions
233
+
234
+ **Authentication:** [JWT / Session / API Key / None]
235
+ **Authorization:** [RBAC rules — who can access this endpoint]
236
+ **Input validation:** [Zod schema / FormRequest / validator.js]
237
+ **Rate limiting:** [X requests/minute per IP / per user]
238
+ **Data sanitization:** [HTML entities escaped / SQL parameterized]
239
+
240
+ **Threat model reference:** [link to docs/security/threat-models/]
241
+
242
+ ---
243
+
244
+ ## 9. Feature Flags / Rollout
245
+
246
+ **Feature flag:** [Yes/No — flag name if yes]
247
+ **Rollout strategy:** [All users at once / Percentage rollout / Internal only first]
248
+ **Rollback trigger:** [Error rate > X% / manual decision]
249
+
250
+ ---
251
+
252
+ ## 10. Approval
253
+
254
+ | Role | Name | Status | Date |
255
+ |---|---|---|---|
256
+ | Tech Lead | [name] | [APPROVED / PENDING] | [date] |
257
+ | Security | [name] | [APPROVED / PENDING] | [date] |
258
+
259
+ **Human approval required before proceeding to Tasks phase (S04).**
@@ -0,0 +1,127 @@
1
+ # Stakeholder Register — [System Name]
2
+ <!-- Created by: req-elicitation.skill or prod-pm persona -->
3
+ <!-- Referenced by: PRD.md, ARCHITECTURE_REVIEW_TEMPLATE.md -->
4
+ <!-- Update when: new stakeholders identified, roles change, concerns evolve -->
5
+
6
+ ---
7
+
8
+ ## Meta
9
+
10
+ | Field | Value |
11
+ |---|---|
12
+ | **System / Feature** | [system or feature name] |
13
+ | **Version** | [1.0] |
14
+ | **Date** | [YYYY-MM-DD] |
15
+ | **Author** | [agent/human] |
16
+
17
+ ---
18
+
19
+ ## Stakeholder Categories
20
+
21
+ ```
22
+ Direct Users: People who directly operate or use the system
23
+ Indirect Users: People affected by system outputs without operating it
24
+ System Owners: People accountable for the system's existence and funding
25
+ External Systems: Other systems (automated actors) that integrate
26
+ Regulators: Authorities with compliance requirements over the system
27
+ ```
28
+
29
+ ---
30
+
31
+ ## Stakeholder Register
32
+
33
+ | ID | Name / Role | Category | Goals | Concerns | Influence | Interest | Communication |
34
+ |---|---|---|---|---|---|---|---|
35
+ | SH-001 | [Role name e.g. "End Customer"] | Direct User | [What they want to achieve] | [What they fear or care about most] | H/M/L | H/M/L | [How/when to communicate with them] |
36
+ | SH-002 | [Role name e.g. "Operations Team"] | Direct User | | | | | |
37
+ | SH-003 | [Role name e.g. "Product Owner"] | System Owner | | | | | |
38
+ | SH-004 | [External system name] | External System | | | | | |
39
+ | SH-005 | [Regulatory body] | Regulator | | | | | |
40
+
41
+ **Influence**: How much can they change system direction?
42
+ **Interest**: How affected are they by system outcomes?
43
+
44
+ ---
45
+
46
+ ## Stakeholder Engagement Matrix
47
+
48
+ ```
49
+ High Interest + High Influence → MANAGE CLOSELY (primary stakeholders)
50
+ High Interest + Low Influence → KEEP INFORMED
51
+ Low Interest + High Influence → KEEP SATISFIED
52
+ Low Interest + Low Influence → MONITOR (minimal effort)
53
+ ```
54
+
55
+ | Stakeholder | Interest | Influence | Engagement Strategy |
56
+ |---|---|---|---|
57
+ | [SH-001] | H | H | MANAGE CLOSELY — weekly updates, approval gates |
58
+ | [SH-002] | H | L | KEEP INFORMED — bi-weekly reports |
59
+ | [SH-003] | L | H | KEEP SATISFIED — milestone reviews |
60
+
61
+ ---
62
+
63
+ ## Stakeholder Concerns Catalog
64
+
65
+ For each primary stakeholder, document their key concerns:
66
+
67
+ ### SH-001: [Role Name]
68
+
69
+ **Goals:**
70
+ - [Primary objective 1]
71
+ - [Primary objective 2]
72
+
73
+ **Concerns / Fears:**
74
+ - [What they're afraid the system will do wrong]
75
+ - [What risks worry them]
76
+
77
+ **Success Criteria:**
78
+ - [How this stakeholder knows the system succeeded]
79
+ - [Measurable: "Order confirmation received within 30 seconds"]
80
+
81
+ **Required Consultations:**
82
+ - [Phase S01 requirements approval]
83
+ - [Phase S08 final review]
84
+
85
+ ---
86
+
87
+ ### SH-002: [Role Name]
88
+
89
+ **Goals:**
90
+ -
91
+
92
+ **Concerns / Fears:**
93
+ -
94
+
95
+ **Success Criteria:**
96
+ -
97
+
98
+ **Required Consultations:**
99
+ -
100
+
101
+ <!-- Repeat for each primary stakeholder (Influence=H or Interest=H) -->
102
+
103
+ ---
104
+
105
+ ## Conflicting Concerns
106
+
107
+ Document any stakeholder concerns that conflict with each other:
108
+
109
+ | Conflict | SH-A concern | SH-B concern | Resolution approach |
110
+ |---|---|---|---|
111
+ | [Conflict 1] | [SH-001 wants X] | [SH-003 wants not-X] | [How to resolve or escalate] |
112
+
113
+ ---
114
+
115
+ ## Stakeholder Sign-off Requirements
116
+
117
+ | Phase Gate | Required Sign-off | Stakeholder |
118
+ |---|---|---|
119
+ | S01 — Requirements | Approval of PRD.md | [SH-001, SH-003] |
120
+ | S02 — Architecture | Approval of PLAN.md | [SH-003] |
121
+ | S08 — Human Review | Final code/product review | [SH-003] |
122
+
123
+ ---
124
+
125
+ ## Notes
126
+
127
+ [Any additional context about stakeholders, organizational dynamics, or communication constraints]
@@ -0,0 +1,35 @@
1
+ # User Story Map
2
+
3
+ **Product**: [Name]
4
+ **Date**: [YYYY-MM-DD]
5
+ **Goal**: [e.g., MVP Launch]
6
+
7
+ ## 1. The Backbone (User Journey)
8
+ | Activity 1 (Sign Up) | Activity 2 (Search) | Activity 3 (Purchase) | Activity 4 (Admin) |
9
+ |---|---|---|---|
10
+
11
+ ## 2. Release Slicing
12
+
13
+ ### Release 1: The "Walking Skeleton" (MVP)
14
+ *Goal: Proof of Value, End-to-End connectivity*
15
+ - [ ] [Sign Up] Register with Email
16
+ - [ ] [Search] By Keyword
17
+ - [ ] [Purchase] Credit Card (Stripe)
18
+ - [ ] [Admin] View Orders
19
+
20
+ ### Release 2: The "Marketable Product" (v1.0)
21
+ *Goal: Optimization and Retention*
22
+ - [ ] [Sign Up] Google SSO
23
+ - [ ] [Search] Filters (Price, Date)
24
+ - [ ] [Purchase] PayPal, Saved Cards
25
+ - [ ] [Admin] Refund Orders
26
+
27
+ ### Release 3: The "Scale" (v2.0)
28
+ *Goal: Enterprise features*
29
+ - [ ] [Sign Up] SAML / SSO
30
+ - [ ] [Search] AI Recommendation
31
+ - [ ] [Admin] Analytics Dashboard
32
+
33
+ ## 3. Assumptions & Risks
34
+ - [ ] Assumption: Stripe approval takes < 2 days.
35
+ - [ ] Risk: Search latency might be high for v1 without Elasticsearch.
@@ -0,0 +1,207 @@
1
+ # Visual Spec Package: [Project Name]
2
+
3
+ <!-- Complete visual design artifacts — fill before proceeding to implementation -->
4
+ <!-- Created by: visual-specs.skill | Date: [date] -->
5
+ <!-- Depends on: Approved PRD (S01) -->
6
+
7
+ ---
8
+
9
+ ## 1. System Architecture
10
+
11
+ ### 1.1 C4 Context Diagram
12
+ <!-- High-level: system boundary, external actors, neighboring systems -->
13
+ <!-- Use Mermaid for simple (<15 nodes), Excalidraw for complex -->
14
+
15
+ **Diagram file**: [path to .excalidraw / .drawio or Mermaid below]
16
+
17
+ ```mermaid
18
+ %% Replace with actual C4 Context diagram
19
+ flowchart TD
20
+ User[External User] --> System[System Name]
21
+ System --> DB[(Database)]
22
+ System --> ExtAPI[External API]
23
+ ```
24
+
25
+ ### 1.2 C4 Container Diagram (if multi-service)
26
+ <!-- Internal containers: services, databases, message queues, etc. -->
27
+
28
+ **Diagram file**: [path or Mermaid below]
29
+
30
+ ### 1.3 C4 Component Diagram (if complex service)
31
+ <!-- Internal components within a single container -->
32
+
33
+ **Diagram file**: [path or Mermaid below]
34
+
35
+ ---
36
+
37
+ ## 2. Workflow & State Diagrams
38
+
39
+ ### 2.1 Primary User Flow
40
+ <!-- Main happy-path workflow from user action to system response -->
41
+
42
+ **Diagram file**: [path or Mermaid below]
43
+
44
+ ```mermaid
45
+ %% Replace with actual flowchart
46
+ flowchart TD
47
+ A[Start] --> B{Decision?}
48
+ B -->|Yes| C[Action A]
49
+ B -->|No| D[Action B]
50
+ C --> E[End]
51
+ D --> E
52
+ ```
53
+
54
+ ### 2.2 State Machine: [Entity Name]
55
+ <!-- For entities with >3 states — orders, payments, sessions, etc. -->
56
+
57
+ **Diagram file**: [path or Mermaid below]
58
+
59
+ ```mermaid
60
+ %% Replace with actual state diagram
61
+ stateDiagram-v2
62
+ [*] --> Draft
63
+ Draft --> Submitted: submit()
64
+ Submitted --> Approved: approve()
65
+ Submitted --> Rejected: reject()
66
+ Approved --> [*]
67
+ Rejected --> Draft: revise()
68
+ ```
69
+
70
+ ### 2.3 Additional Workflows
71
+ <!-- Error flows, admin flows, batch processes, etc. -->
72
+
73
+ ---
74
+
75
+ ## 3. UI/UX Design
76
+
77
+ ### 3.1 Key Screen Wireframes
78
+ <!-- Use tldraw for wireframes, Figma for high-fidelity -->
79
+
80
+ | Screen | Wireframe File | Description |
81
+ |---|---|---|
82
+ | [Login] | [path/to/login.tldr] | [Email/password form, OAuth buttons] |
83
+ | [Dashboard] | [path/to/dashboard.tldr] | [Summary cards, recent activity] |
84
+ | [Detail Page] | [path/to/detail.tldr] | [Entity details, edit form, actions] |
85
+
86
+ ### 3.2 Screen Flow / Navigation
87
+ <!-- How screens connect — page navigation map -->
88
+
89
+ **Diagram file**: [path or Mermaid below]
90
+
91
+ ```mermaid
92
+ %% Replace with actual navigation flow
93
+ flowchart LR
94
+ Login --> Dashboard
95
+ Dashboard --> Detail
96
+ Dashboard --> Settings
97
+ Detail --> Edit
98
+ Edit --> Detail
99
+ ```
100
+
101
+ ### 3.3 Component Hierarchy
102
+ <!-- Reusable UI components and their nesting -->
103
+
104
+ ---
105
+
106
+ ## 4. Data Model
107
+
108
+ ### 4.1 ER Diagram
109
+ <!-- Entity-Relationship model for persistent storage -->
110
+
111
+ **Diagram file**: [path or Mermaid below]
112
+
113
+ ```mermaid
114
+ %% Replace with actual ER diagram
115
+ erDiagram
116
+ USER ||--o{ ORDER : places
117
+ ORDER ||--|{ LINE_ITEM : contains
118
+ LINE_ITEM }|--|| PRODUCT : references
119
+ USER {
120
+ uuid id PK
121
+ string email UK
122
+ string name
123
+ timestamp created_at
124
+ }
125
+ ORDER {
126
+ uuid id PK
127
+ uuid user_id FK
128
+ string status
129
+ decimal total
130
+ timestamp created_at
131
+ }
132
+ ```
133
+
134
+ ### 4.2 Data Flow
135
+ <!-- How data moves through the system — input → processing → storage → output -->
136
+
137
+ ---
138
+
139
+ ## 5. Use Cases & Interactions
140
+
141
+ ### 5.1 Sequence Diagram: [Primary Use Case]
142
+ <!-- Actor-system interaction for the main flow -->
143
+
144
+ **Diagram file**: [path or Mermaid below]
145
+
146
+ ```mermaid
147
+ %% Replace with actual sequence diagram
148
+ sequenceDiagram
149
+ actor User
150
+ participant Frontend
151
+ participant API
152
+ participant DB
153
+ User->>Frontend: Submit form
154
+ Frontend->>API: POST /api/resource
155
+ API->>DB: INSERT record
156
+ DB-->>API: OK
157
+ API-->>Frontend: 201 Created
158
+ Frontend-->>User: Success message
159
+ ```
160
+
161
+ ### 5.2 Additional Use Cases
162
+ <!-- Error scenarios, admin use cases, batch operations -->
163
+
164
+ ---
165
+
166
+ ## 6. Visual Input Log
167
+
168
+ <!-- Track all original visual inputs and their recognition results -->
169
+
170
+ | # | Input Image | Type | Recognition Result | Output Diagram | Confidence |
171
+ |---|---|---|---|---|---|
172
+ | 1 | [path/to/whiteboard.jpg] | Architecture | [Recognized N nodes, M edges] | [path/to/arch.excalidraw] | [HIGH/MED/LOW] |
173
+ | 2 | [path/to/wireframe.jpg] | UI Wireframe | [Recognized N elements] | [path/to/screens.tldr] | [HIGH/MED/LOW] |
174
+ | 3 | [path/to/flowchart.jpg] | Flowchart | [Recognized N steps, M decisions] | [Mermaid in Section 2] | [HIGH/MED/LOW] |
175
+
176
+ ---
177
+
178
+ ## 7. Design Readiness Checklist
179
+
180
+ **All required items must pass before proceeding to S02 Architecture / S03 Implementation.**
181
+
182
+ ### Required
183
+ - [ ] System architecture diagram (C4 Context minimum) — present and human-verified
184
+ - [ ] Primary user workflow diagrammed (flowchart/sequence)
185
+ - [ ] Data model / ER diagram documented (if persistent storage involved)
186
+ - [ ] All user-provided visual inputs processed and documented in Section 6
187
+ - [ ] All diagrams committed to version control
188
+
189
+ ### Recommended (for UI-facing projects)
190
+ - [ ] UI wireframes for key screens created (tldraw/Figma)
191
+ - [ ] Screen flow / navigation diagram present
192
+ - [ ] Component hierarchy documented
193
+
194
+ ### Optional (for complex systems)
195
+ - [ ] State diagrams for entities with >3 states
196
+ - [ ] Sequence diagrams for cross-service interactions
197
+ - [ ] Deployment / infrastructure diagram
198
+ - [ ] Use case diagram for actor-system boundaries
199
+
200
+ ### Approval
201
+ | Role | Name | Status | Date |
202
+ |---|---|---|---|
203
+ | Product | [name] | [APPROVED / PENDING] | [date] |
204
+ | Engineering | [name] | [APPROVED / PENDING] | [date] |
205
+ | Design | [name] | [APPROVED / PENDING] | [date] |
206
+
207
+ **Human approval required before proceeding to Architecture/Implementation phase.**