agentvibes 2.12.4 → 2.12.6

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 (429) hide show
  1. package/.claude/hooks/bmad-voice-manager.sh +21 -5
  2. package/.claude/hooks/play-tts.sh +12 -0
  3. package/.claude/hooks/tts-queue.sh +34 -6
  4. package/README.md +17 -10
  5. package/RELEASE_NOTES.md +320 -697
  6. package/mcp-server/install-deps.js +19 -0
  7. package/mcp-server/server.py +58 -36
  8. package/package.json +1 -1
  9. package/scripts/fix-audio-tunnel.sh +22 -6
  10. package/src/commands/bmad-voices.js +14 -1
  11. package/src/installer.js +157 -72
  12. package/test/unit/play-tts.bats +1 -1
  13. package/.bmad/_cfg/agent-manifest.csv +0 -11
  14. package/.bmad/_cfg/agent-voice-map.csv +0 -11
  15. package/.bmad/_cfg/agents/bmm-analyst.customize.yaml +0 -42
  16. package/.bmad/_cfg/agents/bmm-architect.customize.yaml +0 -42
  17. package/.bmad/_cfg/agents/bmm-dev.customize.yaml +0 -42
  18. package/.bmad/_cfg/agents/bmm-frame-expert.customize.yaml +0 -42
  19. package/.bmad/_cfg/agents/bmm-pm.customize.yaml +0 -42
  20. package/.bmad/_cfg/agents/bmm-sm.customize.yaml +0 -42
  21. package/.bmad/_cfg/agents/bmm-tea.customize.yaml +0 -42
  22. package/.bmad/_cfg/agents/bmm-tech-writer.customize.yaml +0 -42
  23. package/.bmad/_cfg/agents/bmm-ux-designer.customize.yaml +0 -42
  24. package/.bmad/_cfg/agents/core-bmad-master.customize.yaml +0 -42
  25. package/.bmad/_cfg/files-manifest.csv +0 -243
  26. package/.bmad/_cfg/ides/claude-code.yaml +0 -6
  27. package/.bmad/_cfg/manifest.yaml +0 -9
  28. package/.bmad/_cfg/task-manifest.csv +0 -5
  29. package/.bmad/_cfg/tool-manifest.csv +0 -2
  30. package/.bmad/_cfg/workflow-manifest.csv +0 -38
  31. package/.bmad/bmm/README.md +0 -128
  32. package/.bmad/bmm/agents/analyst.md +0 -79
  33. package/.bmad/bmm/agents/analyst.md.backup-pre-tts +0 -75
  34. package/.bmad/bmm/agents/architect.md +0 -80
  35. package/.bmad/bmm/agents/dev.md +0 -70
  36. package/.bmad/bmm/agents/frame-expert.md +0 -72
  37. package/.bmad/bmm/agents/pm.md +0 -84
  38. package/.bmad/bmm/agents/sm.md +0 -93
  39. package/.bmad/bmm/agents/tea.md +0 -80
  40. package/.bmad/bmm/agents/tech-writer.md +0 -84
  41. package/.bmad/bmm/agents/ux-designer.md +0 -79
  42. package/.bmad/bmm/config.yaml +0 -17
  43. package/.bmad/bmm/docs/README.md +0 -236
  44. package/.bmad/bmm/docs/agents-guide.md +0 -1058
  45. package/.bmad/bmm/docs/brownfield-guide.md +0 -762
  46. package/.bmad/bmm/docs/enterprise-agentic-development.md +0 -686
  47. package/.bmad/bmm/docs/faq.md +0 -588
  48. package/.bmad/bmm/docs/glossary.md +0 -320
  49. package/.bmad/bmm/docs/party-mode.md +0 -224
  50. package/.bmad/bmm/docs/quick-spec-flow.md +0 -652
  51. package/.bmad/bmm/docs/quick-start.md +0 -376
  52. package/.bmad/bmm/docs/scale-adaptive-system.md +0 -612
  53. package/.bmad/bmm/docs/test-architecture.md +0 -396
  54. package/.bmad/bmm/docs/workflow-architecture-reference.md +0 -366
  55. package/.bmad/bmm/docs/workflow-document-project-reference.md +0 -489
  56. package/.bmad/bmm/docs/workflows-analysis.md +0 -370
  57. package/.bmad/bmm/docs/workflows-implementation.md +0 -286
  58. package/.bmad/bmm/docs/workflows-planning.md +0 -612
  59. package/.bmad/bmm/docs/workflows-solutioning.md +0 -554
  60. package/.bmad/bmm/teams/default-party.csv +0 -20
  61. package/.bmad/bmm/teams/team-fullstack.yaml +0 -13
  62. package/.bmad/bmm/testarch/knowledge/ci-burn-in.md +0 -675
  63. package/.bmad/bmm/testarch/knowledge/component-tdd.md +0 -486
  64. package/.bmad/bmm/testarch/knowledge/contract-testing.md +0 -957
  65. package/.bmad/bmm/testarch/knowledge/data-factories.md +0 -500
  66. package/.bmad/bmm/testarch/knowledge/email-auth.md +0 -721
  67. package/.bmad/bmm/testarch/knowledge/error-handling.md +0 -725
  68. package/.bmad/bmm/testarch/knowledge/feature-flags.md +0 -750
  69. package/.bmad/bmm/testarch/knowledge/fixture-architecture.md +0 -401
  70. package/.bmad/bmm/testarch/knowledge/network-first.md +0 -486
  71. package/.bmad/bmm/testarch/knowledge/nfr-criteria.md +0 -670
  72. package/.bmad/bmm/testarch/knowledge/playwright-config.md +0 -730
  73. package/.bmad/bmm/testarch/knowledge/probability-impact.md +0 -601
  74. package/.bmad/bmm/testarch/knowledge/risk-governance.md +0 -615
  75. package/.bmad/bmm/testarch/knowledge/selective-testing.md +0 -732
  76. package/.bmad/bmm/testarch/knowledge/selector-resilience.md +0 -527
  77. package/.bmad/bmm/testarch/knowledge/test-healing-patterns.md +0 -644
  78. package/.bmad/bmm/testarch/knowledge/test-levels-framework.md +0 -473
  79. package/.bmad/bmm/testarch/knowledge/test-priorities-matrix.md +0 -373
  80. package/.bmad/bmm/testarch/knowledge/test-quality.md +0 -664
  81. package/.bmad/bmm/testarch/knowledge/timing-debugging.md +0 -372
  82. package/.bmad/bmm/testarch/knowledge/visual-debugging.md +0 -524
  83. package/.bmad/bmm/testarch/tea-index.csv +0 -22
  84. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/instructions.md +0 -112
  85. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/project-context.md +0 -25
  86. package/.bmad/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +0 -26
  87. package/.bmad/bmm/workflows/1-analysis/domain-research/instructions.md +0 -425
  88. package/.bmad/bmm/workflows/1-analysis/domain-research/template.md +0 -180
  89. package/.bmad/bmm/workflows/1-analysis/domain-research/workflow.yaml +0 -28
  90. package/.bmad/bmm/workflows/1-analysis/product-brief/checklist.md +0 -115
  91. package/.bmad/bmm/workflows/1-analysis/product-brief/instructions.md +0 -524
  92. package/.bmad/bmm/workflows/1-analysis/product-brief/template.md +0 -181
  93. package/.bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml +0 -45
  94. package/.bmad/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +0 -144
  95. package/.bmad/bmm/workflows/1-analysis/research/checklist-technical.md +0 -249
  96. package/.bmad/bmm/workflows/1-analysis/research/checklist.md +0 -299
  97. package/.bmad/bmm/workflows/1-analysis/research/claude-code/injections.yaml +0 -114
  98. package/.bmad/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +0 -438
  99. package/.bmad/bmm/workflows/1-analysis/research/instructions-market.md +0 -675
  100. package/.bmad/bmm/workflows/1-analysis/research/instructions-router.md +0 -134
  101. package/.bmad/bmm/workflows/1-analysis/research/instructions-technical.md +0 -534
  102. package/.bmad/bmm/workflows/1-analysis/research/template-deep-prompt.md +0 -94
  103. package/.bmad/bmm/workflows/1-analysis/research/template-market.md +0 -347
  104. package/.bmad/bmm/workflows/1-analysis/research/template-technical.md +0 -245
  105. package/.bmad/bmm/workflows/1-analysis/research/workflow.yaml +0 -44
  106. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md +0 -80
  107. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md +0 -616
  108. package/.bmad/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml +0 -53
  109. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/checklist.md +0 -310
  110. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +0 -1308
  111. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +0 -145
  112. package/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +0 -61
  113. package/.bmad/bmm/workflows/2-plan-workflows/prd/checklist.md +0 -346
  114. package/.bmad/bmm/workflows/2-plan-workflows/prd/domain-complexity.csv +0 -13
  115. package/.bmad/bmm/workflows/2-plan-workflows/prd/instructions.md +0 -703
  116. package/.bmad/bmm/workflows/2-plan-workflows/prd/prd-template.md +0 -204
  117. package/.bmad/bmm/workflows/2-plan-workflows/prd/project-types.csv +0 -11
  118. package/.bmad/bmm/workflows/2-plan-workflows/prd/workflow.yaml +0 -52
  119. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +0 -217
  120. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +0 -74
  121. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions-generate-stories.md +0 -436
  122. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +0 -980
  123. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/tech-spec-template.md +0 -181
  124. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/user-story-template.md +0 -90
  125. package/.bmad/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +0 -58
  126. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +0 -321
  127. package/.bmad/bmm/workflows/3-solutioning/architecture/architecture-template.md +0 -103
  128. package/.bmad/bmm/workflows/3-solutioning/architecture/checklist.md +0 -240
  129. package/.bmad/bmm/workflows/3-solutioning/architecture/decision-catalog.yaml +0 -222
  130. package/.bmad/bmm/workflows/3-solutioning/architecture/instructions.md +0 -768
  131. package/.bmad/bmm/workflows/3-solutioning/architecture/pattern-categories.csv +0 -13
  132. package/.bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml +0 -55
  133. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/checklist.md +0 -169
  134. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/instructions.md +0 -332
  135. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/template.md +0 -146
  136. package/.bmad/bmm/workflows/3-solutioning/implementation-readiness/workflow.yaml +0 -62
  137. package/.bmad/bmm/workflows/4-implementation/code-review/backlog_template.md +0 -12
  138. package/.bmad/bmm/workflows/4-implementation/code-review/checklist.md +0 -22
  139. package/.bmad/bmm/workflows/4-implementation/code-review/instructions.md +0 -398
  140. package/.bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +0 -60
  141. package/.bmad/bmm/workflows/4-implementation/correct-course/checklist.md +0 -279
  142. package/.bmad/bmm/workflows/4-implementation/correct-course/instructions.md +0 -206
  143. package/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml +0 -56
  144. package/.bmad/bmm/workflows/4-implementation/create-story/checklist.md +0 -240
  145. package/.bmad/bmm/workflows/4-implementation/create-story/instructions.md +0 -256
  146. package/.bmad/bmm/workflows/4-implementation/create-story/template.md +0 -51
  147. package/.bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +0 -71
  148. package/.bmad/bmm/workflows/4-implementation/dev-story/checklist.md +0 -38
  149. package/.bmad/bmm/workflows/4-implementation/dev-story/instructions.md +0 -267
  150. package/.bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +0 -56
  151. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/checklist.md +0 -17
  152. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/instructions.md +0 -164
  153. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/template.md +0 -76
  154. package/.bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +0 -57
  155. package/.bmad/bmm/workflows/4-implementation/retrospective/instructions.md +0 -1443
  156. package/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml +0 -56
  157. package/.bmad/bmm/workflows/4-implementation/sprint-planning/checklist.md +0 -33
  158. package/.bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +0 -234
  159. package/.bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +0 -55
  160. package/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +0 -49
  161. package/.bmad/bmm/workflows/4-implementation/story-context/checklist.md +0 -16
  162. package/.bmad/bmm/workflows/4-implementation/story-context/context-template.xml +0 -34
  163. package/.bmad/bmm/workflows/4-implementation/story-context/instructions.md +0 -209
  164. package/.bmad/bmm/workflows/4-implementation/story-context/workflow.yaml +0 -61
  165. package/.bmad/bmm/workflows/4-implementation/story-done/instructions.md +0 -111
  166. package/.bmad/bmm/workflows/4-implementation/story-done/workflow.yaml +0 -26
  167. package/.bmad/bmm/workflows/4-implementation/story-ready/instructions.md +0 -117
  168. package/.bmad/bmm/workflows/4-implementation/story-ready/workflow.yaml +0 -23
  169. package/.bmad/bmm/workflows/document-project/checklist.md +0 -245
  170. package/.bmad/bmm/workflows/document-project/documentation-requirements.csv +0 -12
  171. package/.bmad/bmm/workflows/document-project/instructions.md +0 -222
  172. package/.bmad/bmm/workflows/document-project/templates/deep-dive-template.md +0 -345
  173. package/.bmad/bmm/workflows/document-project/templates/index-template.md +0 -169
  174. package/.bmad/bmm/workflows/document-project/templates/project-overview-template.md +0 -103
  175. package/.bmad/bmm/workflows/document-project/templates/project-scan-report-schema.json +0 -160
  176. package/.bmad/bmm/workflows/document-project/templates/source-tree-template.md +0 -135
  177. package/.bmad/bmm/workflows/document-project/workflow.yaml +0 -29
  178. package/.bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +0 -298
  179. package/.bmad/bmm/workflows/document-project/workflows/deep-dive.yaml +0 -31
  180. package/.bmad/bmm/workflows/document-project/workflows/full-scan-instructions.md +0 -1106
  181. package/.bmad/bmm/workflows/document-project/workflows/full-scan.yaml +0 -31
  182. package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-helpers.md +0 -127
  183. package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-library.json +0 -90
  184. package/.bmad/bmm/workflows/frame-expert/_shared/excalidraw-templates.yaml +0 -127
  185. package/.bmad/bmm/workflows/frame-expert/_shared/validate-json-instructions.md +0 -79
  186. package/.bmad/bmm/workflows/frame-expert/create-dataflow/checklist.md +0 -39
  187. package/.bmad/bmm/workflows/frame-expert/create-dataflow/instructions.md +0 -131
  188. package/.bmad/bmm/workflows/frame-expert/create-dataflow/workflow.yaml +0 -23
  189. package/.bmad/bmm/workflows/frame-expert/create-diagram/checklist.md +0 -43
  190. package/.bmad/bmm/workflows/frame-expert/create-diagram/instructions.md +0 -142
  191. package/.bmad/bmm/workflows/frame-expert/create-diagram/workflow.yaml +0 -24
  192. package/.bmad/bmm/workflows/frame-expert/create-flowchart/checklist.md +0 -49
  193. package/.bmad/bmm/workflows/frame-expert/create-flowchart/instructions.md +0 -242
  194. package/.bmad/bmm/workflows/frame-expert/create-flowchart/workflow.yaml +0 -27
  195. package/.bmad/bmm/workflows/frame-expert/create-wireframe/checklist.md +0 -38
  196. package/.bmad/bmm/workflows/frame-expert/create-wireframe/instructions.md +0 -133
  197. package/.bmad/bmm/workflows/frame-expert/create-wireframe/workflow.yaml +0 -23
  198. package/.bmad/bmm/workflows/techdoc/documentation-standards.md +0 -262
  199. package/.bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +0 -363
  200. package/.bmad/bmm/workflows/testarch/atdd/checklist.md +0 -373
  201. package/.bmad/bmm/workflows/testarch/atdd/instructions.md +0 -785
  202. package/.bmad/bmm/workflows/testarch/atdd/workflow.yaml +0 -45
  203. package/.bmad/bmm/workflows/testarch/automate/checklist.md +0 -580
  204. package/.bmad/bmm/workflows/testarch/automate/instructions.md +0 -1303
  205. package/.bmad/bmm/workflows/testarch/automate/workflow.yaml +0 -52
  206. package/.bmad/bmm/workflows/testarch/ci/checklist.md +0 -246
  207. package/.bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +0 -165
  208. package/.bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +0 -128
  209. package/.bmad/bmm/workflows/testarch/ci/instructions.md +0 -517
  210. package/.bmad/bmm/workflows/testarch/ci/workflow.yaml +0 -45
  211. package/.bmad/bmm/workflows/testarch/framework/checklist.md +0 -321
  212. package/.bmad/bmm/workflows/testarch/framework/instructions.md +0 -455
  213. package/.bmad/bmm/workflows/testarch/framework/workflow.yaml +0 -47
  214. package/.bmad/bmm/workflows/testarch/nfr-assess/checklist.md +0 -405
  215. package/.bmad/bmm/workflows/testarch/nfr-assess/instructions.md +0 -722
  216. package/.bmad/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +0 -443
  217. package/.bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml +0 -47
  218. package/.bmad/bmm/workflows/testarch/test-design/checklist.md +0 -234
  219. package/.bmad/bmm/workflows/testarch/test-design/instructions.md +0 -782
  220. package/.bmad/bmm/workflows/testarch/test-design/test-design-template.md +0 -285
  221. package/.bmad/bmm/workflows/testarch/test-design/workflow.yaml +0 -48
  222. package/.bmad/bmm/workflows/testarch/test-review/checklist.md +0 -470
  223. package/.bmad/bmm/workflows/testarch/test-review/instructions.md +0 -608
  224. package/.bmad/bmm/workflows/testarch/test-review/test-review-template.md +0 -388
  225. package/.bmad/bmm/workflows/testarch/test-review/workflow.yaml +0 -46
  226. package/.bmad/bmm/workflows/testarch/trace/checklist.md +0 -654
  227. package/.bmad/bmm/workflows/testarch/trace/instructions.md +0 -1045
  228. package/.bmad/bmm/workflows/testarch/trace/trace-template.md +0 -673
  229. package/.bmad/bmm/workflows/testarch/trace/workflow.yaml +0 -55
  230. package/.bmad/bmm/workflows/workflow-status/init/instructions.md +0 -334
  231. package/.bmad/bmm/workflows/workflow-status/init/workflow.yaml +0 -28
  232. package/.bmad/bmm/workflows/workflow-status/instructions.md +0 -388
  233. package/.bmad/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +0 -138
  234. package/.bmad/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +0 -126
  235. package/.bmad/bmm/workflows/workflow-status/paths/game-design.yaml +0 -52
  236. package/.bmad/bmm/workflows/workflow-status/paths/method-brownfield.yaml +0 -122
  237. package/.bmad/bmm/workflows/workflow-status/paths/method-greenfield.yaml +0 -113
  238. package/.bmad/bmm/workflows/workflow-status/paths/quick-flow-brownfield.yaml +0 -58
  239. package/.bmad/bmm/workflows/workflow-status/paths/quick-flow-greenfield.yaml +0 -47
  240. package/.bmad/bmm/workflows/workflow-status/project-levels.yaml +0 -59
  241. package/.bmad/bmm/workflows/workflow-status/workflow-status-template.yaml +0 -24
  242. package/.bmad/bmm/workflows/workflow-status/workflow.yaml +0 -28
  243. package/.bmad/core/agents/bmad-master.md +0 -72
  244. package/.bmad/core/agents/bmad-web-orchestrator.agent.xml +0 -113
  245. package/.bmad/core/config.yaml +0 -11
  246. package/.bmad/core/tasks/adv-elicit-methods.csv +0 -39
  247. package/.bmad/core/tasks/advanced-elicitation-methods.csv +0 -21
  248. package/.bmad/core/tasks/advanced-elicitation.xml +0 -106
  249. package/.bmad/core/tasks/index-docs.xml +0 -65
  250. package/.bmad/core/tasks/validate-workflow.xml +0 -89
  251. package/.bmad/core/tasks/workflow.xml +0 -270
  252. package/.bmad/core/tools/shard-doc.xml +0 -109
  253. package/.bmad/core/workflows/brainstorming/README.md +0 -261
  254. package/.bmad/core/workflows/brainstorming/brain-methods.csv +0 -36
  255. package/.bmad/core/workflows/brainstorming/instructions.md +0 -315
  256. package/.bmad/core/workflows/brainstorming/template.md +0 -106
  257. package/.bmad/core/workflows/brainstorming/workflow.yaml +0 -38
  258. package/.bmad/core/workflows/party-mode/instructions.md +0 -203
  259. package/.bmad/core/workflows/party-mode/workflow.yaml +0 -28
  260. package/.bmad/docs/claude-code-instructions.md +0 -25
  261. package/.claude/commands/BMad/analyst.md +0 -88
  262. package/.claude/commands/BMad/architect.md +0 -89
  263. package/.claude/commands/BMad/bmad-master.md +0 -114
  264. package/.claude/commands/BMad/bmad-orchestrator.md +0 -151
  265. package/.claude/commands/BMad/dev.md +0 -85
  266. package/.claude/commands/BMad/pm.md +0 -88
  267. package/.claude/commands/BMad/po.md +0 -83
  268. package/.claude/commands/BMad/qa.md +0 -91
  269. package/.claude/commands/BMad/sm.md +0 -69
  270. package/.claude/commands/BMad/tasks/advanced-elicitation.md +0 -123
  271. package/.claude/commands/BMad/tasks/apply-qa-fixes.md +0 -154
  272. package/.claude/commands/BMad/tasks/brownfield-create-epic.md +0 -166
  273. package/.claude/commands/BMad/tasks/brownfield-create-story.md +0 -153
  274. package/.claude/commands/BMad/tasks/correct-course.md +0 -76
  275. package/.claude/commands/BMad/tasks/create-brownfield-story.md +0 -318
  276. package/.claude/commands/BMad/tasks/create-deep-research-prompt.md +0 -284
  277. package/.claude/commands/BMad/tasks/create-doc.md +0 -107
  278. package/.claude/commands/BMad/tasks/create-next-story.md +0 -118
  279. package/.claude/commands/BMad/tasks/document-project.md +0 -349
  280. package/.claude/commands/BMad/tasks/execute-checklist.md +0 -92
  281. package/.claude/commands/BMad/tasks/facilitate-brainstorming-session.md +0 -142
  282. package/.claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +0 -57
  283. package/.claude/commands/BMad/tasks/index-docs.md +0 -179
  284. package/.claude/commands/BMad/tasks/kb-mode-interaction.md +0 -81
  285. package/.claude/commands/BMad/tasks/nfr-assess.md +0 -349
  286. package/.claude/commands/BMad/tasks/qa-gate.md +0 -167
  287. package/.claude/commands/BMad/tasks/review-story.md +0 -320
  288. package/.claude/commands/BMad/tasks/risk-profile.md +0 -359
  289. package/.claude/commands/BMad/tasks/shard-doc.md +0 -191
  290. package/.claude/commands/BMad/tasks/test-design.md +0 -180
  291. package/.claude/commands/BMad/tasks/trace-requirements.md +0 -270
  292. package/.claude/commands/BMad/tasks/validate-next-story.md +0 -140
  293. package/.claude/commands/BMad/ux-expert.md +0 -73
  294. package/.claude/commands/bmad/bmm/agents/analyst.md +0 -14
  295. package/.claude/commands/bmad/bmm/agents/architect.md +0 -14
  296. package/.claude/commands/bmad/bmm/agents/dev.md +0 -14
  297. package/.claude/commands/bmad/bmm/agents/frame-expert.md +0 -14
  298. package/.claude/commands/bmad/bmm/agents/pm.md +0 -14
  299. package/.claude/commands/bmad/bmm/agents/sm.md +0 -14
  300. package/.claude/commands/bmad/bmm/agents/tea.md +0 -14
  301. package/.claude/commands/bmad/bmm/agents/tech-writer.md +0 -14
  302. package/.claude/commands/bmad/bmm/agents/ux-designer.md +0 -14
  303. package/.claude/commands/bmad/bmm/workflows/architecture.md +0 -13
  304. package/.claude/commands/bmad/bmm/workflows/brainstorm-project.md +0 -13
  305. package/.claude/commands/bmad/bmm/workflows/code-review.md +0 -13
  306. package/.claude/commands/bmad/bmm/workflows/correct-course.md +0 -13
  307. package/.claude/commands/bmad/bmm/workflows/create-dataflow.md +0 -13
  308. package/.claude/commands/bmad/bmm/workflows/create-diagram.md +0 -13
  309. package/.claude/commands/bmad/bmm/workflows/create-epics-and-stories.md +0 -13
  310. package/.claude/commands/bmad/bmm/workflows/create-flowchart.md +0 -13
  311. package/.claude/commands/bmad/bmm/workflows/create-story.md +0 -13
  312. package/.claude/commands/bmad/bmm/workflows/create-ux-design.md +0 -13
  313. package/.claude/commands/bmad/bmm/workflows/create-wireframe.md +0 -13
  314. package/.claude/commands/bmad/bmm/workflows/dev-story.md +0 -13
  315. package/.claude/commands/bmad/bmm/workflows/document-project.md +0 -13
  316. package/.claude/commands/bmad/bmm/workflows/domain-research.md +0 -13
  317. package/.claude/commands/bmad/bmm/workflows/epic-tech-context.md +0 -13
  318. package/.claude/commands/bmad/bmm/workflows/implementation-readiness.md +0 -13
  319. package/.claude/commands/bmad/bmm/workflows/prd.md +0 -13
  320. package/.claude/commands/bmad/bmm/workflows/product-brief.md +0 -13
  321. package/.claude/commands/bmad/bmm/workflows/research.md +0 -13
  322. package/.claude/commands/bmad/bmm/workflows/retrospective.md +0 -13
  323. package/.claude/commands/bmad/bmm/workflows/sprint-planning.md +0 -13
  324. package/.claude/commands/bmad/bmm/workflows/story-context.md +0 -13
  325. package/.claude/commands/bmad/bmm/workflows/story-done.md +0 -13
  326. package/.claude/commands/bmad/bmm/workflows/story-ready.md +0 -13
  327. package/.claude/commands/bmad/bmm/workflows/tech-spec.md +0 -13
  328. package/.claude/commands/bmad/bmm/workflows/workflow-init.md +0 -13
  329. package/.claude/commands/bmad/bmm/workflows/workflow-status.md +0 -13
  330. package/.claude/commands/bmad/core/agents/bmad-master.md +0 -14
  331. package/.claude/commands/bmad/core/tasks/advanced-elicitation.md +0 -9
  332. package/.claude/commands/bmad/core/tasks/index-docs.md +0 -9
  333. package/.claude/commands/bmad/core/tools/shard-doc.md +0 -9
  334. package/.claude/commands/bmad/core/workflows/brainstorming.md +0 -13
  335. package/.claude/commands/bmad/core/workflows/party-mode.md +0 -13
  336. package/.claude/github-star-reminder.txt +0 -1
  337. package/.claude/hooks/bmad-party-manager.sh +0 -225
  338. package/.claude/hooks/stop.sh +0 -221
  339. package/.claude/piper-voices-dir.txt +0 -1
  340. package/.mcp.json +0 -88
  341. package/RELEASE_NOTES_v2.4.0_DRAFT.md +0 -116
  342. package/RELEASE_NOTES_v2.4.1_DRAFT.md +0 -61
  343. package/docs/2025-11-15_15-14-33.snagx +0 -0
  344. package/docs/Screenshot 2025-11-15 151325.png +0 -0
  345. package/docs/Screenshot 2025-11-15 151432.png +0 -0
  346. package/docs/macos-piper-issue.md +0 -172
  347. package/docs/stargazer-cms-prd.md +0 -1918
  348. package/docs/whatsapp-plugin-github-issue.md +0 -393
  349. package/docs/whatsapp-tts-plugin-feasibility.md +0 -418
  350. package/docs/whatsapp-tts-standalone-plugin.md +0 -628
  351. package/github-profile-draft.md +0 -57
  352. package/linkedin/vibe-coding-and-pulseaudio.md +0 -121
  353. package/mcp-server/agentvibes.db +0 -0
  354. package/scripts/audio-tunnel.config +0 -17
  355. package/v4-backup/.bmad-core/agent-teams/team-all.yaml +0 -15
  356. package/v4-backup/.bmad-core/agent-teams/team-fullstack.yaml +0 -19
  357. package/v4-backup/.bmad-core/agent-teams/team-ide-minimal.yaml +0 -11
  358. package/v4-backup/.bmad-core/agent-teams/team-no-ui.yaml +0 -14
  359. package/v4-backup/.bmad-core/agents/analyst.md +0 -84
  360. package/v4-backup/.bmad-core/agents/architect.md +0 -85
  361. package/v4-backup/.bmad-core/agents/bmad-master.md +0 -110
  362. package/v4-backup/.bmad-core/agents/bmad-orchestrator.md +0 -147
  363. package/v4-backup/.bmad-core/agents/dev.md +0 -81
  364. package/v4-backup/.bmad-core/agents/pm.md +0 -84
  365. package/v4-backup/.bmad-core/agents/po.md +0 -79
  366. package/v4-backup/.bmad-core/agents/qa.md +0 -87
  367. package/v4-backup/.bmad-core/agents/sm.md +0 -65
  368. package/v4-backup/.bmad-core/agents/ux-expert.md +0 -69
  369. package/v4-backup/.bmad-core/checklists/architect-checklist.md +0 -440
  370. package/v4-backup/.bmad-core/checklists/change-checklist.md +0 -184
  371. package/v4-backup/.bmad-core/checklists/pm-checklist.md +0 -372
  372. package/v4-backup/.bmad-core/checklists/po-master-checklist.md +0 -434
  373. package/v4-backup/.bmad-core/checklists/story-dod-checklist.md +0 -96
  374. package/v4-backup/.bmad-core/checklists/story-draft-checklist.md +0 -155
  375. package/v4-backup/.bmad-core/core-config.yaml +0 -22
  376. package/v4-backup/.bmad-core/data/bmad-kb.md +0 -809
  377. package/v4-backup/.bmad-core/data/brainstorming-techniques.md +0 -38
  378. package/v4-backup/.bmad-core/data/elicitation-methods.md +0 -156
  379. package/v4-backup/.bmad-core/data/technical-preferences.md +0 -5
  380. package/v4-backup/.bmad-core/data/test-levels-framework.md +0 -148
  381. package/v4-backup/.bmad-core/data/test-priorities-matrix.md +0 -174
  382. package/v4-backup/.bmad-core/enhanced-ide-development-workflow.md +0 -248
  383. package/v4-backup/.bmad-core/install-manifest.yaml +0 -230
  384. package/v4-backup/.bmad-core/tasks/advanced-elicitation.md +0 -119
  385. package/v4-backup/.bmad-core/tasks/apply-qa-fixes.md +0 -150
  386. package/v4-backup/.bmad-core/tasks/brownfield-create-epic.md +0 -162
  387. package/v4-backup/.bmad-core/tasks/brownfield-create-story.md +0 -149
  388. package/v4-backup/.bmad-core/tasks/correct-course.md +0 -72
  389. package/v4-backup/.bmad-core/tasks/create-brownfield-story.md +0 -314
  390. package/v4-backup/.bmad-core/tasks/create-deep-research-prompt.md +0 -280
  391. package/v4-backup/.bmad-core/tasks/create-doc.md +0 -103
  392. package/v4-backup/.bmad-core/tasks/create-next-story.md +0 -114
  393. package/v4-backup/.bmad-core/tasks/document-project.md +0 -345
  394. package/v4-backup/.bmad-core/tasks/execute-checklist.md +0 -88
  395. package/v4-backup/.bmad-core/tasks/facilitate-brainstorming-session.md +0 -138
  396. package/v4-backup/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -53
  397. package/v4-backup/.bmad-core/tasks/index-docs.md +0 -175
  398. package/v4-backup/.bmad-core/tasks/kb-mode-interaction.md +0 -77
  399. package/v4-backup/.bmad-core/tasks/nfr-assess.md +0 -345
  400. package/v4-backup/.bmad-core/tasks/qa-gate.md +0 -163
  401. package/v4-backup/.bmad-core/tasks/review-story.md +0 -316
  402. package/v4-backup/.bmad-core/tasks/risk-profile.md +0 -355
  403. package/v4-backup/.bmad-core/tasks/shard-doc.md +0 -187
  404. package/v4-backup/.bmad-core/tasks/test-design.md +0 -176
  405. package/v4-backup/.bmad-core/tasks/trace-requirements.md +0 -266
  406. package/v4-backup/.bmad-core/tasks/validate-next-story.md +0 -136
  407. package/v4-backup/.bmad-core/templates/architecture-tmpl.yaml +0 -651
  408. package/v4-backup/.bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  409. package/v4-backup/.bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -477
  410. package/v4-backup/.bmad-core/templates/brownfield-prd-tmpl.yaml +0 -281
  411. package/v4-backup/.bmad-core/templates/competitor-analysis-tmpl.yaml +0 -307
  412. package/v4-backup/.bmad-core/templates/front-end-architecture-tmpl.yaml +0 -219
  413. package/v4-backup/.bmad-core/templates/front-end-spec-tmpl.yaml +0 -350
  414. package/v4-backup/.bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -824
  415. package/v4-backup/.bmad-core/templates/market-research-tmpl.yaml +0 -253
  416. package/v4-backup/.bmad-core/templates/prd-tmpl.yaml +0 -203
  417. package/v4-backup/.bmad-core/templates/project-brief-tmpl.yaml +0 -222
  418. package/v4-backup/.bmad-core/templates/qa-gate-tmpl.yaml +0 -103
  419. package/v4-backup/.bmad-core/templates/story-tmpl.yaml +0 -138
  420. package/v4-backup/.bmad-core/user-guide.md +0 -577
  421. package/v4-backup/.bmad-core/utils/bmad-doc-template.md +0 -327
  422. package/v4-backup/.bmad-core/utils/workflow-management.md +0 -71
  423. package/v4-backup/.bmad-core/workflows/brownfield-fullstack.yaml +0 -298
  424. package/v4-backup/.bmad-core/workflows/brownfield-service.yaml +0 -188
  425. package/v4-backup/.bmad-core/workflows/brownfield-ui.yaml +0 -198
  426. package/v4-backup/.bmad-core/workflows/greenfield-fullstack.yaml +0 -241
  427. package/v4-backup/.bmad-core/workflows/greenfield-service.yaml +0 -207
  428. package/v4-backup/.bmad-core/workflows/greenfield-ui.yaml +0 -236
  429. package/v4-backup/.bmad-core/working-in-the-brownfield.md +0 -606
