agentvibes 2.12.3 → 2.12.5

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 (427) hide show
  1. package/.claude/hooks/play-tts.sh +12 -0
  2. package/.claude/hooks/tts-queue.sh +34 -6
  3. package/README.md +17 -10
  4. package/RELEASE_NOTES.md +153 -752
  5. package/mcp-server/install-deps.js +19 -0
  6. package/package.json +1 -1
  7. package/scripts/fix-audio-tunnel.sh +22 -6
  8. package/src/commands/bmad-voices.js +14 -1
  9. package/src/installer.js +59 -31
  10. package/test/unit/play-tts.bats +1 -1
  11. package/.bmad/_cfg/agent-manifest.csv +0 -11
  12. package/.bmad/_cfg/agent-voice-map.csv +0 -11
  13. package/.bmad/_cfg/agents/bmm-analyst.customize.yaml +0 -42
  14. package/.bmad/_cfg/agents/bmm-architect.customize.yaml +0 -42
  15. package/.bmad/_cfg/agents/bmm-dev.customize.yaml +0 -42
  16. package/.bmad/_cfg/agents/bmm-frame-expert.customize.yaml +0 -42
  17. package/.bmad/_cfg/agents/bmm-pm.customize.yaml +0 -42
  18. package/.bmad/_cfg/agents/bmm-sm.customize.yaml +0 -42
  19. package/.bmad/_cfg/agents/bmm-tea.customize.yaml +0 -42
  20. package/.bmad/_cfg/agents/bmm-tech-writer.customize.yaml +0 -42
  21. package/.bmad/_cfg/agents/bmm-ux-designer.customize.yaml +0 -42
  22. package/.bmad/_cfg/agents/core-bmad-master.customize.yaml +0 -42
  23. package/.bmad/_cfg/files-manifest.csv +0 -243
  24. package/.bmad/_cfg/ides/claude-code.yaml +0 -6
  25. package/.bmad/_cfg/manifest.yaml +0 -9
  26. package/.bmad/_cfg/task-manifest.csv +0 -5
  27. package/.bmad/_cfg/tool-manifest.csv +0 -2
  28. package/.bmad/_cfg/workflow-manifest.csv +0 -38
  29. package/.bmad/bmm/README.md +0 -128
  30. package/.bmad/bmm/agents/analyst.md +0 -79
  31. package/.bmad/bmm/agents/analyst.md.backup-pre-tts +0 -75
  32. package/.bmad/bmm/agents/architect.md +0 -80
  33. package/.bmad/bmm/agents/dev.md +0 -70
  34. package/.bmad/bmm/agents/frame-expert.md +0 -72
  35. package/.bmad/bmm/agents/pm.md +0 -84
  36. package/.bmad/bmm/agents/sm.md +0 -93
  37. package/.bmad/bmm/agents/tea.md +0 -80
  38. package/.bmad/bmm/agents/tech-writer.md +0 -84
  39. package/.bmad/bmm/agents/ux-designer.md +0 -79
  40. package/.bmad/bmm/config.yaml +0 -17
  41. package/.bmad/bmm/docs/README.md +0 -236
  42. package/.bmad/bmm/docs/agents-guide.md +0 -1058
  43. package/.bmad/bmm/docs/brownfield-guide.md +0 -762
  44. package/.bmad/bmm/docs/enterprise-agentic-development.md +0 -686
  45. package/.bmad/bmm/docs/faq.md +0 -588
  46. package/.bmad/bmm/docs/glossary.md +0 -320
  47. package/.bmad/bmm/docs/party-mode.md +0 -224
  48. package/.bmad/bmm/docs/quick-spec-flow.md +0 -652
  49. package/.bmad/bmm/docs/quick-start.md +0 -376
  50. package/.bmad/bmm/docs/scale-adaptive-system.md +0 -612
  51. package/.bmad/bmm/docs/test-architecture.md +0 -396
  52. package/.bmad/bmm/docs/workflow-architecture-reference.md +0 -366
  53. package/.bmad/bmm/docs/workflow-document-project-reference.md +0 -489
  54. package/.bmad/bmm/docs/workflows-analysis.md +0 -370
  55. package/.bmad/bmm/docs/workflows-implementation.md +0 -286
  56. package/.bmad/bmm/docs/workflows-planning.md +0 -612
  57. package/.bmad/bmm/docs/workflows-solutioning.md +0 -554
  58. package/.bmad/bmm/teams/default-party.csv +0 -20
  59. package/.bmad/bmm/teams/team-fullstack.yaml +0 -13
  60. package/.bmad/bmm/testarch/knowledge/ci-burn-in.md +0 -675
  61. package/.bmad/bmm/testarch/knowledge/component-tdd.md +0 -486
  62. package/.bmad/bmm/testarch/knowledge/contract-testing.md +0 -957
  63. package/.bmad/bmm/testarch/knowledge/data-factories.md +0 -500
  64. package/.bmad/bmm/testarch/knowledge/email-auth.md +0 -721
  65. package/.bmad/bmm/testarch/knowledge/error-handling.md +0 -725
  66. package/.bmad/bmm/testarch/knowledge/feature-flags.md +0 -750
  67. package/.bmad/bmm/testarch/knowledge/fixture-architecture.md +0 -401
  68. package/.bmad/bmm/testarch/knowledge/network-first.md +0 -486
  69. package/.bmad/bmm/testarch/knowledge/nfr-criteria.md +0 -670
  70. package/.bmad/bmm/testarch/knowledge/playwright-config.md +0 -730
  71. package/.bmad/bmm/testarch/knowledge/probability-impact.md +0 -601
  72. package/.bmad/bmm/testarch/knowledge/risk-governance.md +0 -615
  73. package/.bmad/bmm/testarch/knowledge/selective-testing.md +0 -732
  74. package/.bmad/bmm/testarch/knowledge/selector-resilience.md +0 -527
  75. package/.bmad/bmm/testarch/knowledge/test-healing-patterns.md +0 -644
  76. package/.bmad/bmm/testarch/knowledge/test-levels-framework.md +0 -473
  77. package/.bmad/bmm/testarch/knowledge/test-priorities-matrix.md +0 -373
  78. package/.bmad/bmm/testarch/knowledge/test-quality.md +0 -664
  79. package/.bmad/bmm/testarch/knowledge/timing-debugging.md +0 -372
  80. package/.bmad/bmm/testarch/knowledge/visual-debugging.md +0 -524
  81. package/.bmad/bmm/testarch/tea-index.csv +0 -22
  82. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/instructions.md +0 -112
  83. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/project-context.md +0 -25
  84. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +0 -26
  85. package/.bmad/bmm/workflows/1-analysis/domain-research/instructions.md +0 -425
  86. package/.bmad/bmm/workflows/1-analysis/domain-research/template.md +0 -180
  87. package/.bmad/bmm/workflows/1-analysis/domain-research/workflow.yaml +0 -28
  88. package/.bmad/bmm/workflows/1-analysis/product-brief/checklist.md +0 -115
  89. package/.bmad/bmm/workflows/1-analysis/product-brief/instructions.md +0 -524
  90. package/.bmad/bmm/workflows/1-analysis/product-brief/template.md +0 -181
  91. package/.bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml +0 -45
  92. package/.bmad/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +0 -144
  93. package/.bmad/bmm/workflows/1-analysis/research/checklist-technical.md +0 -249
  94. package/.bmad/bmm/workflows/1-analysis/research/checklist.md +0 -299
  95. package/.bmad/bmm/workflows/1-analysis/research/claude-code/injections.yaml +0 -114
  96. package/.bmad/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +0 -438
  97. package/.bmad/bmm/workflows/1-analysis/research/instructions-market.md +0 -675
  98. package/.bmad/bmm/workflows/1-analysis/research/instructions-router.md +0 -134
  99. package/.bmad/bmm/workflows/1-analysis/research/instructions-technical.md +0 -534
  100. package/.bmad/bmm/workflows/1-analysis/research/template-deep-prompt.md +0 -94
  101. package/.bmad/bmm/workflows/1-analysis/research/template-market.md +0 -347
  102. package/.bmad/bmm/workflows/1-analysis/research/template-technical.md +0 -245
  103. package/.bmad/bmm/workflows/1-analysis/research/workflow.yaml +0 -44
  104. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md +0 -80
  105. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md +0 -616
  106. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml +0 -53
  107. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/checklist.md +0 -310
  108. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +0 -1308
  109. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +0 -145
  110. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +0 -61
  111. package/.bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +0 -346
  112. package/.bmad/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv +0 -13
  113. package/.bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +0 -703
  114. package/.bmad/bmm/workflows/2-plan-workflows/prd/prd-template.md +0 -204
  115. package/.bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv +0 -11
  116. package/.bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +0 -52
  117. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +0 -217
  118. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +0 -74
  119. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-generate-stories.md +0 -436
  120. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +0 -980
  121. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +0 -181
  122. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +0 -90
  123. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +0 -58
  124. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +0 -321
  125. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-template.md +0 -103
  126. package/.bmad/bmm/workflows/3-solutioning/architecture/checklist.md +0 -240
  127. package/.bmad/bmm/workflows/3-solutioning/architecture/decision-catalog.yaml +0 -222
  128. package/.bmad/bmm/workflows/3-solutioning/architecture/instructions.md +0 -768
  129. package/.bmad/bmm/workflows/3-solutioning/architecture/pattern-categories.csv +0 -13
  130. package/.bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml +0 -55
  131. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/checklist.md +0 -169
  132. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/instructions.md +0 -332
  133. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/template.md +0 -146
  134. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.yaml +0 -62
  135. package/.bmad/bmm/workflows/4-implementation/code-review/backlog_template.md +0 -12
  136. package/.bmad/bmm/workflows/4-implementation/code-review/checklist.md +0 -22
  137. package/.bmad/bmm/workflows/4-implementation/code-review/instructions.md +0 -398
  138. package/.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +0 -60
  139. package/.bmad/bmm/workflows/4-implementation/correct-course/checklist.md +0 -279
  140. package/.bmad/bmm/workflows/4-implementation/correct-course/instructions.md +0 -206
  141. package/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml +0 -56
  142. package/.bmad/bmm/workflows/4-implementation/create-story/checklist.md +0 -240
  143. package/.bmad/bmm/workflows/4-implementation/create-story/instructions.md +0 -256
  144. package/.bmad/bmm/workflows/4-implementation/create-story/template.md +0 -51
  145. package/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +0 -71
  146. package/.bmad/bmm/workflows/4-implementation/dev-story/checklist.md +0 -38
  147. package/.bmad/bmm/workflows/4-implementation/dev-story/instructions.md +0 -267
  148. package/.bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +0 -56
  149. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/checklist.md +0 -17
  150. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/instructions.md +0 -164
  151. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/template.md +0 -76
  152. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +0 -57
  153. package/.bmad/bmm/workflows/4-implementation/retrospective/instructions.md +0 -1443
  154. package/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml +0 -56
  155. package/.bmad/bmm/workflows/4-implementation/sprint-planning/checklist.md +0 -33
  156. package/.bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +0 -234
  157. package/.bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +0 -55
  158. package/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +0 -49
  159. package/.bmad/bmm/workflows/4-implementation/story-context/checklist.md +0 -16
  160. package/.bmad/bmm/workflows/4-implementation/story-context/context-template.xml +0 -34
  161. package/.bmad/bmm/workflows/4-implementation/story-context/instructions.md +0 -209
  162. package/.bmad/bmm/workflows/4-implementation/story-context/workflow.yaml +0 -61
  163. package/.bmad/bmm/workflows/4-implementation/story-done/instructions.md +0 -111
  164. package/.bmad/bmm/workflows/4-implementation/story-done/workflow.yaml +0 -26
  165. package/.bmad/bmm/workflows/4-implementation/story-ready/instructions.md +0 -117
  166. package/.bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml +0 -23
  167. package/.bmad/bmm/workflows/document-project/checklist.md +0 -245
  168. package/.bmad/bmm/workflows/document-project/documentation-requirements.csv +0 -12
  169. package/.bmad/bmm/workflows/document-project/instructions.md +0 -222
  170. package/.bmad/bmm/workflows/document-project/templates/deep-dive-template.md +0 -345
  171. package/.bmad/bmm/workflows/document-project/templates/index-template.md +0 -169
  172. package/.bmad/bmm/workflows/document-project/templates/project-overview-template.md +0 -103
  173. package/.bmad/bmm/workflows/document-project/templates/project-scan-report-schema.json +0 -160
  174. package/.bmad/bmm/workflows/document-project/templates/source-tree-template.md +0 -135
  175. package/.bmad/bmm/workflows/document-project/workflow.yaml +0 -29
  176. package/.bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +0 -298
  177. package/.bmad/bmm/workflows/document-project/workflows/deep-dive.yaml +0 -31
  178. package/.bmad/bmm/workflows/document-project/workflows/full-scan-instructions.md +0 -1106
  179. package/.bmad/bmm/workflows/document-project/workflows/full-scan.yaml +0 -31
  180. package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-helpers.md +0 -127
  181. package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-library.json +0 -90
  182. package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-templates.yaml +0 -127
  183. package/.bmad/bmm/workflows/frame-expert/_shared/validate-json-instructions.md +0 -79
  184. package/.bmad/bmm/workflows/frame-expert/create-dataflow/checklist.md +0 -39
  185. package/.bmad/bmm/workflows/frame-expert/create-dataflow/instructions.md +0 -131
  186. package/.bmad/bmm/workflows/frame-expert/create-dataflow/workflow.yaml +0 -23
  187. package/.bmad/bmm/workflows/frame-expert/create-diagram/checklist.md +0 -43
  188. package/.bmad/bmm/workflows/frame-expert/create-diagram/instructions.md +0 -142
  189. package/.bmad/bmm/workflows/frame-expert/create-diagram/workflow.yaml +0 -24
  190. package/.bmad/bmm/workflows/frame-expert/create-flowchart/checklist.md +0 -49
  191. package/.bmad/bmm/workflows/frame-expert/create-flowchart/instructions.md +0 -242
  192. package/.bmad/bmm/workflows/frame-expert/create-flowchart/workflow.yaml +0 -27
  193. package/.bmad/bmm/workflows/frame-expert/create-wireframe/checklist.md +0 -38
  194. package/.bmad/bmm/workflows/frame-expert/create-wireframe/instructions.md +0 -133
  195. package/.bmad/bmm/workflows/frame-expert/create-wireframe/workflow.yaml +0 -23
  196. package/.bmad/bmm/workflows/techdoc/documentation-standards.md +0 -262
  197. package/.bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +0 -363
  198. package/.bmad/bmm/workflows/testarch/atdd/checklist.md +0 -373
  199. package/.bmad/bmm/workflows/testarch/atdd/instructions.md +0 -785
  200. package/.bmad/bmm/workflows/testarch/atdd/workflow.yaml +0 -45
  201. package/.bmad/bmm/workflows/testarch/automate/checklist.md +0 -580
  202. package/.bmad/bmm/workflows/testarch/automate/instructions.md +0 -1303
  203. package/.bmad/bmm/workflows/testarch/automate/workflow.yaml +0 -52
  204. package/.bmad/bmm/workflows/testarch/ci/checklist.md +0 -246
  205. package/.bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +0 -165
  206. package/.bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +0 -128
  207. package/.bmad/bmm/workflows/testarch/ci/instructions.md +0 -517
  208. package/.bmad/bmm/workflows/testarch/ci/workflow.yaml +0 -45
  209. package/.bmad/bmm/workflows/testarch/framework/checklist.md +0 -321
  210. package/.bmad/bmm/workflows/testarch/framework/instructions.md +0 -455
  211. package/.bmad/bmm/workflows/testarch/framework/workflow.yaml +0 -47
  212. package/.bmad/bmm/workflows/testarch/nfr-assess/checklist.md +0 -405
  213. package/.bmad/bmm/workflows/testarch/nfr-assess/instructions.md +0 -722
  214. package/.bmad/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +0 -443
  215. package/.bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml +0 -47
  216. package/.bmad/bmm/workflows/testarch/test-design/checklist.md +0 -234
  217. package/.bmad/bmm/workflows/testarch/test-design/instructions.md +0 -782
  218. package/.bmad/bmm/workflows/testarch/test-design/test-design-template.md +0 -285
  219. package/.bmad/bmm/workflows/testarch/test-design/workflow.yaml +0 -48
  220. package/.bmad/bmm/workflows/testarch/test-review/checklist.md +0 -470
  221. package/.bmad/bmm/workflows/testarch/test-review/instructions.md +0 -608
  222. package/.bmad/bmm/workflows/testarch/test-review/test-review-template.md +0 -388
  223. package/.bmad/bmm/workflows/testarch/test-review/workflow.yaml +0 -46
  224. package/.bmad/bmm/workflows/testarch/trace/checklist.md +0 -654
  225. package/.bmad/bmm/workflows/testarch/trace/instructions.md +0 -1045
  226. package/.bmad/bmm/workflows/testarch/trace/trace-template.md +0 -673
  227. package/.bmad/bmm/workflows/testarch/trace/workflow.yaml +0 -55
  228. package/.bmad/bmm/workflows/workflow-status/init/instructions.md +0 -334
  229. package/.bmad/bmm/workflows/workflow-status/init/workflow.yaml +0 -28
  230. package/.bmad/bmm/workflows/workflow-status/instructions.md +0 -388
  231. package/.bmad/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +0 -138
  232. package/.bmad/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +0 -126
  233. package/.bmad/bmm/workflows/workflow-status/paths/game-design.yaml +0 -52
  234. package/.bmad/bmm/workflows/workflow-status/paths/method-brownfield.yaml +0 -122
  235. package/.bmad/bmm/workflows/workflow-status/paths/method-greenfield.yaml +0 -113
  236. package/.bmad/bmm/workflows/workflow-status/paths/quick-flow-brownfield.yaml +0 -58
  237. package/.bmad/bmm/workflows/workflow-status/paths/quick-flow-greenfield.yaml +0 -47
  238. package/.bmad/bmm/workflows/workflow-status/project-levels.yaml +0 -59
  239. package/.bmad/bmm/workflows/workflow-status/workflow-status-template.yaml +0 -24
  240. package/.bmad/bmm/workflows/workflow-status/workflow.yaml +0 -28
  241. package/.bmad/core/agents/bmad-master.md +0 -72
  242. package/.bmad/core/agents/bmad-web-orchestrator.agent.xml +0 -113
  243. package/.bmad/core/config.yaml +0 -11
  244. package/.bmad/core/tasks/adv-elicit-methods.csv +0 -39
  245. package/.bmad/core/tasks/advanced-elicitation-methods.csv +0 -21
  246. package/.bmad/core/tasks/advanced-elicitation.xml +0 -106
  247. package/.bmad/core/tasks/index-docs.xml +0 -65
  248. package/.bmad/core/tasks/validate-workflow.xml +0 -89
  249. package/.bmad/core/tasks/workflow.xml +0 -270
  250. package/.bmad/core/tools/shard-doc.xml +0 -109
  251. package/.bmad/core/workflows/brainstorming/README.md +0 -261
  252. package/.bmad/core/workflows/brainstorming/brain-methods.csv +0 -36
  253. package/.bmad/core/workflows/brainstorming/instructions.md +0 -315
  254. package/.bmad/core/workflows/brainstorming/template.md +0 -106
  255. package/.bmad/core/workflows/brainstorming/workflow.yaml +0 -38
  256. package/.bmad/core/workflows/party-mode/instructions.md +0 -203
  257. package/.bmad/core/workflows/party-mode/workflow.yaml +0 -28
  258. package/.bmad/docs/claude-code-instructions.md +0 -25
  259. package/.claude/commands/BMad/analyst.md +0 -88
  260. package/.claude/commands/BMad/architect.md +0 -89
  261. package/.claude/commands/BMad/bmad-master.md +0 -114
  262. package/.claude/commands/BMad/bmad-orchestrator.md +0 -151
  263. package/.claude/commands/BMad/dev.md +0 -85
  264. package/.claude/commands/BMad/pm.md +0 -88
  265. package/.claude/commands/BMad/po.md +0 -83
  266. package/.claude/commands/BMad/qa.md +0 -91
  267. package/.claude/commands/BMad/sm.md +0 -69
  268. package/.claude/commands/BMad/tasks/advanced-elicitation.md +0 -123
  269. package/.claude/commands/BMad/tasks/apply-qa-fixes.md +0 -154
  270. package/.claude/commands/BMad/tasks/brownfield-create-epic.md +0 -166
  271. package/.claude/commands/BMad/tasks/brownfield-create-story.md +0 -153
  272. package/.claude/commands/BMad/tasks/correct-course.md +0 -76
  273. package/.claude/commands/BMad/tasks/create-brownfield-story.md +0 -318
  274. package/.claude/commands/BMad/tasks/create-deep-research-prompt.md +0 -284
  275. package/.claude/commands/BMad/tasks/create-doc.md +0 -107
  276. package/.claude/commands/BMad/tasks/create-next-story.md +0 -118
  277. package/.claude/commands/BMad/tasks/document-project.md +0 -349
  278. package/.claude/commands/BMad/tasks/execute-checklist.md +0 -92
  279. package/.claude/commands/BMad/tasks/facilitate-brainstorming-session.md +0 -142
  280. package/.claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +0 -57
  281. package/.claude/commands/BMad/tasks/index-docs.md +0 -179
  282. package/.claude/commands/BMad/tasks/kb-mode-interaction.md +0 -81
  283. package/.claude/commands/BMad/tasks/nfr-assess.md +0 -349
  284. package/.claude/commands/BMad/tasks/qa-gate.md +0 -167
  285. package/.claude/commands/BMad/tasks/review-story.md +0 -320
  286. package/.claude/commands/BMad/tasks/risk-profile.md +0 -359
  287. package/.claude/commands/BMad/tasks/shard-doc.md +0 -191
  288. package/.claude/commands/BMad/tasks/test-design.md +0 -180
  289. package/.claude/commands/BMad/tasks/trace-requirements.md +0 -270
  290. package/.claude/commands/BMad/tasks/validate-next-story.md +0 -140
  291. package/.claude/commands/BMad/ux-expert.md +0 -73
  292. package/.claude/commands/bmad/bmm/agents/analyst.md +0 -14
  293. package/.claude/commands/bmad/bmm/agents/architect.md +0 -14
  294. package/.claude/commands/bmad/bmm/agents/dev.md +0 -14
  295. package/.claude/commands/bmad/bmm/agents/frame-expert.md +0 -14
  296. package/.claude/commands/bmad/bmm/agents/pm.md +0 -14
  297. package/.claude/commands/bmad/bmm/agents/sm.md +0 -14
  298. package/.claude/commands/bmad/bmm/agents/tea.md +0 -14
  299. package/.claude/commands/bmad/bmm/agents/tech-writer.md +0 -14
  300. package/.claude/commands/bmad/bmm/agents/ux-designer.md +0 -14
  301. package/.claude/commands/bmad/bmm/workflows/architecture.md +0 -13
  302. package/.claude/commands/bmad/bmm/workflows/brainstorm-project.md +0 -13
  303. package/.claude/commands/bmad/bmm/workflows/code-review.md +0 -13
  304. package/.claude/commands/bmad/bmm/workflows/correct-course.md +0 -13
  305. package/.claude/commands/bmad/bmm/workflows/create-dataflow.md +0 -13
  306. package/.claude/commands/bmad/bmm/workflows/create-diagram.md +0 -13
  307. package/.claude/commands/bmad/bmm/workflows/create-epics-and-stories.md +0 -13
  308. package/.claude/commands/bmad/bmm/workflows/create-flowchart.md +0 -13
  309. package/.claude/commands/bmad/bmm/workflows/create-story.md +0 -13
  310. package/.claude/commands/bmad/bmm/workflows/create-ux-design.md +0 -13
  311. package/.claude/commands/bmad/bmm/workflows/create-wireframe.md +0 -13
  312. package/.claude/commands/bmad/bmm/workflows/dev-story.md +0 -13
  313. package/.claude/commands/bmad/bmm/workflows/document-project.md +0 -13
  314. package/.claude/commands/bmad/bmm/workflows/domain-research.md +0 -13
  315. package/.claude/commands/bmad/bmm/workflows/epic-tech-context.md +0 -13
  316. package/.claude/commands/bmad/bmm/workflows/implementation-readiness.md +0 -13
  317. package/.claude/commands/bmad/bmm/workflows/prd.md +0 -13
  318. package/.claude/commands/bmad/bmm/workflows/product-brief.md +0 -13
  319. package/.claude/commands/bmad/bmm/workflows/research.md +0 -13
  320. package/.claude/commands/bmad/bmm/workflows/retrospective.md +0 -13
  321. package/.claude/commands/bmad/bmm/workflows/sprint-planning.md +0 -13
  322. package/.claude/commands/bmad/bmm/workflows/story-context.md +0 -13
  323. package/.claude/commands/bmad/bmm/workflows/story-done.md +0 -13
  324. package/.claude/commands/bmad/bmm/workflows/story-ready.md +0 -13
  325. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +0 -13
  326. package/.claude/commands/bmad/bmm/workflows/workflow-init.md +0 -13
  327. package/.claude/commands/bmad/bmm/workflows/workflow-status.md +0 -13
  328. package/.claude/commands/bmad/core/agents/bmad-master.md +0 -14
  329. package/.claude/commands/bmad/core/tasks/advanced-elicitation.md +0 -9
  330. package/.claude/commands/bmad/core/tasks/index-docs.md +0 -9
  331. package/.claude/commands/bmad/core/tools/shard-doc.md +0 -9
  332. package/.claude/commands/bmad/core/workflows/brainstorming.md +0 -13
  333. package/.claude/commands/bmad/core/workflows/party-mode.md +0 -13
  334. package/.claude/github-star-reminder.txt +0 -1
  335. package/.claude/hooks/bmad-party-manager.sh +0 -225
  336. package/.claude/hooks/stop.sh +0 -221
  337. package/.claude/piper-voices-dir.txt +0 -1
  338. package/.mcp.json +0 -88
  339. package/RELEASE_NOTES_v2.4.0_DRAFT.md +0 -116
  340. package/RELEASE_NOTES_v2.4.1_DRAFT.md +0 -61
  341. package/docs/2025-11-15_15-14-33.snagx +0 -0
  342. package/docs/Screenshot 2025-11-15 151325.png +0 -0
  343. package/docs/Screenshot 2025-11-15 151432.png +0 -0
  344. package/docs/macos-piper-issue.md +0 -172
  345. package/docs/stargazer-cms-prd.md +0 -1918
  346. package/docs/whatsapp-plugin-github-issue.md +0 -393
  347. package/docs/whatsapp-tts-plugin-feasibility.md +0 -418
  348. package/docs/whatsapp-tts-standalone-plugin.md +0 -628
  349. package/github-profile-draft.md +0 -57
  350. package/linkedin/vibe-coding-and-pulseaudio.md +0 -121
  351. package/mcp-server/agentvibes.db +0 -0
  352. package/scripts/audio-tunnel.config +0 -17
  353. package/v4-backup/.bmad-core/agent-teams/team-all.yaml +0 -15
  354. package/v4-backup/.bmad-core/agent-teams/team-fullstack.yaml +0 -19
  355. package/v4-backup/.bmad-core/agent-teams/team-ide-minimal.yaml +0 -11
  356. package/v4-backup/.bmad-core/agent-teams/team-no-ui.yaml +0 -14
  357. package/v4-backup/.bmad-core/agents/analyst.md +0 -84
  358. package/v4-backup/.bmad-core/agents/architect.md +0 -85
  359. package/v4-backup/.bmad-core/agents/bmad-master.md +0 -110
  360. package/v4-backup/.bmad-core/agents/bmad-orchestrator.md +0 -147
  361. package/v4-backup/.bmad-core/agents/dev.md +0 -81
  362. package/v4-backup/.bmad-core/agents/pm.md +0 -84
  363. package/v4-backup/.bmad-core/agents/po.md +0 -79
  364. package/v4-backup/.bmad-core/agents/qa.md +0 -87
  365. package/v4-backup/.bmad-core/agents/sm.md +0 -65
  366. package/v4-backup/.bmad-core/agents/ux-expert.md +0 -69
  367. package/v4-backup/.bmad-core/checklists/architect-checklist.md +0 -440
  368. package/v4-backup/.bmad-core/checklists/change-checklist.md +0 -184
  369. package/v4-backup/.bmad-core/checklists/pm-checklist.md +0 -372
  370. package/v4-backup/.bmad-core/checklists/po-master-checklist.md +0 -434
  371. package/v4-backup/.bmad-core/checklists/story-dod-checklist.md +0 -96
  372. package/v4-backup/.bmad-core/checklists/story-draft-checklist.md +0 -155
  373. package/v4-backup/.bmad-core/core-config.yaml +0 -22
  374. package/v4-backup/.bmad-core/data/bmad-kb.md +0 -809
  375. package/v4-backup/.bmad-core/data/brainstorming-techniques.md +0 -38
  376. package/v4-backup/.bmad-core/data/elicitation-methods.md +0 -156
  377. package/v4-backup/.bmad-core/data/technical-preferences.md +0 -5
  378. package/v4-backup/.bmad-core/data/test-levels-framework.md +0 -148
  379. package/v4-backup/.bmad-core/data/test-priorities-matrix.md +0 -174
  380. package/v4-backup/.bmad-core/enhanced-ide-development-workflow.md +0 -248
  381. package/v4-backup/.bmad-core/install-manifest.yaml +0 -230
  382. package/v4-backup/.bmad-core/tasks/advanced-elicitation.md +0 -119
  383. package/v4-backup/.bmad-core/tasks/apply-qa-fixes.md +0 -150
  384. package/v4-backup/.bmad-core/tasks/brownfield-create-epic.md +0 -162
  385. package/v4-backup/.bmad-core/tasks/brownfield-create-story.md +0 -149
  386. package/v4-backup/.bmad-core/tasks/correct-course.md +0 -72
  387. package/v4-backup/.bmad-core/tasks/create-brownfield-story.md +0 -314
  388. package/v4-backup/.bmad-core/tasks/create-deep-research-prompt.md +0 -280
  389. package/v4-backup/.bmad-core/tasks/create-doc.md +0 -103
  390. package/v4-backup/.bmad-core/tasks/create-next-story.md +0 -114
  391. package/v4-backup/.bmad-core/tasks/document-project.md +0 -345
  392. package/v4-backup/.bmad-core/tasks/execute-checklist.md +0 -88
  393. package/v4-backup/.bmad-core/tasks/facilitate-brainstorming-session.md +0 -138
  394. package/v4-backup/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -53
  395. package/v4-backup/.bmad-core/tasks/index-docs.md +0 -175
  396. package/v4-backup/.bmad-core/tasks/kb-mode-interaction.md +0 -77
  397. package/v4-backup/.bmad-core/tasks/nfr-assess.md +0 -345
  398. package/v4-backup/.bmad-core/tasks/qa-gate.md +0 -163
  399. package/v4-backup/.bmad-core/tasks/review-story.md +0 -316
  400. package/v4-backup/.bmad-core/tasks/risk-profile.md +0 -355
  401. package/v4-backup/.bmad-core/tasks/shard-doc.md +0 -187
  402. package/v4-backup/.bmad-core/tasks/test-design.md +0 -176
  403. package/v4-backup/.bmad-core/tasks/trace-requirements.md +0 -266
  404. package/v4-backup/.bmad-core/tasks/validate-next-story.md +0 -136
  405. package/v4-backup/.bmad-core/templates/architecture-tmpl.yaml +0 -651
  406. package/v4-backup/.bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  407. package/v4-backup/.bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -477
  408. package/v4-backup/.bmad-core/templates/brownfield-prd-tmpl.yaml +0 -281
  409. package/v4-backup/.bmad-core/templates/competitor-analysis-tmpl.yaml +0 -307
  410. package/v4-backup/.bmad-core/templates/front-end-architecture-tmpl.yaml +0 -219
  411. package/v4-backup/.bmad-core/templates/front-end-spec-tmpl.yaml +0 -350
  412. package/v4-backup/.bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -824
  413. package/v4-backup/.bmad-core/templates/market-research-tmpl.yaml +0 -253
  414. package/v4-backup/.bmad-core/templates/prd-tmpl.yaml +0 -203
  415. package/v4-backup/.bmad-core/templates/project-brief-tmpl.yaml +0 -222
  416. package/v4-backup/.bmad-core/templates/qa-gate-tmpl.yaml +0 -103
  417. package/v4-backup/.bmad-core/templates/story-tmpl.yaml +0 -138
  418. package/v4-backup/.bmad-core/user-guide.md +0 -577
  419. package/v4-backup/.bmad-core/utils/bmad-doc-template.md +0 -327
  420. package/v4-backup/.bmad-core/utils/workflow-management.md +0 -71
  421. package/v4-backup/.bmad-core/workflows/brownfield-fullstack.yaml +0 -298
  422. package/v4-backup/.bmad-core/workflows/brownfield-service.yaml +0 -188
  423. package/v4-backup/.bmad-core/workflows/brownfield-ui.yaml +0 -198
  424. package/v4-backup/.bmad-core/workflows/greenfield-fullstack.yaml +0 -241
  425. package/v4-backup/.bmad-core/workflows/greenfield-service.yaml +0 -207
  426. package/v4-backup/.bmad-core/workflows/greenfield-ui.yaml +0 -236
  427. package/v4-backup/.bmad-core/working-in-the-brownfield.md +0 -606