@@ -1,577 +0,0 @@
1
- # BMad Method — User Guide
2
-
3
- This guide will help you understand and effectively use the BMad Method for agile AI-driven planning and development.
4
-
5
- ## The BMad Plan and Execute Workflow
6
-
7
- First, here is the full standard Greenfield Planning + Execution Workflow. Brownfield is very similar, but it's suggested to understand this greenfield first, even if on a simple project before tackling a brownfield project. The BMad Method needs to be installed to the root of your new project folder. For the planning phase, you can optionally perform it with powerful web agents, potentially resulting in higher quality results at a fraction of the cost it would take to complete if providing your own API key or credits in some Agentic tools. For planning, powerful thinking models and larger context - along with working as a partner with the agents will net the best results.
8
-
9
- If you are going to use the BMad Method with a Brownfield project (an existing project), review **[Working in the Brownfield](./working-in-the-brownfield.md)**.
10
-
11
- If the diagrams below don't render, install Markdown All in One along with the Markdown Preview Mermaid Support plugins to VSCode (or one of the forked clones). With these plugins, if you right click on the tab when open, there should be an Open Preview option, or check the IDE documentation.
12
-
13
- ### The Planning Workflow (Web UI or Powerful IDE Agents)
14
-
15
- Before development begins, BMad follows a structured planning workflow that's ideally done in web UI for cost efficiency:
16
-
17
- ```mermaid
18
- graph TD
19
- A["Start: Project Idea"] --> B{"Optional: Analyst Research"}
20
- B -->|Yes| C["Analyst: Brainstorming (Optional)"]
21
- B -->|No| G{"Project Brief Available?"}
22
- C --> C2["Analyst: Market Research (Optional)"]
23
- C2 --> C3["Analyst: Competitor Analysis (Optional)"]
24
- C3 --> D["Analyst: Create Project Brief"]
25
- D --> G
26
- G -->|Yes| E["PM: Create PRD from Brief (Fast Track)"]
27
- G -->|No| E2["PM: Interactive PRD Creation (More Questions)"]
28
- E --> F["PRD Created with FRs, NFRs, Epics & Stories"]
29
- E2 --> F
30
- F --> F2{"UX Required?"}
31
- F2 -->|Yes| F3["UX Expert: Create Front End Spec"]
32
- F2 -->|No| H["Architect: Create Architecture from PRD"]
33
- F3 --> F4["UX Expert: Generate UI Prompt for Lovable/V0 (Optional)"]
34
- F4 --> H2["Architect: Create Architecture from PRD + UX Spec"]
35
- H --> Q{"Early Test Strategy? (Optional)"}
36
- H2 --> Q
37
- Q -->|Yes| R["QA: Early Test Architecture Input on High-Risk Areas"]
38
- Q -->|No| I
39
- R --> I["PO: Run Master Checklist"]
40
- I --> J{"Documents Aligned?"}
41
- J -->|Yes| K["Planning Complete"]
42
- J -->|No| L["PO: Update Epics & Stories"]
43
- L --> M["Update PRD/Architecture as needed"]
44
- M --> I
45
- K --> N["📁 Switch to IDE (If in a Web Agent Platform)"]
46
- N --> O["PO: Shard Documents"]
47
- O --> P["Ready for SM/Dev Cycle"]
48
-
49
- style A fill:#f5f5f5,color:#000
50
- style B fill:#e3f2fd,color:#000
51
- style C fill:#e8f5e9,color:#000
52
- style C2 fill:#e8f5e9,color:#000
53
- style C3 fill:#e8f5e9,color:#000
54
- style D fill:#e8f5e9,color:#000
55
- style E fill:#fff3e0,color:#000
56
- style E2 fill:#fff3e0,color:#000
57
- style F fill:#fff3e0,color:#000
58
- style F2 fill:#e3f2fd,color:#000
59
- style F3 fill:#e1f5fe,color:#000
60
- style F4 fill:#e1f5fe,color:#000
61
- style G fill:#e3f2fd,color:#000
62
- style H fill:#f3e5f5,color:#000
63
- style H2 fill:#f3e5f5,color:#000
64
- style Q fill:#e3f2fd,color:#000
65
- style R fill:#ffd54f,color:#000
66
- style I fill:#f9ab00,color:#fff
67
- style J fill:#e3f2fd,color:#000
68
- style K fill:#34a853,color:#fff
69
- style L fill:#f9ab00,color:#fff
70
- style M fill:#fff3e0,color:#000
71
- style N fill:#1a73e8,color:#fff
72
- style O fill:#f9ab00,color:#fff
73
- style P fill:#34a853,color:#fff
74
- ```
75
-
76
- #### Web UI to IDE Transition
77
-
78
- **Critical Transition Point**: Once the PO confirms document alignment, you must switch from web UI to IDE to begin the development workflow:
79
-
80
- 1. **Copy Documents to Project**: Ensure `docs/prd.md` and `docs/architecture.md` are in your project's docs folder (or a custom location you can specify during installation)
81
- 2. **Switch to IDE**: Open your project in your preferred Agentic IDE
82
- 3. **Document Sharding**: Use the PO agent to shard the PRD and then the Architecture
83
- 4. **Begin Development**: Start the Core Development Cycle that follows
84
-
85
- #### Planning Artifacts (Standard Paths)
86
-
87
- ```text
88
- PRD → docs/prd.md
89
- Architecture → docs/architecture.md
90
- Sharded Epics → docs/epics/
91
- Sharded Stories → docs/stories/
92
- QA Assessments → docs/qa/assessments/
93
- QA Gates → docs/qa/gates/
94
- ```
95
-
96
- ### The Core Development Cycle (IDE)
97
-
98
- Once planning is complete and documents are sharded, BMad follows a structured development workflow:
99
-
100
- ```mermaid
101
- graph TD
102
- A["Development Phase Start"] --> B["SM: Reviews Previous Story Dev/QA Notes"]
103
- B --> B2["SM: Drafts Next Story from Sharded Epic + Architecture"]
104
- B2 --> S{"High-Risk Story? (Optional)"}
105
- S -->|Yes| T["QA: *risk + *design on Draft Story"]
106
- S -->|No| B3
107
- T --> U["Test Strategy & Risk Profile Created"]
108
- U --> B3{"PO: Validate Story Draft (Optional)"}
109
- B3 -->|Validation Requested| B4["PO: Validate Story Against Artifacts"]
110
- B3 -->|Skip Validation| C{"User Approval"}
111
- B4 --> C
112
- C -->|Approved| D["Dev: Sequential Task Execution"]
113
- C -->|Needs Changes| B2
114
- D --> E["Dev: Implement Tasks + Tests"]
115
- E --> V{"Mid-Dev QA Check? (Optional)"}
116
- V -->|Yes| W["QA: *trace or *nfr for Early Validation"]
117
- V -->|No| F
118
- W --> X["Dev: Address Coverage/NFR Gaps"]
119
- X --> F["Dev: Run All Validations"]
120
- F --> G["Dev: Mark Ready for Review + Add Notes"]
121
- G --> H{"User Verification"}
122
- H -->|Request QA Review| I["QA: Test Architect Review + Quality Gate"]
123
- H -->|Approve Without QA| M["IMPORTANT: Verify All Regression Tests and Linting are Passing"]
124
- I --> J["QA: Test Architecture Analysis + Active Refactoring"]
125
- J --> L{"QA Decision"}
126
- L -->|Needs Dev Work| D
127
- L -->|Approved| M
128
- H -->|Needs Fixes| D
129
- M --> N["IMPORTANT: COMMIT YOUR CHANGES BEFORE PROCEEDING!"]
130
- N --> Y{"Gate Update Needed?"}
131
- Y -->|Yes| Z["QA: *gate to Update Status"]
132
- Y -->|No| K
133
- Z --> K["Mark Story as Done"]
134
- K --> B
135
-
136
- style A fill:#f5f5f5,color:#000
137
- style B fill:#e8f5e9,color:#000
138
- style B2 fill:#e8f5e9,color:#000
139
- style S fill:#e3f2fd,color:#000
140
- style T fill:#ffd54f,color:#000
141
- style U fill:#ffd54f,color:#000
142
- style B3 fill:#e3f2fd,color:#000
143
- style B4 fill:#fce4ec,color:#000
144
- style C fill:#e3f2fd,color:#000
145
- style D fill:#e3f2fd,color:#000
146
- style E fill:#e3f2fd,color:#000
147
- style V fill:#e3f2fd,color:#000
148
- style W fill:#ffd54f,color:#000
149
- style X fill:#e3f2fd,color:#000
150
- style F fill:#e3f2fd,color:#000
151
- style G fill:#e3f2fd,color:#000
152
- style H fill:#e3f2fd,color:#000
153
- style I fill:#f9ab00,color:#fff
154
- style J fill:#ffd54f,color:#000
155
- style K fill:#34a853,color:#fff
156
- style L fill:#e3f2fd,color:#000
157
- style M fill:#ff5722,color:#fff
158
- style N fill:#d32f2f,color:#fff
159
- style Y fill:#e3f2fd,color:#000
160
- style Z fill:#ffd54f,color:#000
161
- ```
162
-
163
- ## Prerequisites
164
-
165
- Before installing BMad Method, ensure you have:
166
-
167
- - **Node.js** ≥ 18, **npm** ≥ 9
168
- - **Git** installed and configured
169
- - **(Optional)** VS Code with "Markdown All in One" + "Markdown Preview Mermaid Support" extensions
170
-
171
- ## Installation
172
-
173
- ### Optional
174
-
175
- If you want to do the planning on the web with Claude (Sonnet 4 or Opus), Gemini Gem (2.5 Pro), or Custom GPTs:
176
-
177
- 1. Navigate to `dist/teams/`
178
- 2. Copy `team-fullstack.txt`
179
- 3. Create new Gemini Gem or CustomGPT
180
- 4. Upload file with instructions: "Your critical operating instructions are attached, do not break character as directed"
181
- 5. Type `/help` to see available commands
182
-
183
- ### IDE Project Setup
184
-
185
- ```bash
186
- # Interactive installation (recommended)
187
- npx bmad-method install
188
- ```
189
-
190
- ### OpenCode
191
-
192
- BMAD integrates with OpenCode via a project-level `opencode.jsonc`/`opencode.json` (JSON-only, no Markdown fallback).
193
-
194
- - Installation:
195
- - Run `npx bmad-method install` and choose `OpenCode` in the IDE list.
196
- - The installer will detect an existing `opencode.jsonc`/`opencode.json` or create a minimal `opencode.jsonc` if missing.
197
- - It will:
198
- - Ensure `instructions` includes `.bmad-core/core-config.yaml` (and each selected expansion pack’s `config.yaml`).
199
- - Merge BMAD agents and commands using file references (`{file:./.bmad-core/...}`), idempotently.
200
- - Preserve other top-level fields and user-defined entries.
201
-
202
- - Prefixes and collisions:
203
- - You can opt-in to prefix agent keys with `bmad-` and command keys with `bmad:tasks:` to avoid name collisions.
204
- - If a key already exists and is not BMAD-managed, the installer will skip it and suggest enabling prefixes.
205
-
206
- - What gets added:
207
- - `instructions`: `.bmad-core/core-config.yaml` plus any selected expansion pack `config.yaml` files.
208
- - `agent`: BMAD agents from core and selected packs.
209
- - `prompt`: `{file:./.bmad-core/agents/<id>.md}` (or pack path)
210
- - `mode`: `primary` for orchestrators, otherwise `all`
211
- - `tools`: `{ write: true, edit: true, bash: true }`
212
- - `description`: extracted from the agent’s `whenToUse`
213
- - `command`: BMAD tasks from core and selected packs.
214
- - `template`: `{file:./.bmad-core/tasks/<id>.md}` (or pack path)
215
- - `description`: extracted from the task’s “Purpose” section
216
-
217
- - Selected Packages Only:
218
- - The installer includes agents and tasks only from the packages you selected in the earlier step (core and chosen packs).
219
-
220
- - Refresh after changes:
221
- - Re-run:
222
- ```bash
223
- npx bmad-method install -f -i opencode
224
- ```
225
- - The installer safely updates entries without duplication and preserves your custom fields and comments.
226
-
227
- - Optional convenience script:
228
- - You can add a script to your project’s `package.json` for quick refreshes:
229
- ```json
230
- {
231
- "scripts": {
232
- "bmad:opencode": "bmad-method install -f -i opencode"
233
- }
234
- }
235
- ```
236
-
237
- ### Codex (CLI & Web)
238
-
239
- BMAD integrates with OpenAI Codex via `AGENTS.md` and committed core agent files.
240
-
241
- - Two installation modes:
242
- - Codex (local only): keeps `.bmad-core/` ignored for local dev.
243
- - `npx bmad-method install -f -i codex -d .`
244
- - Codex Web Enabled: ensures `.bmad-core/` is tracked so you can commit it for Codex Web.
245
- - `npx bmad-method install -f -i codex-web -d .`
246
-
247
- - What gets generated:
248
- - `AGENTS.md` at the project root with a BMAD section containing
249
- - How-to-use with Codex (CLI & Web)
250
- - Agent Directory (Title, ID, When To Use)
251
- - Detailed per‑agent sections with source path, when-to-use, activation phrasing, and YAML
252
- - Tasks with quick usage notes
253
- - If a `package.json` exists, helpful scripts are added:
254
- - `bmad:refresh`, `bmad:list`, `bmad:validate`
255
-
256
- - Using Codex:
257
- - CLI: run `codex` in the project root and prompt naturally, e.g., “As dev, implement …”.
258
- - Web: commit `.bmad-core/` and `AGENTS.md`, then open the repo in Codex and prompt the same way.
259
-
260
- - Refresh after changes:
261
- - Re-run the appropriate install mode (`codex` or `codex-web`) to update the BMAD block in `AGENTS.md`.
262
-
263
- ## Special Agents
264
-
265
- There are two BMad agents — in the future they'll be consolidated into a single BMad-Master.
266
-
267
- ### BMad-Master
268
-
269
- This agent can do any task or command that all other agents can do, aside from actual story implementation. Additionally, this agent can help explain the BMad Method when on the web by accessing the knowledge base and explaining anything to you about the process.
270
-
271
- If you don't want to bother switching between different agents aside from the dev, this is the agent for you. Just remember that as the context grows, the performance of the agent degrades, therefore it is important to instruct the agent to compact the conversation and start a new conversation with the compacted conversation as the initial message. Do this often, preferably after each story is implemented.
272
-
273
- ### BMad-Orchestrator
274
-
275
- This agent should NOT be used within the IDE, it is a heavyweight, special-purpose agent that utilizes a lot of context and can morph into any other agent. This exists solely to facilitate the teams within the web bundles. If you use a web bundle you will be greeted by the BMad Orchestrator.
276
-
277
- ### How Agents Work
278
-
279
- #### Dependencies System
280
-
281
- Each agent has a YAML section that defines its dependencies:
282
-
283
- ```yaml
284
- dependencies:
285
- templates:
286
- - prd-template.md
287
- - user-story-template.md
288
- tasks:
289
- - create-doc.md
290
- - shard-doc.md
291
- data:
292
- - bmad-kb.md
293
- ```
294
-
295
- **Key Points:**
296
-
297
- - Agents only load resources they need (lean context)
298
- - Dependencies are automatically resolved during bundling
299
- - Resources are shared across agents to maintain consistency
300
-
301
- #### Agent Interaction
302
-
303
- **In IDE:**
304
-
305
- ```bash
306
- # Some IDEs, like Cursor or Windsurf for example, utilize manual rules so interaction is done with the '@' symbol
307
- @pm Create a PRD for a task management app
308
- @architect Design the system architecture
309
- @dev Implement the user authentication
310
-
311
- # Some IDEs, like Claude Code, use slash commands instead
312
- /pm Create user stories
313
- /dev Fix the login bug
314
- ```
315
-
316
- #### Interactive Modes
317
-
318
- - **Incremental Mode**: Step-by-step with user input
319
- - **YOLO Mode**: Rapid generation with minimal interaction
320
-
321
- ## IDE Integration
322
-
323
- ### IDE Best Practices
324
-
325
- - **Context Management**: Keep relevant files only in context, keep files as lean and focused as necessary
326
- - **Agent Selection**: Use appropriate agent for task
327
- - **Iterative Development**: Work in small, focused tasks
328
- - **File Organization**: Maintain clean project structure
329
- - **Commit Regularly**: Save your work frequently
330
-
331
- ## The Test Architect (QA Agent)
332
-
333
- ### Overview
334
-
335
- The QA agent in BMad is not just a "senior developer reviewer" - it's a **Test Architect** with deep expertise in test strategy, quality gates, and risk-based testing. Named Quinn, this agent provides advisory authority on quality matters while actively improving code when safe to do so.
336
-
337
- #### Quick Start (Essential Commands)
338
-
339
- ```bash
340
- @qa *risk {story} # Assess risks before development
341
- @qa *design {story} # Create test strategy
342
- @qa *trace {story} # Verify test coverage during dev
343
- @qa *nfr {story} # Check quality attributes
344
- @qa *review {story} # Full assessment → writes gate
345
- ```
346
-
347
- #### Command Aliases (Test Architect)
348
-
349
- The documentation uses short forms for convenience. Both styles are valid:
350
-
351
- ```text
352
- *risk → *risk-profile
353
- *design → *test-design
354
- *nfr → *nfr-assess
355
- *trace → *trace-requirements (or just *trace)
356
- *review → *review
357
- *gate → *gate
358
- ```
359
-
360
- ### Core Capabilities
361
-
362
- #### 1. Risk Profiling (`*risk`)
363
-
364
- **When:** After story draft, before development begins (earliest intervention point)
365
-
366
- Identifies and assesses implementation risks:
367
-
368
- - **Categories**: Technical, Security, Performance, Data, Business, Operational
369
- - **Scoring**: Probability × Impact analysis (1-9 scale)
370
- - **Mitigation**: Specific strategies for each identified risk
371
- - **Gate Impact**: Risks ≥9 trigger FAIL, ≥6 trigger CONCERNS (see `tasks/risk-profile.md` for authoritative rules)
372
-
373
- #### 2. Test Design (`*design`)
374
-
375
- **When:** After story draft, before development begins (guides what tests to write)
376
-
377
- Creates comprehensive test strategies including:
378
-
379
- - Test scenarios for each acceptance criterion
380
- - Appropriate test level recommendations (unit vs integration vs E2E)
381
- - Risk-based prioritization (P0/P1/P2)
382
- - Test data requirements and mock strategies
383
- - Execution strategies for CI/CD integration
384
-
385
- **Example output:**
386
-
387
- ```yaml
388
- test_summary:
389
- total: 24
390
- by_level:
391
- unit: 15
392
- integration: 7
393
- e2e: 2
394
- by_priority:
395
- P0: 8 # Must have - linked to critical risks
396
- P1: 10 # Should have - medium risks
397
- P2: 6 # Nice to have - low risks
398
- ```
399
-
400
- #### 3. Requirements Tracing (`*trace`)
401
-
402
- **When:** During development (mid-implementation checkpoint)
403
-
404
- Maps requirements to test coverage:
405
-
406
- - Documents which tests validate each acceptance criterion
407
- - Uses Given-When-Then for clarity (documentation only, not BDD code)
408
- - Identifies coverage gaps with severity ratings
409
- - Creates traceability matrix for audit purposes
410
-
411
- #### 4. NFR Assessment (`*nfr`)
412
-
413
- **When:** During development or early review (validate quality attributes)
414
-
415
- Validates non-functional requirements:
416
-
417
- - **Core Four**: Security, Performance, Reliability, Maintainability
418
- - **Evidence-Based**: Looks for actual implementation proof
419
- - **Gate Integration**: NFR failures directly impact quality gates
420
-
421
- #### 5. Comprehensive Test Architecture Review (`*review`)
422
-
423
- **When:** After development complete, story marked "Ready for Review"
424
-
425
- When you run `@qa *review {story}`, Quinn performs:
426
-
427
- - **Requirements Traceability**: Maps every acceptance criterion to its validating tests
428
- - **Test Level Analysis**: Ensures appropriate testing at unit, integration, and E2E levels
429
- - **Coverage Assessment**: Identifies gaps and redundant test coverage
430
- - **Active Refactoring**: Improves code quality directly when safe
431
- - **Quality Gate Decision**: Issues PASS/CONCERNS/FAIL status based on findings
432
-
433
- #### 6. Quality Gates (`*gate`)
434
-
435
- **When:** After review fixes or when gate status needs updating
436
-
437
- Manages quality gate decisions:
438
-
439
- - **Deterministic Rules**: Clear criteria for PASS/CONCERNS/FAIL
440
- - **Parallel Authority**: QA owns gate files in `docs/qa/gates/`
441
- - **Advisory Nature**: Provides recommendations, not blocks
442
- - **Waiver Support**: Documents accepted risks when needed
443
-
444
- **Note:** Gates are advisory; teams choose their quality bar. WAIVED requires reason, approver, and expiry date. See `templates/qa-gate-tmpl.yaml` for schema and `tasks/review-story.md` (gate rules) and `tasks/risk-profile.md` for scoring.
445
-
446
- ### Working with the Test Architect
447
-
448
- #### Integration with BMad Workflow
449
-
450
- The Test Architect provides value throughout the entire development lifecycle. Here's when and how to leverage each capability:
451
-
452
- | **Stage** | **Command** | **When to Use** | **Value** | **Output** |
453
- | ------------------ | ----------- | ----------------------- | -------------------------- | -------------------------------------------------------------- |
454
- | **Story Drafting** | `*risk` | After SM drafts story | Identify pitfalls early | `docs/qa/assessments/{epic}.{story}-risk-{YYYYMMDD}.md` |
455
- | | `*design` | After risk assessment | Guide dev on test strategy | `docs/qa/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md` |
456
- | **Development** | `*trace` | Mid-implementation | Verify test coverage | `docs/qa/assessments/{epic}.{story}-trace-{YYYYMMDD}.md` |
457
- | | `*nfr` | While building features | Catch quality issues early | `docs/qa/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md` |
458
- | **Review** | `*review` | Story marked complete | Full quality assessment | QA Results in story + gate file |
459
- | **Post-Review** | `*gate` | After fixing issues | Update quality decision | Updated `docs/qa/gates/{epic}.{story}-{slug}.yml` |
460
-
461
- #### Example Commands
462
-
463
- ```bash
464
- # Planning Stage - Run these BEFORE development starts
465
- @qa *risk {draft-story} # What could go wrong?
466
- @qa *design {draft-story} # What tests should we write?
467
-
468
- # Development Stage - Run these DURING coding
469
- @qa *trace {story} # Are we testing everything?
470
- @qa *nfr {story} # Are we meeting quality standards?
471
-
472
- # Review Stage - Run when development complete
473
- @qa *review {story} # Comprehensive assessment + refactoring
474
-
475
- # Post-Review - Run after addressing issues
476
- @qa *gate {story} # Update gate status
477
- ```
478
-
479
- ### Quality Standards Enforced
480
-
481
- Quinn enforces these test quality principles:
482
-
483
- - **No Flaky Tests**: Ensures reliability through proper async handling
484
- - **No Hard Waits**: Dynamic waiting strategies only
485
- - **Stateless & Parallel-Safe**: Tests run independently
486
- - **Self-Cleaning**: Tests manage their own test data
487
- - **Appropriate Test Levels**: Unit for logic, integration for interactions, E2E for journeys
488
- - **Explicit Assertions**: Keep assertions in tests, not helpers
489
-
490
- ### Gate Status Meanings
491
-
492
- - **PASS**: All critical requirements met, no blocking issues
493
- - **CONCERNS**: Non-critical issues found, team should review
494
- - **FAIL**: Critical issues that should be addressed (security risks, missing P0 tests)
495
- - **WAIVED**: Issues acknowledged but explicitly accepted by team
496
-
497
- ### Special Situations
498
-
499
- **High-Risk Stories:**
500
-
501
- - Always run `*risk` and `*design` before development starts
502
- - Consider mid-development `*trace` and `*nfr` checkpoints
503
-
504
- **Complex Integrations:**
505
-
506
- - Run `*trace` during development to ensure all integration points tested
507
- - Follow up with `*nfr` to validate performance across integrations
508
-
509
- **Performance-Critical:**
510
-
511
- - Run `*nfr` early and often during development
512
- - Don't wait until review to discover performance issues
513
-
514
- **Brownfield/Legacy Code:**
515
-
516
- - Start with `*risk` to identify regression dangers
517
- - Use `*review` with extra focus on backward compatibility
518
-
519
- ### Best Practices
520
-
521
- - **Early Engagement**: Run `*design` and `*risk` during story drafting
522
- - **Risk-Based Focus**: Let risk scores drive test prioritization
523
- - **Iterative Improvement**: Use QA feedback to improve future stories
524
- - **Gate Transparency**: Share gate decisions with the team
525
- - **Continuous Learning**: QA documents patterns for team knowledge sharing
526
- - **Brownfield Care**: Pay extra attention to regression risks in existing systems
527
-
528
- ### Output Paths Reference
529
-
530
- Quick reference for where Test Architect outputs are stored:
531
-
532
- ```text
533
- *risk-profile → docs/qa/assessments/{epic}.{story}-risk-{YYYYMMDD}.md
534
- *test-design → docs/qa/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md
535
- *trace → docs/qa/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
536
- *nfr-assess → docs/qa/assessments/{epic}.{story}-nfr-{YYYYMMDD}.md
537
- *review → QA Results section in story + gate file reference
538
- *gate → docs/qa/gates/{epic}.{story}-{slug}.yml
539
- ```
540
-
541
- ## Technical Preferences System
542
-
543
- BMad includes a personalization system through the `technical-preferences.md` file located in `.bmad-core/data/` - this can help bias the PM and Architect to recommend your preferences for design patterns, technology selection, or anything else you would like to put in here.
544
-
545
- ### Using with Web Bundles
546
-
547
- When creating custom web bundles or uploading to AI platforms, include your `technical-preferences.md` content to ensure agents have your preferences from the start of any conversation.
548
-
549
- ## Core Configuration
550
-
551
- The `.bmad-core/core-config.yaml` file is a critical config that enables BMad to work seamlessly with differing project structures, more options will be made available in the future. Currently the most important is the devLoadAlwaysFiles list section in the yaml.
552
-
553
- ### Developer Context Files
554
-
555
- Define which files the dev agent should always load:
556
-
557
- ```yaml
558
- devLoadAlwaysFiles:
559
- - docs/architecture/coding-standards.md
560
- - docs/architecture/tech-stack.md
561
- - docs/architecture/project-structure.md
562
- ```
563
-
564
- You will want to verify from sharding your architecture that these documents exist, that they are as lean as possible, and contain exactly the information you want your dev agent to ALWAYS load into its context. These are the rules the agent will follow.
565
-
566
- As your project grows and the code starts to build consistent patterns, coding standards should be reduced to include only the standards the agent still needs enforced. The agent will look at surrounding code in files to infer the coding standards that are relevant to the current task.
567
-
568
- ## Getting Help
569
-
570
- - **Discord Community**: [Join Discord](https://discord.gg/gk8jAdXWmj)
571
- - **GitHub Issues**: [Report bugs](https://github.com/bmadcode/bmad-method/issues)
572
- - **Documentation**: [Browse docs](https://github.com/bmadcode/bmad-method/docs)
573
- - **YouTube**: [BMadCode Channel](https://www.youtube.com/@BMadCode)
574
-
575
- ## Conclusion
576
-
577
- Remember: BMad is designed to enhance your development process, not replace your expertise. Use it as a powerful tool to accelerate your projects while maintaining control over design decisions and implementation details.