@@ -1,824 +0,0 @@
1
- # <!-- Powered by BMAD™ Core -->
2
- template:
3
- id: fullstack-architecture-template-v2
4
- name: Fullstack Architecture Document
5
- version: 2.0
6
- output:
7
- format: markdown
8
- filename: docs/architecture.md
9
- title: "{{project_name}} Fullstack Architecture Document"
10
-
11
- workflow:
12
- mode: interactive
13
- elicitation: advanced-elicitation
14
-
15
- sections:
16
- - id: introduction
17
- title: Introduction
18
- instruction: |
19
- If available, review any provided relevant documents to gather all relevant context before beginning. At minimum, you should have access to docs/prd.md and docs/front-end-spec.md. Ask the user for any documents you need but cannot locate. This template creates a unified architecture that covers both backend and frontend concerns to guide AI-driven fullstack development.
20
- elicit: true
21
- content: |
22
- This document outlines the complete fullstack architecture for {{project_name}}, including backend systems, frontend implementation, and their integration. It serves as the single source of truth for AI-driven development, ensuring consistency across the entire technology stack.
23
-
24
- This unified approach combines what would traditionally be separate backend and frontend architecture documents, streamlining the development process for modern fullstack applications where these concerns are increasingly intertwined.
25
- sections:
26
- - id: starter-template
27
- title: Starter Template or Existing Project
28
- instruction: |
29
- Before proceeding with architecture design, check if the project is based on any starter templates or existing codebases:
30
-
31
- 1. Review the PRD and other documents for mentions of:
32
- - Fullstack starter templates (e.g., T3 Stack, MEAN/MERN starters, Django + React templates)
33
- - Monorepo templates (e.g., Nx, Turborepo starters)
34
- - Platform-specific starters (e.g., Vercel templates, AWS Amplify starters)
35
- - Existing projects being extended or cloned
36
-
37
- 2. If starter templates or existing projects are mentioned:
38
- - Ask the user to provide access (links, repos, or files)
39
- - Analyze to understand pre-configured choices and constraints
40
- - Note any architectural decisions already made
41
- - Identify what can be modified vs what must be retained
42
-
43
- 3. If no starter is mentioned but this is greenfield:
44
- - Suggest appropriate fullstack starters based on tech preferences
45
- - Consider platform-specific options (Vercel, AWS, etc.)
46
- - Let user decide whether to use one
47
-
48
- 4. Document the decision and any constraints it imposes
49
-
50
- If none, state "N/A - Greenfield project"
51
- - id: changelog
52
- title: Change Log
53
- type: table
54
- columns: [Date, Version, Description, Author]
55
- instruction: Track document versions and changes
56
-
57
- - id: high-level-architecture
58
- title: High Level Architecture
59
- instruction: This section contains multiple subsections that establish the foundation. Present all subsections together, then elicit feedback on the complete section.
60
- elicit: true
61
- sections:
62
- - id: technical-summary
63
- title: Technical Summary
64
- instruction: |
65
- Provide a comprehensive overview (4-6 sentences) covering:
66
- - Overall architectural style and deployment approach
67
- - Frontend framework and backend technology choices
68
- - Key integration points between frontend and backend
69
- - Infrastructure platform and services
70
- - How this architecture achieves PRD goals
71
- - id: platform-infrastructure
72
- title: Platform and Infrastructure Choice
73
- instruction: |
74
- Based on PRD requirements and technical assumptions, make a platform recommendation:
75
-
76
- 1. Consider common patterns (not an exhaustive list, use your own best judgement and search the web as needed for emerging trends):
77
- - **Vercel + Supabase**: For rapid development with Next.js, built-in auth/storage
78
- - **AWS Full Stack**: For enterprise scale with Lambda, API Gateway, S3, Cognito
79
- - **Azure**: For .NET ecosystems or enterprise Microsoft environments
80
- - **Google Cloud**: For ML/AI heavy applications or Google ecosystem integration
81
-
82
- 2. Present 2-3 viable options with clear pros/cons
83
- 3. Make a recommendation with rationale
84
- 4. Get explicit user confirmation
85
-
86
- Document the choice and key services that will be used.
87
- template: |
88
- **Platform:** {{selected_platform}}
89
- **Key Services:** {{core_services_list}}
90
- **Deployment Host and Regions:** {{regions}}
91
- - id: repository-structure
92
- title: Repository Structure
93
- instruction: |
94
- Define the repository approach based on PRD requirements and platform choice, explain your rationale or ask questions to the user if unsure:
95
-
96
- 1. For modern fullstack apps, monorepo is often preferred
97
- 2. Consider tooling (Nx, Turborepo, Lerna, npm workspaces)
98
- 3. Define package/app boundaries
99
- 4. Plan for shared code between frontend and backend
100
- template: |
101
- **Structure:** {{repo_structure_choice}}
102
- **Monorepo Tool:** {{monorepo_tool_if_applicable}}
103
- **Package Organization:** {{package_strategy}}
104
- - id: architecture-diagram
105
- title: High Level Architecture Diagram
106
- type: mermaid
107
- mermaid_type: graph
108
- instruction: |
109
- Create a Mermaid diagram showing the complete system architecture including:
110
- - User entry points (web, mobile)
111
- - Frontend application deployment
112
- - API layer (REST/GraphQL)
113
- - Backend services
114
- - Databases and storage
115
- - External integrations
116
- - CDN and caching layers
117
-
118
- Use appropriate diagram type for clarity.
119
- - id: architectural-patterns
120
- title: Architectural Patterns
121
- instruction: |
122
- List patterns that will guide both frontend and backend development. Include patterns for:
123
- - Overall architecture (e.g., Jamstack, Serverless, Microservices)
124
- - Frontend patterns (e.g., Component-based, State management)
125
- - Backend patterns (e.g., Repository, CQRS, Event-driven)
126
- - Integration patterns (e.g., BFF, API Gateway)
127
-
128
- For each pattern, provide recommendation and rationale.
129
- repeatable: true
130
- template: "- **{{pattern_name}}:** {{pattern_description}} - _Rationale:_ {{rationale}}"
131
- examples:
132
- - "**Jamstack Architecture:** Static site generation with serverless APIs - _Rationale:_ Optimal performance and scalability for content-heavy applications"
133
- - "**Component-Based UI:** Reusable React components with TypeScript - _Rationale:_ Maintainability and type safety across large codebases"
134
- - "**Repository Pattern:** Abstract data access logic - _Rationale:_ Enables testing and future database migration flexibility"
135
- - "**API Gateway Pattern:** Single entry point for all API calls - _Rationale:_ Centralized auth, rate limiting, and monitoring"
136
-
137
- - id: tech-stack
138
- title: Tech Stack
139
- instruction: |
140
- This is the DEFINITIVE technology selection for the entire project. Work with user to finalize all choices. This table is the single source of truth - all development must use these exact versions.
141
-
142
- Key areas to cover:
143
- - Frontend and backend languages/frameworks
144
- - Databases and caching
145
- - Authentication and authorization
146
- - API approach
147
- - Testing tools for both frontend and backend
148
- - Build and deployment tools
149
- - Monitoring and logging
150
-
151
- Upon render, elicit feedback immediately.
152
- elicit: true
153
- sections:
154
- - id: tech-stack-table
155
- title: Technology Stack Table
156
- type: table
157
- columns: [Category, Technology, Version, Purpose, Rationale]
158
- rows:
159
- - ["Frontend Language", "{{fe_language}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
160
- - [
161
- "Frontend Framework",
162
- "{{fe_framework}}",
163
- "{{version}}",
164
- "{{purpose}}",
165
- "{{why_chosen}}",
166
- ]
167
- - [
168
- "UI Component Library",
169
- "{{ui_library}}",
170
- "{{version}}",
171
- "{{purpose}}",
172
- "{{why_chosen}}",
173
- ]
174
- - ["State Management", "{{state_mgmt}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
175
- - ["Backend Language", "{{be_language}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
176
- - [
177
- "Backend Framework",
178
- "{{be_framework}}",
179
- "{{version}}",
180
- "{{purpose}}",
181
- "{{why_chosen}}",
182
- ]
183
- - ["API Style", "{{api_style}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
184
- - ["Database", "{{database}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
185
- - ["Cache", "{{cache}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
186
- - ["File Storage", "{{storage}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
187
- - ["Authentication", "{{auth}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
188
- - ["Frontend Testing", "{{fe_test}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
189
- - ["Backend Testing", "{{be_test}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
190
- - ["E2E Testing", "{{e2e_test}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
191
- - ["Build Tool", "{{build_tool}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
192
- - ["Bundler", "{{bundler}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
193
- - ["IaC Tool", "{{iac_tool}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
194
- - ["CI/CD", "{{cicd}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
195
- - ["Monitoring", "{{monitoring}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
196
- - ["Logging", "{{logging}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
197
- - ["CSS Framework", "{{css_framework}}", "{{version}}", "{{purpose}}", "{{why_chosen}}"]
198
-
199
- - id: data-models
200
- title: Data Models
201
- instruction: |
202
- Define the core data models/entities that will be shared between frontend and backend:
203
-
204
- 1. Review PRD requirements and identify key business entities
205
- 2. For each model, explain its purpose and relationships
206
- 3. Include key attributes and data types
207
- 4. Show relationships between models
208
- 5. Create TypeScript interfaces that can be shared
209
- 6. Discuss design decisions with user
210
-
211
- Create a clear conceptual model before moving to database schema.
212
- elicit: true
213
- repeatable: true
214
- sections:
215
- - id: model
216
- title: "{{model_name}}"
217
- template: |
218
- **Purpose:** {{model_purpose}}
219
-
220
- **Key Attributes:**
221
- - {{attribute_1}}: {{type_1}} - {{description_1}}
222
- - {{attribute_2}}: {{type_2}} - {{description_2}}
223
- sections:
224
- - id: typescript-interface
225
- title: TypeScript Interface
226
- type: code
227
- language: typescript
228
- template: "{{model_interface}}"
229
- - id: relationships
230
- title: Relationships
231
- type: bullet-list
232
- template: "- {{relationship}}"
233
-
234
- - id: api-spec
235
- title: API Specification
236
- instruction: |
237
- Based on the chosen API style from Tech Stack:
238
-
239
- 1. If REST API, create an OpenAPI 3.0 specification
240
- 2. If GraphQL, provide the GraphQL schema
241
- 3. If tRPC, show router definitions
242
- 4. Include all endpoints from epics/stories
243
- 5. Define request/response schemas based on data models
244
- 6. Document authentication requirements
245
- 7. Include example requests/responses
246
-
247
- Use appropriate format for the chosen API style. If no API (e.g., static site), skip this section.
248
- elicit: true
249
- sections:
250
- - id: rest-api
251
- title: REST API Specification
252
- condition: API style is REST
253
- type: code
254
- language: yaml
255
- template: |
256
- openapi: 3.0.0
257
- info:
258
- title: {{api_title}}
259
- version: {{api_version}}
260
- description: {{api_description}}
261
- servers:
262
- - url: {{server_url}}
263
- description: {{server_description}}
264
- - id: graphql-api
265
- title: GraphQL Schema
266
- condition: API style is GraphQL
267
- type: code
268
- language: graphql
269
- template: "{{graphql_schema}}"
270
- - id: trpc-api
271
- title: tRPC Router Definitions
272
- condition: API style is tRPC
273
- type: code
274
- language: typescript
275
- template: "{{trpc_routers}}"
276
-
277
- - id: components
278
- title: Components
279
- instruction: |
280
- Based on the architectural patterns, tech stack, and data models from above:
281
-
282
- 1. Identify major logical components/services across the fullstack
283
- 2. Consider both frontend and backend components
284
- 3. Define clear boundaries and interfaces between components
285
- 4. For each component, specify:
286
- - Primary responsibility
287
- - Key interfaces/APIs exposed
288
- - Dependencies on other components
289
- - Technology specifics based on tech stack choices
290
-
291
- 5. Create component diagrams where helpful
292
- elicit: true
293
- sections:
294
- - id: component-list
295
- repeatable: true
296
- title: "{{component_name}}"
297
- template: |
298
- **Responsibility:** {{component_description}}
299
-
300
- **Key Interfaces:**
301
- - {{interface_1}}
302
- - {{interface_2}}
303
-
304
- **Dependencies:** {{dependencies}}
305
-
306
- **Technology Stack:** {{component_tech_details}}
307
- - id: component-diagrams
308
- title: Component Diagrams
309
- type: mermaid
310
- instruction: |
311
- Create Mermaid diagrams to visualize component relationships. Options:
312
- - C4 Container diagram for high-level view
313
- - Component diagram for detailed internal structure
314
- - Sequence diagrams for complex interactions
315
- Choose the most appropriate for clarity
316
-
317
- - id: external-apis
318
- title: External APIs
319
- condition: Project requires external API integrations
320
- instruction: |
321
- For each external service integration:
322
-
323
- 1. Identify APIs needed based on PRD requirements and component design
324
- 2. If documentation URLs are unknown, ask user for specifics
325
- 3. Document authentication methods and security considerations
326
- 4. List specific endpoints that will be used
327
- 5. Note any rate limits or usage constraints
328
-
329
- If no external APIs are needed, state this explicitly and skip to next section.
330
- elicit: true
331
- repeatable: true
332
- sections:
333
- - id: api
334
- title: "{{api_name}} API"
335
- template: |
336
- - **Purpose:** {{api_purpose}}
337
- - **Documentation:** {{api_docs_url}}
338
- - **Base URL(s):** {{api_base_url}}
339
- - **Authentication:** {{auth_method}}
340
- - **Rate Limits:** {{rate_limits}}
341
-
342
- **Key Endpoints Used:**
343
- - `{{method}} {{endpoint_path}}` - {{endpoint_purpose}}
344
-
345
- **Integration Notes:** {{integration_considerations}}
346
-
347
- - id: core-workflows
348
- title: Core Workflows
349
- type: mermaid
350
- mermaid_type: sequence
351
- instruction: |
352
- Illustrate key system workflows using sequence diagrams:
353
-
354
- 1. Identify critical user journeys from PRD
355
- 2. Show component interactions including external APIs
356
- 3. Include both frontend and backend flows
357
- 4. Include error handling paths
358
- 5. Document async operations
359
- 6. Create both high-level and detailed diagrams as needed
360
-
361
- Focus on workflows that clarify architecture decisions or complex interactions.
362
- elicit: true
363
-
364
- - id: database-schema
365
- title: Database Schema
366
- instruction: |
367
- Transform the conceptual data models into concrete database schemas:
368
-
369
- 1. Use the database type(s) selected in Tech Stack
370
- 2. Create schema definitions using appropriate notation
371
- 3. Include indexes, constraints, and relationships
372
- 4. Consider performance and scalability
373
- 5. For NoSQL, show document structures
374
-
375
- Present schema in format appropriate to database type (SQL DDL, JSON schema, etc.)
376
- elicit: true
377
-
378
- - id: frontend-architecture
379
- title: Frontend Architecture
380
- instruction: Define frontend-specific architecture details. After each subsection, note if user wants to refine before continuing.
381
- elicit: true
382
- sections:
383
- - id: component-architecture
384
- title: Component Architecture
385
- instruction: Define component organization and patterns based on chosen framework.
386
- sections:
387
- - id: component-organization
388
- title: Component Organization
389
- type: code
390
- language: text
391
- template: "{{component_structure}}"
392
- - id: component-template
393
- title: Component Template
394
- type: code
395
- language: typescript
396
- template: "{{component_template}}"
397
- - id: state-management
398
- title: State Management Architecture
399
- instruction: Detail state management approach based on chosen solution.
400
- sections:
401
- - id: state-structure
402
- title: State Structure
403
- type: code
404
- language: typescript
405
- template: "{{state_structure}}"
406
- - id: state-patterns
407
- title: State Management Patterns
408
- type: bullet-list
409
- template: "- {{pattern}}"
410
- - id: routing-architecture
411
- title: Routing Architecture
412
- instruction: Define routing structure based on framework choice.
413
- sections:
414
- - id: route-organization
415
- title: Route Organization
416
- type: code
417
- language: text
418
- template: "{{route_structure}}"
419
- - id: protected-routes
420
- title: Protected Route Pattern
421
- type: code
422
- language: typescript
423
- template: "{{protected_route_example}}"
424
- - id: frontend-services
425
- title: Frontend Services Layer
426
- instruction: Define how frontend communicates with backend.
427
- sections:
428
- - id: api-client-setup
429
- title: API Client Setup
430
- type: code
431
- language: typescript
432
- template: "{{api_client_setup}}"
433
- - id: service-example
434
- title: Service Example
435
- type: code
436
- language: typescript
437
- template: "{{service_example}}"
438
-
439
- - id: backend-architecture
440
- title: Backend Architecture
441
- instruction: Define backend-specific architecture details. Consider serverless vs traditional server approaches.
442
- elicit: true
443
- sections:
444
- - id: service-architecture
445
- title: Service Architecture
446
- instruction: Based on platform choice, define service organization.
447
- sections:
448
- - id: serverless-architecture
449
- condition: Serverless architecture chosen
450
- sections:
451
- - id: function-organization
452
- title: Function Organization
453
- type: code
454
- language: text
455
- template: "{{function_structure}}"
456
- - id: function-template
457
- title: Function Template
458
- type: code
459
- language: typescript
460
- template: "{{function_template}}"
461
- - id: traditional-server
462
- condition: Traditional server architecture chosen
463
- sections:
464
- - id: controller-organization
465
- title: Controller/Route Organization
466
- type: code
467
- language: text
468
- template: "{{controller_structure}}"
469
- - id: controller-template
470
- title: Controller Template
471
- type: code
472
- language: typescript
473
- template: "{{controller_template}}"
474
- - id: database-architecture
475
- title: Database Architecture
476
- instruction: Define database schema and access patterns.
477
- sections:
478
- - id: schema-design
479
- title: Schema Design
480
- type: code
481
- language: sql
482
- template: "{{database_schema}}"
483
- - id: data-access-layer
484
- title: Data Access Layer
485
- type: code
486
- language: typescript
487
- template: "{{repository_pattern}}"
488
- - id: auth-architecture
489
- title: Authentication and Authorization
490
- instruction: Define auth implementation details.
491
- sections:
492
- - id: auth-flow
493
- title: Auth Flow
494
- type: mermaid
495
- mermaid_type: sequence
496
- template: "{{auth_flow_diagram}}"
497
- - id: auth-middleware
498
- title: Middleware/Guards
499
- type: code
500
- language: typescript
501
- template: "{{auth_middleware}}"
502
-
503
- - id: unified-project-structure
504
- title: Unified Project Structure
505
- instruction: Create a monorepo structure that accommodates both frontend and backend. Adapt based on chosen tools and frameworks.
506
- elicit: true
507
- type: code
508
- language: plaintext
509
- examples:
510
- - |
511
- {{project-name}}/
512
- ├── .github/ # CI/CD workflows
513
- │ └── workflows/
514
- │ ├── ci.yaml
515
- │ └── deploy.yaml
516
- ├── apps/ # Application packages
517
- │ ├── web/ # Frontend application
518
- │ │ ├── src/
519
- │ │ │ ├── components/ # UI components
520
- │ │ │ ├── pages/ # Page components/routes
521
- │ │ │ ├── hooks/ # Custom React hooks
522
- │ │ │ ├── services/ # API client services
523
- │ │ │ ├── stores/ # State management
524
- │ │ │ ├── styles/ # Global styles/themes
525
- │ │ │ └── utils/ # Frontend utilities
526
- │ │ ├── public/ # Static assets
527
- │ │ ├── tests/ # Frontend tests
528
- │ │ └── package.json
529
- │ └── api/ # Backend application
530
- │ ├── src/
531
- │ │ ├── routes/ # API routes/controllers
532
- │ │ ├── services/ # Business logic
533
- │ │ ├── models/ # Data models
534
- │ │ ├── middleware/ # Express/API middleware
535
- │ │ ├── utils/ # Backend utilities
536
- │ │ └── {{serverless_or_server_entry}}
537
- │ ├── tests/ # Backend tests
538
- │ └── package.json
539
- ├── packages/ # Shared packages
540
- │ ├── shared/ # Shared types/utilities
541
- │ │ ├── src/
542
- │ │ │ ├── types/ # TypeScript interfaces
543
- │ │ │ ├── constants/ # Shared constants
544
- │ │ │ └── utils/ # Shared utilities
545
- │ │ └── package.json
546
- │ ├── ui/ # Shared UI components
547
- │ │ ├── src/
548
- │ │ └── package.json
549
- │ └── config/ # Shared configuration
550
- │ ├── eslint/
551
- │ ├── typescript/
552
- │ └── jest/
553
- ├── infrastructure/ # IaC definitions
554
- │ └── {{iac_structure}}
555
- ├── scripts/ # Build/deploy scripts
556
- ├── docs/ # Documentation
557
- │ ├── prd.md
558
- │ ├── front-end-spec.md
559
- │ └── fullstack-architecture.md
560
- ├── .env.example # Environment template
561
- ├── package.json # Root package.json
562
- ├── {{monorepo_config}} # Monorepo configuration
563
- └── README.md
564
-
565
- - id: development-workflow
566
- title: Development Workflow
567
- instruction: Define the development setup and workflow for the fullstack application.
568
- elicit: true
569
- sections:
570
- - id: local-setup
571
- title: Local Development Setup
572
- sections:
573
- - id: prerequisites
574
- title: Prerequisites
575
- type: code
576
- language: bash
577
- template: "{{prerequisites_commands}}"
578
- - id: initial-setup
579
- title: Initial Setup
580
- type: code
581
- language: bash
582
- template: "{{setup_commands}}"
583
- - id: dev-commands
584
- title: Development Commands
585
- type: code
586
- language: bash
587
- template: |
588
- # Start all services
589
- {{start_all_command}}
590
-
591
- # Start frontend only
592
- {{start_frontend_command}}
593
-
594
- # Start backend only
595
- {{start_backend_command}}
596
-
597
- # Run tests
598
- {{test_commands}}
599
- - id: environment-config
600
- title: Environment Configuration
601
- sections:
602
- - id: env-vars
603
- title: Required Environment Variables
604
- type: code
605
- language: bash
606
- template: |
607
- # Frontend (.env.local)
608
- {{frontend_env_vars}}
609
-
610
- # Backend (.env)
611
- {{backend_env_vars}}
612
-
613
- # Shared
614
- {{shared_env_vars}}
615
-
616
- - id: deployment-architecture
617
- title: Deployment Architecture
618
- instruction: Define deployment strategy based on platform choice.
619
- elicit: true
620
- sections:
621
- - id: deployment-strategy
622
- title: Deployment Strategy
623
- template: |
624
- **Frontend Deployment:**
625
- - **Platform:** {{frontend_deploy_platform}}
626
- - **Build Command:** {{frontend_build_command}}
627
- - **Output Directory:** {{frontend_output_dir}}
628
- - **CDN/Edge:** {{cdn_strategy}}
629
-
630
- **Backend Deployment:**
631
- - **Platform:** {{backend_deploy_platform}}
632
- - **Build Command:** {{backend_build_command}}
633
- - **Deployment Method:** {{deployment_method}}
634
- - id: cicd-pipeline
635
- title: CI/CD Pipeline
636
- type: code
637
- language: yaml
638
- template: "{{cicd_pipeline_config}}"
639
- - id: environments
640
- title: Environments
641
- type: table
642
- columns: [Environment, Frontend URL, Backend URL, Purpose]
643
- rows:
644
- - ["Development", "{{dev_fe_url}}", "{{dev_be_url}}", "Local development"]
645
- - ["Staging", "{{staging_fe_url}}", "{{staging_be_url}}", "Pre-production testing"]
646
- - ["Production", "{{prod_fe_url}}", "{{prod_be_url}}", "Live environment"]
647
-
648
- - id: security-performance
649
- title: Security and Performance
650
- instruction: Define security and performance considerations for the fullstack application.
651
- elicit: true
652
- sections:
653
- - id: security-requirements
654
- title: Security Requirements
655
- template: |
656
- **Frontend Security:**
657
- - CSP Headers: {{csp_policy}}
658
- - XSS Prevention: {{xss_strategy}}
659
- - Secure Storage: {{storage_strategy}}
660
-
661
- **Backend Security:**
662
- - Input Validation: {{validation_approach}}
663
- - Rate Limiting: {{rate_limit_config}}
664
- - CORS Policy: {{cors_config}}
665
-
666
- **Authentication Security:**
667
- - Token Storage: {{token_strategy}}
668
- - Session Management: {{session_approach}}
669
- - Password Policy: {{password_requirements}}
670
- - id: performance-optimization
671
- title: Performance Optimization
672
- template: |
673
- **Frontend Performance:**
674
- - Bundle Size Target: {{bundle_size}}
675
- - Loading Strategy: {{loading_approach}}
676
- - Caching Strategy: {{fe_cache_strategy}}
677
-
678
- **Backend Performance:**
679
- - Response Time Target: {{response_target}}
680
- - Database Optimization: {{db_optimization}}
681
- - Caching Strategy: {{be_cache_strategy}}
682
-
683
- - id: testing-strategy
684
- title: Testing Strategy
685
- instruction: Define comprehensive testing approach for fullstack application.
686
- elicit: true
687
- sections:
688
- - id: testing-pyramid
689
- title: Testing Pyramid
690
- type: code
691
- language: text
692
- template: |
693
- E2E Tests
694
- / \
695
- Integration Tests
696
- / \
697
- Frontend Unit Backend Unit
698
- - id: test-organization
699
- title: Test Organization
700
- sections:
701
- - id: frontend-tests
702
- title: Frontend Tests
703
- type: code
704
- language: text
705
- template: "{{frontend_test_structure}}"
706
- - id: backend-tests
707
- title: Backend Tests
708
- type: code
709
- language: text
710
- template: "{{backend_test_structure}}"
711
- - id: e2e-tests
712
- title: E2E Tests
713
- type: code
714
- language: text
715
- template: "{{e2e_test_structure}}"
716
- - id: test-examples
717
- title: Test Examples
718
- sections:
719
- - id: frontend-test
720
- title: Frontend Component Test
721
- type: code
722
- language: typescript
723
- template: "{{frontend_test_example}}"
724
- - id: backend-test
725
- title: Backend API Test
726
- type: code
727
- language: typescript
728
- template: "{{backend_test_example}}"
729
- - id: e2e-test
730
- title: E2E Test
731
- type: code
732
- language: typescript
733
- template: "{{e2e_test_example}}"
734
-
735
- - id: coding-standards
736
- title: Coding Standards
737
- instruction: Define MINIMAL but CRITICAL standards for AI agents. Focus only on project-specific rules that prevent common mistakes. These will be used by dev agents.
738
- elicit: true
739
- sections:
740
- - id: critical-rules
741
- title: Critical Fullstack Rules
742
- repeatable: true
743
- template: "- **{{rule_name}}:** {{rule_description}}"
744
- examples:
745
- - "**Type Sharing:** Always define types in packages/shared and import from there"
746
- - "**API Calls:** Never make direct HTTP calls - use the service layer"
747
- - "**Environment Variables:** Access only through config objects, never process.env directly"
748
- - "**Error Handling:** All API routes must use the standard error handler"
749
- - "**State Updates:** Never mutate state directly - use proper state management patterns"
750
- - id: naming-conventions
751
- title: Naming Conventions
752
- type: table
753
- columns: [Element, Frontend, Backend, Example]
754
- rows:
755
- - ["Components", "PascalCase", "-", "`UserProfile.tsx`"]
756
- - ["Hooks", "camelCase with 'use'", "-", "`useAuth.ts`"]
757
- - ["API Routes", "-", "kebab-case", "`/api/user-profile`"]
758
- - ["Database Tables", "-", "snake_case", "`user_profiles`"]
759
-
760
- - id: error-handling
761
- title: Error Handling Strategy
762
- instruction: Define unified error handling across frontend and backend.
763
- elicit: true
764
- sections:
765
- - id: error-flow
766
- title: Error Flow
767
- type: mermaid
768
- mermaid_type: sequence
769
- template: "{{error_flow_diagram}}"
770
- - id: error-format
771
- title: Error Response Format
772
- type: code
773
- language: typescript
774
- template: |
775
- interface ApiError {
776
- error: {
777
- code: string;
778
- message: string;
779
- details?: Record<string, any>;
780
- timestamp: string;
781
- requestId: string;
782
- };
783
- }
784
- - id: frontend-error-handling
785
- title: Frontend Error Handling
786
- type: code
787
- language: typescript
788
- template: "{{frontend_error_handler}}"
789
- - id: backend-error-handling
790
- title: Backend Error Handling
791
- type: code
792
- language: typescript
793
- template: "{{backend_error_handler}}"
794
-
795
- - id: monitoring
796
- title: Monitoring and Observability
797
- instruction: Define monitoring strategy for fullstack application.
798
- elicit: true
799
- sections:
800
- - id: monitoring-stack
801
- title: Monitoring Stack
802
- template: |
803
- - **Frontend Monitoring:** {{frontend_monitoring}}
804
- - **Backend Monitoring:** {{backend_monitoring}}
805
- - **Error Tracking:** {{error_tracking}}
806
- - **Performance Monitoring:** {{perf_monitoring}}
807
- - id: key-metrics
808
- title: Key Metrics
809
- template: |
810
- **Frontend Metrics:**
811
- - Core Web Vitals
812
- - JavaScript errors
813
- - API response times
814
- - User interactions
815
-
816
- **Backend Metrics:**
817
- - Request rate
818
- - Error rate
819
- - Response time
820
- - Database query performance
821
-
822
- - id: checklist-results
823
- title: Checklist Results Report
824
- instruction: Before running the checklist, offer to output the full architecture document. Once user confirms, execute the architect-checklist and populate results here.