bmad-method 6.0.0-alpha.7 → 6.0.0-alpha.9

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 (457) hide show
  1. package/.github/ISSUE_TEMPLATE/idea_submission.md +1 -1
  2. package/.github/workflows/bundle-latest.yaml +277 -0
  3. package/.github/workflows/manual-release.yaml +55 -16
  4. package/.vscode/settings.json +2 -1
  5. package/CHANGELOG.md +439 -1
  6. package/README.md +12 -4
  7. package/docs/BUNDLE_DISTRIBUTION_SETUP.md +95 -0
  8. package/docs/agent-customization-guide.md +208 -0
  9. package/docs/ide-info/crush.md +1 -1
  10. package/docs/ide-info/cursor.md +7 -7
  11. package/docs/ide-info/iflow.md +3 -3
  12. package/docs/ide-info/opencode.md +1 -1
  13. package/docs/index.md +3 -1
  14. package/docs/installers-bundlers/ide-injections.md +2 -2
  15. package/docs/installers-bundlers/installers-modules-platforms-reference.md +23 -23
  16. package/docs/v4-to-v6-upgrade.md +12 -12
  17. package/docs/web-bundles-gemini-gpt-guide.md +473 -0
  18. package/package.json +1 -1
  19. package/src/core/_module-installer/install-config.yaml +17 -10
  20. package/src/core/_module-installer/installer.js +0 -8
  21. package/src/core/agents/bmad-master.agent.yaml +5 -5
  22. package/src/core/agents/bmad-web-orchestrator.agent.xml +8 -17
  23. package/src/core/tasks/{adv-elicit.xml → advanced-elicitation.xml} +6 -4
  24. package/src/core/tasks/index-docs.xml +1 -1
  25. package/src/core/tasks/validate-workflow.xml +1 -1
  26. package/src/core/tasks/workflow.xml +125 -11
  27. package/src/core/tools/shard-doc.xml +45 -1
  28. package/src/core/workflows/brainstorming/README.md +6 -16
  29. package/src/core/workflows/brainstorming/instructions.md +6 -5
  30. package/src/core/workflows/brainstorming/template.md +4 -0
  31. package/src/core/workflows/brainstorming/workflow.yaml +8 -8
  32. package/src/core/workflows/party-mode/instructions.md +2 -7
  33. package/src/core/workflows/party-mode/workflow.yaml +10 -6
  34. package/src/modules/bmb/_module-installer/install-config.yaml +9 -4
  35. package/src/modules/bmb/agents/bmad-builder.agent.yaml +11 -10
  36. package/src/modules/bmb/workflows/audit-workflow/checklist.md +5 -6
  37. package/src/modules/bmb/workflows/audit-workflow/instructions.md +5 -5
  38. package/src/modules/bmb/workflows/audit-workflow/workflow.yaml +2 -2
  39. package/src/modules/bmb/workflows/convert-legacy/README.md +5 -5
  40. package/src/modules/bmb/workflows/convert-legacy/checklist.md +2 -2
  41. package/src/modules/bmb/workflows/convert-legacy/instructions.md +17 -17
  42. package/src/modules/bmb/workflows/convert-legacy/workflow.yaml +6 -6
  43. package/src/modules/bmb/workflows/create-agent/README.md +5 -5
  44. package/src/modules/bmb/workflows/create-agent/agent-architecture.md +15 -19
  45. package/src/modules/bmb/workflows/create-agent/agent-command-patterns.md +28 -28
  46. package/src/modules/bmb/workflows/create-agent/agent-types.md +15 -15
  47. package/src/modules/bmb/workflows/create-agent/checklist.md +3 -3
  48. package/src/modules/bmb/workflows/create-agent/instructions.md +24 -27
  49. package/src/modules/bmb/workflows/create-agent/workflow.yaml +12 -12
  50. package/src/modules/bmb/workflows/create-module/README.md +1 -1
  51. package/src/modules/bmb/workflows/create-module/checklist.md +1 -10
  52. package/src/modules/bmb/workflows/create-module/installer-templates/install-config.yaml +1 -1
  53. package/src/modules/bmb/workflows/create-module/instructions.md +12 -17
  54. package/src/modules/bmb/workflows/create-module/module-structure.md +7 -7
  55. package/src/modules/bmb/workflows/create-module/workflow.yaml +9 -9
  56. package/src/modules/bmb/workflows/create-workflow/README.md +4 -4
  57. package/src/modules/bmb/workflows/create-workflow/checklist.md +1 -1
  58. package/src/modules/bmb/workflows/create-workflow/instructions.md +29 -29
  59. package/src/modules/bmb/workflows/create-workflow/workflow-creation-guide.md +40 -42
  60. package/src/modules/bmb/workflows/create-workflow/workflow-template/instructions.md +2 -2
  61. package/src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml +12 -12
  62. package/src/modules/bmb/workflows/create-workflow/workflow.yaml +5 -5
  63. package/src/modules/bmb/workflows/edit-agent/checklist.md +1 -1
  64. package/src/modules/bmb/workflows/edit-agent/instructions.md +2 -2
  65. package/src/modules/bmb/workflows/edit-agent/workflow.yaml +8 -8
  66. package/src/modules/bmb/workflows/edit-module/README.md +2 -2
  67. package/src/modules/bmb/workflows/edit-module/checklist.md +2 -2
  68. package/src/modules/bmb/workflows/edit-module/instructions.md +4 -4
  69. package/src/modules/bmb/workflows/edit-module/workflow.yaml +10 -10
  70. package/src/modules/bmb/workflows/edit-workflow/instructions.md +4 -4
  71. package/src/modules/bmb/workflows/edit-workflow/workflow.yaml +5 -5
  72. package/src/modules/bmb/workflows/module-brief/README.md +2 -2
  73. package/src/modules/bmb/workflows/module-brief/checklist.md +2 -2
  74. package/src/modules/bmb/workflows/module-brief/instructions.md +2 -2
  75. package/src/modules/bmb/workflows/module-brief/workflow.yaml +4 -4
  76. package/src/modules/bmb/workflows/redoc/README.md +5 -5
  77. package/src/modules/bmb/workflows/redoc/instructions.md +1 -1
  78. package/src/modules/bmb/workflows/redoc/workflow.yaml +1 -1
  79. package/src/modules/bmgd/README.md +1 -1
  80. package/src/modules/bmgd/_module-installer/install-config.yaml +12 -24
  81. package/src/modules/bmgd/agents/game-architect.agent.yaml +15 -10
  82. package/src/modules/bmgd/agents/game-designer.agent.yaml +16 -11
  83. package/src/modules/bmgd/agents/game-dev.agent.yaml +18 -12
  84. package/src/modules/bmgd/agents/game-scrum-master.agent.yaml +30 -25
  85. package/src/modules/bmgd/teams/default-party.csv +10 -0
  86. package/src/modules/bmgd/teams/team-gamedev.yaml +2 -0
  87. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md +1 -1
  88. package/src/modules/bmgd/workflows/1-preproduction/brainstorm-game/workflow.yaml +9 -9
  89. package/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md +1 -1
  90. package/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml +8 -8
  91. package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md +5 -10
  92. package/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml +30 -30
  93. package/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md +1 -6
  94. package/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml +5 -5
  95. package/src/modules/bmgd/workflows/3-technical/game-architecture/architecture-patterns.yaml +0 -26
  96. package/src/modules/bmgd/workflows/3-technical/game-architecture/checklist.md +2 -6
  97. package/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md +2 -7
  98. package/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml +2 -2
  99. package/src/modules/bmgd/workflows/4-production/code-review/instructions.md +25 -47
  100. package/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml +13 -32
  101. package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md +1 -1
  102. package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md +7 -2
  103. package/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml +32 -25
  104. package/src/modules/bmgd/workflows/4-production/create-story/instructions.md +20 -47
  105. package/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml +16 -24
  106. package/src/modules/bmgd/workflows/4-production/dev-story/instructions.md +8 -3
  107. package/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml +30 -5
  108. package/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md +1 -1
  109. package/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md +10 -35
  110. package/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml +16 -24
  111. package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md +18 -36
  112. package/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml +16 -37
  113. package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md +11 -15
  114. package/src/modules/bmgd/workflows/4-production/sprint-planning/sprint-status-template.yaml +1 -1
  115. package/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml +8 -7
  116. package/src/modules/bmgd/workflows/4-production/story-context/checklist.md +1 -1
  117. package/src/modules/bmgd/workflows/4-production/story-context/context-template.xml +1 -1
  118. package/src/modules/bmgd/workflows/4-production/story-context/instructions.md +20 -45
  119. package/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml +15 -17
  120. package/src/modules/bmgd/workflows/4-production/story-done/instructions.md +1 -1
  121. package/src/modules/bmgd/workflows/4-production/story-done/workflow.yaml +5 -4
  122. package/src/modules/bmgd/workflows/4-production/story-ready/instructions.md +6 -6
  123. package/src/modules/bmgd/workflows/4-production/story-ready/workflow.yaml +5 -7
  124. package/src/modules/bmm/_module-installer/install-config.yaml +9 -28
  125. package/src/modules/bmm/_module-installer/installer.js +2 -2
  126. package/src/modules/bmm/agents/analyst.agent.yaml +20 -15
  127. package/src/modules/bmm/agents/architect.agent.yaml +17 -12
  128. package/src/modules/bmm/agents/dev.agent.yaml +9 -12
  129. package/src/modules/bmm/agents/pm.agent.yaml +24 -23
  130. package/src/modules/bmm/agents/sm.agent.yaml +24 -19
  131. package/src/modules/bmm/agents/tea.agent.yaml +23 -17
  132. package/src/modules/bmm/agents/tech-writer.agent.yaml +15 -11
  133. package/src/modules/bmm/agents/ux-designer.agent.yaml +16 -11
  134. package/src/modules/bmm/docs/agents-guide.md +4 -4
  135. package/src/modules/bmm/docs/brownfield-guide.md +4 -4
  136. package/src/modules/bmm/docs/enterprise-agentic-development.md +3 -3
  137. package/src/modules/bmm/docs/faq.md +1 -1
  138. package/src/modules/bmm/docs/party-mode.md +3 -3
  139. package/src/modules/bmm/docs/quick-start.md +1 -1
  140. package/src/modules/bmm/docs/test-architecture.md +1 -1
  141. package/src/modules/bmm/docs/workflow-document-project-reference.md +1 -1
  142. package/src/modules/bmm/teams/default-party.csv +19 -0
  143. package/src/modules/bmm/teams/team-fullstack.yaml +1 -0
  144. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/instructions.md +1 -1
  145. package/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml +8 -8
  146. package/src/modules/bmm/workflows/1-analysis/domain-research/instructions.md +1 -1
  147. package/src/modules/bmm/workflows/1-analysis/domain-research/workflow.yaml +8 -21
  148. package/src/modules/bmm/workflows/1-analysis/product-brief/instructions.md +10 -12
  149. package/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml +13 -9
  150. package/src/modules/bmm/workflows/1-analysis/research/checklist-deep-prompt.md +2 -2
  151. package/src/modules/bmm/workflows/1-analysis/research/checklist-technical.md +2 -2
  152. package/src/modules/bmm/workflows/1-analysis/research/checklist.md +2 -2
  153. package/src/modules/bmm/workflows/1-analysis/research/instructions-deep-prompt.md +1 -3
  154. package/src/modules/bmm/workflows/1-analysis/research/instructions-market.md +2 -7
  155. package/src/modules/bmm/workflows/1-analysis/research/instructions-router.md +1 -1
  156. package/src/modules/bmm/workflows/1-analysis/research/instructions-technical.md +1 -6
  157. package/src/modules/bmm/workflows/1-analysis/research/workflow.yaml +14 -14
  158. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md +7 -2
  159. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml +16 -10
  160. package/src/modules/bmm/workflows/2-plan-workflows/prd/checklist.md +8 -12
  161. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md +28 -0
  162. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md +146 -23
  163. package/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml +7 -9
  164. package/src/modules/bmm/workflows/2-plan-workflows/prd/instructions.md +152 -35
  165. package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +2 -2
  166. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml +20 -16
  167. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/checklist.md +12 -9
  168. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/epics-template.md +0 -6
  169. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-generate-stories.md +434 -0
  170. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions.md +129 -266
  171. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml +15 -37
  172. package/src/modules/bmm/workflows/3-solutioning/architecture/architecture-patterns.yaml +0 -26
  173. package/src/modules/bmm/workflows/3-solutioning/architecture/checklist.md +3 -7
  174. package/src/modules/bmm/workflows/3-solutioning/architecture/instructions.md +30 -38
  175. package/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml +25 -43
  176. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/checklist.md +7 -13
  177. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/instructions.md +57 -60
  178. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml +12 -12
  179. package/src/modules/bmm/workflows/4-implementation/code-review/instructions.md +25 -47
  180. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +13 -32
  181. package/src/modules/bmm/workflows/4-implementation/correct-course/checklist.md +1 -1
  182. package/src/modules/bmm/workflows/4-implementation/correct-course/instructions.md +7 -2
  183. package/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml +32 -25
  184. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.md +20 -47
  185. package/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml +16 -24
  186. package/src/modules/bmm/workflows/4-implementation/dev-story/instructions.md +8 -3
  187. package/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml +30 -5
  188. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/checklist.md +1 -1
  189. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/instructions.md +10 -35
  190. package/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml +16 -24
  191. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +18 -36
  192. package/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml +16 -37
  193. package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +11 -15
  194. package/src/modules/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +1 -1
  195. package/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +8 -7
  196. package/src/modules/bmm/workflows/4-implementation/story-context/checklist.md +1 -1
  197. package/src/modules/bmm/workflows/4-implementation/story-context/context-template.xml +1 -1
  198. package/src/modules/bmm/workflows/4-implementation/story-context/instructions.md +20 -45
  199. package/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml +15 -17
  200. package/src/modules/bmm/workflows/4-implementation/story-done/instructions.md +1 -1
  201. package/src/modules/bmm/workflows/4-implementation/story-done/workflow.yaml +5 -4
  202. package/src/modules/bmm/workflows/4-implementation/story-ready/instructions.md +6 -6
  203. package/src/modules/bmm/workflows/4-implementation/story-ready/workflow.yaml +5 -7
  204. package/src/modules/bmm/workflows/document-project/checklist.md +1 -1
  205. package/src/modules/bmm/workflows/document-project/instructions.md +5 -5
  206. package/src/modules/bmm/workflows/document-project/workflow.yaml +2 -2
  207. package/src/modules/bmm/workflows/document-project/workflows/deep-dive-instructions.md +4 -4
  208. package/src/modules/bmm/workflows/document-project/workflows/deep-dive.yaml +5 -5
  209. package/src/modules/bmm/workflows/document-project/workflows/full-scan-instructions.md +13 -13
  210. package/src/modules/bmm/workflows/document-project/workflows/full-scan.yaml +5 -5
  211. package/src/modules/bmm/workflows/testarch/atdd/instructions.md +2 -2
  212. package/src/modules/bmm/workflows/testarch/atdd/workflow.yaml +2 -2
  213. package/src/modules/bmm/workflows/testarch/automate/instructions.md +2 -2
  214. package/src/modules/bmm/workflows/testarch/automate/workflow.yaml +2 -2
  215. package/src/modules/bmm/workflows/testarch/ci/checklist.md +4 -4
  216. package/src/modules/bmm/workflows/testarch/ci/instructions.md +2 -2
  217. package/src/modules/bmm/workflows/testarch/ci/workflow.yaml +2 -2
  218. package/src/modules/bmm/workflows/testarch/framework/checklist.md +4 -4
  219. package/src/modules/bmm/workflows/testarch/framework/instructions.md +2 -2
  220. package/src/modules/bmm/workflows/testarch/framework/workflow.yaml +2 -2
  221. package/src/modules/bmm/workflows/testarch/nfr-assess/instructions.md +1 -1
  222. package/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml +2 -2
  223. package/src/modules/bmm/workflows/testarch/test-design/checklist.md +4 -4
  224. package/src/modules/bmm/workflows/testarch/test-design/instructions.md +175 -14
  225. package/src/modules/bmm/workflows/testarch/test-design/test-design-template.md +4 -4
  226. package/src/modules/bmm/workflows/testarch/test-design/workflow.yaml +7 -3
  227. package/src/modules/bmm/workflows/testarch/test-review/instructions.md +1 -1
  228. package/src/modules/bmm/workflows/testarch/test-review/workflow.yaml +2 -2
  229. package/src/modules/bmm/workflows/testarch/trace/instructions.md +9 -9
  230. package/src/modules/bmm/workflows/testarch/trace/workflow.yaml +2 -2
  231. package/src/modules/bmm/workflows/workflow-status/init/instructions.md +33 -31
  232. package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml +5 -4
  233. package/src/modules/bmm/workflows/workflow-status/instructions.md +5 -4
  234. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +9 -16
  235. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +11 -18
  236. package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +8 -1
  237. package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +9 -2
  238. package/src/modules/bmm/workflows/workflow-status/project-levels.yaml +1 -1
  239. package/src/modules/bmm/workflows/workflow-status/workflow-status-template.yaml +2 -9
  240. package/src/modules/bmm/workflows/workflow-status/workflow.yaml +2 -2
  241. package/src/modules/cis/README.md +1 -1
  242. package/src/modules/cis/_module-installer/install-config.yaml +6 -4
  243. package/src/modules/cis/agents/README.md +1 -1
  244. package/src/modules/cis/agents/brainstorming-coach.agent.yaml +13 -8
  245. package/src/modules/cis/agents/creative-problem-solver.agent.yaml +13 -8
  246. package/src/modules/cis/agents/design-thinking-coach.agent.yaml +13 -8
  247. package/src/modules/cis/agents/innovation-strategist.agent.yaml +13 -8
  248. package/src/modules/cis/agents/storyteller.agent.yaml +13 -8
  249. package/src/modules/cis/teams/creative-squad.yaml +1 -0
  250. package/src/modules/cis/teams/default-party.csv +11 -0
  251. package/src/modules/cis/workflows/README.md +1 -1
  252. package/src/modules/cis/workflows/design-thinking/instructions.md +2 -2
  253. package/src/modules/cis/workflows/design-thinking/workflow.yaml +7 -7
  254. package/src/modules/cis/workflows/innovation-strategy/instructions.md +2 -2
  255. package/src/modules/cis/workflows/innovation-strategy/workflow.yaml +7 -7
  256. package/src/modules/cis/workflows/problem-solving/instructions.md +2 -2
  257. package/src/modules/cis/workflows/problem-solving/workflow.yaml +7 -7
  258. package/src/modules/cis/workflows/storytelling/instructions.md +2 -2
  259. package/src/modules/cis/workflows/storytelling/workflow.yaml +7 -7
  260. package/src/utility/models/action-command-header.md +0 -0
  261. package/src/utility/models/agent-activation-ide.xml +3 -3
  262. package/src/utility/models/agent-activation-web.xml +4 -4
  263. package/src/utility/models/agent-command-header.md +1 -0
  264. package/src/utility/models/fragments/activation-steps.xml +3 -2
  265. package/src/utility/models/fragments/handler-validate-workflow.xml +1 -1
  266. package/src/utility/models/fragments/handler-workflow.xml +1 -1
  267. package/src/utility/models/fragments/web-bundle-activation-steps.xml +3 -3
  268. package/tools/cli/README.md +50 -32
  269. package/tools/cli/bundlers/web-bundler.js +86 -17
  270. package/tools/cli/commands/install.js +1 -4
  271. package/tools/cli/installers/lib/core/config-collector.js +201 -28
  272. package/tools/cli/installers/lib/core/detector.js +62 -7
  273. package/tools/cli/installers/lib/core/installer.js +175 -33
  274. package/tools/cli/installers/lib/core/manifest-generator.js +26 -115
  275. package/tools/cli/installers/lib/ide/_base-ide.js +57 -3
  276. package/tools/cli/installers/lib/ide/auggie.js +78 -224
  277. package/tools/cli/installers/lib/ide/claude-code.js +14 -22
  278. package/tools/cli/installers/lib/ide/cline.js +15 -18
  279. package/tools/cli/installers/lib/ide/codex.js +17 -48
  280. package/tools/cli/installers/lib/ide/crush.js +14 -50
  281. package/tools/cli/installers/lib/ide/cursor.js +51 -8
  282. package/tools/cli/installers/lib/ide/gemini.js +87 -37
  283. package/tools/cli/installers/lib/ide/github-copilot.js +47 -35
  284. package/tools/cli/installers/lib/ide/iflow.js +13 -30
  285. package/tools/cli/installers/lib/ide/kilo.js +20 -16
  286. package/tools/cli/installers/lib/ide/manager.js +15 -0
  287. package/tools/cli/installers/lib/ide/opencode.js +16 -17
  288. package/tools/cli/installers/lib/ide/qwen.js +39 -11
  289. package/tools/cli/installers/lib/ide/roo.js +27 -62
  290. package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +90 -0
  291. package/tools/cli/installers/lib/ide/{task-tool-command-generator.js → shared/task-tool-command-generator.js} +1 -1
  292. package/tools/cli/installers/lib/ide/{workflow-command-generator.js → shared/workflow-command-generator.js} +11 -9
  293. package/tools/cli/installers/lib/ide/templates/agent-command-template.md +14 -0
  294. package/tools/cli/installers/lib/ide/templates/gemini-agent-command.toml +14 -0
  295. package/tools/cli/installers/lib/ide/templates/gemini-task-command.toml +12 -0
  296. package/tools/cli/installers/lib/ide/{workflow-command-template.md → templates/workflow-command-template.md} +3 -5
  297. package/tools/cli/installers/lib/ide/trae.js +20 -32
  298. package/tools/cli/installers/lib/ide/windsurf.js +18 -8
  299. package/tools/cli/installers/lib/modules/manager.js +89 -17
  300. package/tools/cli/lib/cli-utils.js +52 -50
  301. package/tools/cli/lib/ui.js +29 -12
  302. package/tools/cli/lib/yaml-xml-builder.js +20 -2
  303. package/tools/schema/agent.js +7 -3
  304. package/.claude/commands/bmad/bmb/agents/bmad-builder.md +0 -70
  305. package/.claude/commands/bmad/bmb/workflows/audit-workflow.md +0 -15
  306. package/.claude/commands/bmad/bmb/workflows/convert-legacy.md +0 -15
  307. package/.claude/commands/bmad/bmb/workflows/create-agent.md +0 -15
  308. package/.claude/commands/bmad/bmb/workflows/create-module.md +0 -15
  309. package/.claude/commands/bmad/bmb/workflows/create-workflow.md +0 -15
  310. package/.claude/commands/bmad/bmb/workflows/edit-agent.md +0 -15
  311. package/.claude/commands/bmad/bmb/workflows/edit-module.md +0 -15
  312. package/.claude/commands/bmad/bmb/workflows/edit-workflow.md +0 -15
  313. package/.claude/commands/bmad/bmb/workflows/module-brief.md +0 -15
  314. package/.claude/commands/bmad/bmb/workflows/redoc.md +0 -15
  315. package/.claude/commands/bmad/core/agents/bmad-master.md +0 -71
  316. package/.claude/commands/bmad/core/tasks/index-docs.md +0 -9
  317. package/.claude/commands/bmad/core/tools/shard-doc.md +0 -9
  318. package/.claude/commands/bmad/core/workflows/brainstorming.md +0 -15
  319. package/.claude/commands/bmad/core/workflows/party-mode.md +0 -15
  320. package/.claude/settings.local.json +0 -22
  321. package/bmad/_cfg/agent-manifest.csv +0 -5
  322. package/bmad/_cfg/agents/bmb-bmad-builder.customize.yaml +0 -42
  323. package/bmad/_cfg/agents/core-bmad-master.customize.yaml +0 -42
  324. package/bmad/_cfg/files-manifest.csv +0 -82
  325. package/bmad/_cfg/ides/claude-code.yaml +0 -6
  326. package/bmad/_cfg/manifest.yaml +0 -11
  327. package/bmad/_cfg/task-manifest.csv +0 -13
  328. package/bmad/_cfg/tool-manifest.csv +0 -4
  329. package/bmad/_cfg/workflow-manifest.csv +0 -17
  330. package/bmad/bmb/README.md +0 -194
  331. package/bmad/bmb/agents/bmad-builder.md +0 -70
  332. package/bmad/bmb/config.yaml +0 -14
  333. package/bmad/bmb/workflows/audit-workflow/checklist.md +0 -143
  334. package/bmad/bmb/workflows/audit-workflow/instructions.md +0 -341
  335. package/bmad/bmb/workflows/audit-workflow/template.md +0 -118
  336. package/bmad/bmb/workflows/audit-workflow/workflow.yaml +0 -23
  337. package/bmad/bmb/workflows/convert-legacy/README.md +0 -262
  338. package/bmad/bmb/workflows/convert-legacy/checklist.md +0 -205
  339. package/bmad/bmb/workflows/convert-legacy/instructions.md +0 -377
  340. package/bmad/bmb/workflows/convert-legacy/workflow.yaml +0 -32
  341. package/bmad/bmb/workflows/create-agent/README.md +0 -203
  342. package/bmad/bmb/workflows/create-agent/agent-architecture.md +0 -419
  343. package/bmad/bmb/workflows/create-agent/agent-command-patterns.md +0 -759
  344. package/bmad/bmb/workflows/create-agent/agent-types.md +0 -292
  345. package/bmad/bmb/workflows/create-agent/brainstorm-context.md +0 -174
  346. package/bmad/bmb/workflows/create-agent/checklist.md +0 -62
  347. package/bmad/bmb/workflows/create-agent/communication-styles.md +0 -202
  348. package/bmad/bmb/workflows/create-agent/instructions.md +0 -459
  349. package/bmad/bmb/workflows/create-agent/workflow.yaml +0 -37
  350. package/bmad/bmb/workflows/create-module/README.md +0 -229
  351. package/bmad/bmb/workflows/create-module/brainstorm-context.md +0 -137
  352. package/bmad/bmb/workflows/create-module/checklist.md +0 -244
  353. package/bmad/bmb/workflows/create-module/installer-templates/install-config.yaml +0 -92
  354. package/bmad/bmb/workflows/create-module/installer-templates/installer.js +0 -231
  355. package/bmad/bmb/workflows/create-module/instructions.md +0 -581
  356. package/bmad/bmb/workflows/create-module/module-structure.md +0 -400
  357. package/bmad/bmb/workflows/create-module/workflow.yaml +0 -42
  358. package/bmad/bmb/workflows/create-workflow/README.md +0 -277
  359. package/bmad/bmb/workflows/create-workflow/brainstorm-context.md +0 -197
  360. package/bmad/bmb/workflows/create-workflow/checklist.md +0 -94
  361. package/bmad/bmb/workflows/create-workflow/instructions.md +0 -724
  362. package/bmad/bmb/workflows/create-workflow/workflow-creation-guide.md +0 -1308
  363. package/bmad/bmb/workflows/create-workflow/workflow-template/checklist.md +0 -24
  364. package/bmad/bmb/workflows/create-workflow/workflow-template/instructions.md +0 -13
  365. package/bmad/bmb/workflows/create-workflow/workflow-template/template.md +0 -9
  366. package/bmad/bmb/workflows/create-workflow/workflow-template/workflow.yaml +0 -39
  367. package/bmad/bmb/workflows/create-workflow/workflow.yaml +0 -40
  368. package/bmad/bmb/workflows/edit-agent/README.md +0 -112
  369. package/bmad/bmb/workflows/edit-agent/checklist.md +0 -112
  370. package/bmad/bmb/workflows/edit-agent/instructions.md +0 -290
  371. package/bmad/bmb/workflows/edit-agent/workflow.yaml +0 -33
  372. package/bmad/bmb/workflows/edit-module/README.md +0 -187
  373. package/bmad/bmb/workflows/edit-module/checklist.md +0 -165
  374. package/bmad/bmb/workflows/edit-module/instructions.md +0 -339
  375. package/bmad/bmb/workflows/edit-module/workflow.yaml +0 -34
  376. package/bmad/bmb/workflows/edit-workflow/README.md +0 -119
  377. package/bmad/bmb/workflows/edit-workflow/checklist.md +0 -70
  378. package/bmad/bmb/workflows/edit-workflow/instructions.md +0 -342
  379. package/bmad/bmb/workflows/edit-workflow/workflow.yaml +0 -27
  380. package/bmad/bmb/workflows/module-brief/README.md +0 -264
  381. package/bmad/bmb/workflows/module-brief/checklist.md +0 -116
  382. package/bmad/bmb/workflows/module-brief/instructions.md +0 -267
  383. package/bmad/bmb/workflows/module-brief/template.md +0 -275
  384. package/bmad/bmb/workflows/module-brief/workflow.yaml +0 -29
  385. package/bmad/bmb/workflows/redoc/README.md +0 -87
  386. package/bmad/bmb/workflows/redoc/checklist.md +0 -99
  387. package/bmad/bmb/workflows/redoc/instructions.md +0 -265
  388. package/bmad/bmb/workflows/redoc/workflow.yaml +0 -32
  389. package/bmad/core/agents/bmad-master.md +0 -71
  390. package/bmad/core/agents/bmad-web-orchestrator.agent.xml +0 -122
  391. package/bmad/core/config.yaml +0 -9
  392. package/bmad/core/tasks/adv-elicit-methods.csv +0 -39
  393. package/bmad/core/tasks/adv-elicit.xml +0 -104
  394. package/bmad/core/tasks/index-docs.xml +0 -65
  395. package/bmad/core/tasks/validate-workflow.xml +0 -89
  396. package/bmad/core/tasks/workflow.xml +0 -156
  397. package/bmad/core/tools/shard-doc.xml +0 -65
  398. package/bmad/core/workflows/brainstorming/README.md +0 -271
  399. package/bmad/core/workflows/brainstorming/brain-methods.csv +0 -36
  400. package/bmad/core/workflows/brainstorming/instructions.md +0 -314
  401. package/bmad/core/workflows/brainstorming/template.md +0 -102
  402. package/bmad/core/workflows/brainstorming/workflow.yaml +0 -43
  403. package/bmad/core/workflows/party-mode/instructions.md +0 -188
  404. package/bmad/core/workflows/party-mode/workflow.yaml +0 -23
  405. package/bmad/docs/claude-code-instructions.md +0 -25
  406. package/bmd/README.md +0 -193
  407. package/bmd/agents/cli-chief-sidecar/instructions.md +0 -102
  408. package/bmd/agents/cli-chief-sidecar/knowledge/README.md +0 -68
  409. package/bmd/agents/cli-chief-sidecar/knowledge/cli-reference.md +0 -123
  410. package/bmd/agents/cli-chief-sidecar/memories.md +0 -53
  411. package/bmd/agents/cli-chief.agent.yaml +0 -126
  412. package/bmd/agents/doc-keeper-sidecar/instructions.md +0 -177
  413. package/bmd/agents/doc-keeper-sidecar/knowledge/README.md +0 -81
  414. package/bmd/agents/doc-keeper-sidecar/memories.md +0 -88
  415. package/bmd/agents/doc-keeper.agent.yaml +0 -137
  416. package/bmd/agents/release-chief-sidecar/instructions.md +0 -164
  417. package/bmd/agents/release-chief-sidecar/knowledge/README.md +0 -82
  418. package/bmd/agents/release-chief-sidecar/memories.md +0 -73
  419. package/bmd/agents/release-chief.agent.yaml +0 -127
  420. package/bmd/bmad-custom-module-installer-plan.md +0 -1176
  421. package/bmd/config.yaml +0 -12
  422. package/src/modules/bmgd/workflows/4-production/dev-story/AUDIT-REPORT.md +0 -367
  423. package/src/modules/bmm/sub-modules/claude-code/README.md +0 -87
  424. package/src/modules/bmm/sub-modules/claude-code/config.yaml +0 -5
  425. package/src/modules/bmm/sub-modules/claude-code/injections.yaml +0 -242
  426. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/api-documenter.md +0 -102
  427. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/codebase-analyzer.md +0 -82
  428. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/data-analyst.md +0 -101
  429. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-analysis/pattern-detector.md +0 -84
  430. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/dependency-mapper.md +0 -83
  431. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/epic-optimizer.md +0 -81
  432. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/requirements-analyst.md +0 -61
  433. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/technical-decisions-curator.md +0 -168
  434. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/trend-spotter.md +0 -115
  435. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/user-journey-mapper.md +0 -123
  436. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-planning/user-researcher.md +0 -72
  437. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-research/market-researcher.md +0 -51
  438. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-research/tech-debt-auditor.md +0 -106
  439. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-review/document-reviewer.md +0 -102
  440. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-review/technical-evaluator.md +0 -68
  441. package/src/modules/bmm/sub-modules/claude-code/sub-agents/bmad-review/test-coverage-analyzer.md +0 -108
  442. package/src/modules/bmm/tasks/daily-standup.xml +0 -85
  443. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level0-story.md +0 -200
  444. package/src/modules/bmm/workflows/2-plan-workflows/tech-spec/instructions-level1-stories.md +0 -451
  445. package/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/validation-criteria.yaml +0 -189
  446. package/src/modules/bmm/workflows/4-implementation/dev-story/AUDIT-REPORT.md +0 -367
  447. package/src/modules/bmm/workflows/workflow-status/sample-level-3-workflow.yaml +0 -49
  448. package/test/fixtures/agent-schema/invalid/persona/principles-as-string.agent.yaml +0 -23
  449. package/web-bundles/bmm/agents/analyst.xml +0 -5028
  450. package/web-bundles/bmm/agents/architect.xml +0 -2047
  451. package/web-bundles/bmm/agents/dev.xml +0 -68
  452. package/web-bundles/bmm/agents/pm.xml +0 -3808
  453. package/web-bundles/bmm/agents/sm.xml +0 -77
  454. package/web-bundles/bmm/agents/tea.xml +0 -66
  455. package/web-bundles/bmm/agents/tech-writer.xml +0 -84
  456. package/web-bundles/bmm/agents/ux-designer.xml +0 -2018
  457. package/web-bundles/bmm/teams/team-fullstack.xml +0 -12039
@@ -2,7 +2,7 @@
2
2
 
3
3
  <workflow>
4
4
 
5
- <critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
5
+ <critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
6
6
  <critical>You MUST have already completed the GDD workflow</critical>
7
7
  <critical>Communicate all responses in {communication_language}</critical>
8
8
  <critical>This workflow creates detailed narrative content for story-driven games</critical>
@@ -143,7 +143,6 @@ For 3-Act:
143
143
  Describe each act/section for your game:</ask>
144
144
 
145
145
  <template-output>act_breakdown</template-output>
146
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
147
146
 
148
147
  </step>
149
148
 
@@ -162,7 +161,6 @@ Format:
162
161
  Your story beats:</ask>
163
162
 
164
163
  <template-output>story_beats</template-output>
165
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
166
164
 
167
165
  <ask>Describe the pacing and flow of your narrative.
168
166
 
@@ -195,7 +193,6 @@ For each protagonist include:
195
193
  Your protagonist(s):</ask>
196
194
 
197
195
  <template-output>protagonists</template-output>
198
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
199
196
 
200
197
  </step>
201
198
 
@@ -233,7 +230,6 @@ For each character include:
233
230
  Your supporting characters:</ask>
234
231
 
235
232
  <template-output>supporting_characters</template-output>
236
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
237
233
 
238
234
  </step>
239
235
 
@@ -281,7 +277,6 @@ Your world:</ask>
281
277
  Your history:</ask>
282
278
 
283
279
  <template-output>history_backstory</template-output>
284
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
285
280
 
286
281
  </step>
287
282
 
@@ -4,7 +4,7 @@ description: "Narrative design workflow for story-driven games and applications.
4
4
  author: "BMad"
5
5
 
6
6
  # Critical variables from config
7
- config_source: "{project-root}/bmad/bmgd/config.yaml"
7
+ config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
8
8
  output_folder: "{config_source}:output_folder"
9
9
  user_name: "{config_source}:user_name"
10
10
  communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
13
13
  date: system-generated
14
14
 
15
15
  # Workflow components
16
- installed_path: "{project-root}/bmad/bmgd/workflows/2-design/narrative"
16
+ installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/narrative"
17
17
  instructions: "{installed_path}/instructions-narrative.md"
18
18
  template: "{installed_path}/narrative-template.md"
19
19
 
@@ -32,7 +32,7 @@ web_bundle:
32
32
  name: "narrative"
33
33
  description: "Narrative design workflow for story-driven games and applications. Creates comprehensive narrative documentation including story structure, character arcs, dialogue systems, and narrative implementation guidance."
34
34
  author: "BMad"
35
- instructions: "bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
35
+ instructions: "{bmad_folder}/bmgd/workflows/2-design/narrative/instructions-narrative.md"
36
36
  web_bundle_files:
37
- - "bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
38
- - "bmad/bmgd/workflows/2-design/narrative/narrative-template.md"
37
+ - "{bmad_folder}/bmgd/workflows/2-design/narrative/instructions-narrative.md"
38
+ - "{bmad_folder}/bmgd/workflows/2-design/narrative/narrative-template.md"
@@ -319,29 +319,3 @@ decision_rules:
319
319
  - quick_prototype: "Railway"
320
320
  - global_edge: "Fly.io"
321
321
  - kubernetes_needed: "GCP or AWS EKS"
322
-
323
- # Anti-patterns to avoid
324
- anti_patterns:
325
- overengineering:
326
- signs:
327
- - "Microservices for < 10k users"
328
- - "Kubernetes for single app"
329
- - "GraphQL for 5 endpoints"
330
- - "Event sourcing for CRUD app"
331
- recommendation: "Start simple, evolve as needed"
332
-
333
- underengineering:
334
- signs:
335
- - "No authentication strategy"
336
- - "No error handling plan"
337
- - "No monitoring approach"
338
- - "No backup strategy"
339
- recommendation: "Cover the fundamentals"
340
-
341
- technology_soup:
342
- signs:
343
- - "5+ different databases"
344
- - "Multiple frontend frameworks"
345
- - "Inconsistent patterns"
346
- - "Too many languages"
347
- recommendation: "Maintain consistency"
@@ -225,15 +225,11 @@
225
225
 
226
226
  ### Critical Issues Found
227
227
 
228
- - [ ] Issue 1: **\*\***\_\_\_**\*\***
229
- - [ ] Issue 2: **\*\***\_\_\_**\*\***
230
- - [ ] Issue 3: **\*\***\_\_\_**\*\***
228
+ { list issues }
231
229
 
232
230
  ### Recommended Actions Before Implementation
233
231
 
234
- 1. ***
235
- 2. ***
236
- 3. ***
232
+ { list actions }
237
233
 
238
234
  ---
239
235
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  <workflow name="architecture">
4
4
 
5
- <critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
5
+ <critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
6
6
  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
7
7
  <critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication style based on {user_skill_level}</critical>
8
8
  <critical>The goal is ARCHITECTURAL DECISIONS that prevent AI agent conflicts, not detailed implementation specs</critical>
@@ -72,7 +72,7 @@ For Level {{project_level}}, we'll keep the architecture appropriately scoped.
72
72
 
73
73
  Decision Architecture works from your Product Requirements Document (PRD).
74
74
 
75
- Looking for: _PRD_, PRD.md, or prd/index.md + files in {output_folder}
75
+ Looking for: _prd_.md, or prd/index.md + files in {output_folder}
76
76
 
77
77
  Please run the PRD workflow first to define your requirements.
78
78
 
@@ -363,7 +363,6 @@ Provided by Starter: {{yes_if_from_starter}}
363
363
  </action>
364
364
 
365
365
  <template-output>decision_record</template-output>
366
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
367
366
  </step>
368
367
 
369
368
  <step n="5" goal="Address cross-cutting concerns">
@@ -393,7 +392,6 @@ Provided by Starter: {{yes_if_from_starter}}
393
392
  </action>
394
393
 
395
394
  <template-output>project_structure</template-output>
396
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
397
395
  </step>
398
396
 
399
397
  <step n="7" goal="Design novel architectural patterns" optional="true">
@@ -467,7 +465,6 @@ Provided by Starter: {{yes_if_from_starter}}
467
465
  </check>
468
466
 
469
467
  <template-output>novel_pattern_designs</template-output>
470
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
471
468
  </step>
472
469
 
473
470
  <step n="8" goal="Define implementation patterns to prevent agent conflicts">
@@ -560,7 +557,6 @@ Enforcement: "All agents MUST follow this pattern"
560
557
  </action>
561
558
 
562
559
  <template-output>implementation_patterns</template-output>
563
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
564
560
  </step>
565
561
 
566
562
  <step n="9" goal="Validate architectural coherence">
@@ -614,7 +610,6 @@ Enforcement: "All agents MUST follow this pattern"
614
610
  </action>
615
611
 
616
612
  <template-output>architecture_document</template-output>
617
- <invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
618
613
  </step>
619
614
 
620
615
  <step n="11" goal="Validate document completeness">
@@ -4,7 +4,7 @@ description: "Collaborative game architecture workflow for AI-agent consistency.
4
4
  author: "BMad"
5
5
 
6
6
  # Critical variables
7
- config_source: "{project-root}/bmad/bmgd/config.yaml"
7
+ config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
8
8
  output_folder: "{config_source}:output_folder"
9
9
  user_name: "{config_source}:user_name"
10
10
  communication_language: "{config_source}:communication_language"
@@ -37,7 +37,7 @@ input_file_patterns:
37
37
  sharded: "{output_folder}/docs/index.md"
38
38
 
39
39
  # Module path and component files
40
- installed_path: "{project-root}/bmad/bmgd/workflows/3-technical/game-architecture"
40
+ installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/3-technical/game-architecture"
41
41
  instructions: "{installed_path}/instructions.md"
42
42
  validation: "{installed_path}/checklist.md"
43
43
  template: "{installed_path}/architecture-template.md"
@@ -1,7 +1,7 @@
1
1
  # Senior Developer Review - Workflow Instructions
2
2
 
3
3
  ````xml
4
- <critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
4
+ <critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
5
5
  <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
6
6
  <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
7
7
  <critical>Generate all documents in {document_output_language}</critical>
@@ -16,35 +16,6 @@
16
16
 
17
17
  <critical>DOCUMENT OUTPUT: Technical review reports. Structured findings with severity levels and action items. User skill level ({user_skill_level}) affects conversation style ONLY, not review content.</critical>
18
18
 
19
- ## 📚 Document Discovery - Selective Epic Loading
20
-
21
- **Strategy**: This workflow needs only ONE specific epic and its stories for review context, not all epics. This provides huge efficiency gains when epics are sharded.
22
-
23
- **Epic Discovery Process (SELECTIVE OPTIMIZATION):**
24
-
25
- 1. **Determine which epic** you need (epic_num from story being reviewed - e.g., story "3-2-feature-name" needs Epic 3)
26
- 2. **Check for sharded version**: Look for `epics/index.md`
27
- 3. **If sharded version found**:
28
- - Read `index.md` to understand structure
29
- - **Load ONLY `epic-{epic_num}.md`** (e.g., `epics/epic-3.md` for Epic 3)
30
- - DO NOT load all epic files - only the one needed!
31
- - This is the key efficiency optimization for large multi-epic projects
32
- 4. **If whole document found**: Load the complete `epics.md` file and extract the relevant epic
33
-
34
- **Other Documents (architecture, ux-design) - Full Load:**
35
-
36
- 1. **Search for whole document first** - Use fuzzy file matching
37
- 2. **Check for sharded version** - If whole document not found, look for `{doc-name}/index.md`
38
- 3. **If sharded version found**:
39
- - Read `index.md` to understand structure
40
- - Read ALL section files listed in the index
41
- - Treat combined content as single document
42
- 4. **Brownfield projects**: The `document-project` workflow creates `{output_folder}/docs/index.md`
43
-
44
- **Priority**: If both whole and sharded versions exist, use the whole document.
45
-
46
- **UX-Heavy Projects**: Always check for ux-design documentation as it provides critical context for reviewing UI-focused stories.
47
-
48
19
  <workflow>
49
20
 
50
21
  <step n="1" goal="Find story ready for review" tag="sprint-status">
@@ -52,7 +23,7 @@
52
23
  <action>Use {{story_path}} directly</action>
53
24
  <action>Read COMPLETE story file and parse sections</action>
54
25
  <action>Extract story_key from filename or story metadata</action>
55
- <action>Verify Status is "review" - if not, HALT with message: "Story status must be 'review' to proceed"</action>
26
+ <action>Verify Status is "review" or "ready-for-review" - if not, HALT with message: "Story status must be 'review' or 'ready-for-review' to proceed"</action>
56
27
  </check>
57
28
 
58
29
  <check if="{{story_path}} is NOT provided">
@@ -64,11 +35,11 @@
64
35
  <action>Find FIRST story (reading in order from top to bottom) where:
65
36
  - Key matches pattern: number-number-name (e.g., "1-2-user-auth")
66
37
  - NOT an epic key (epic-X) or retrospective (epic-X-retrospective)
67
- - Status value equals "review"
38
+ - Status value equals "review" OR "ready-for-review"
68
39
  </action>
69
40
 
70
- <check if="no story with status 'review' found">
71
- <output>📋 No stories with status "review" found
41
+ <check if="no story with status 'review' or 'ready-for-review' found">
42
+ <output>📋 No stories with status "review" or "ready-for-review" found
72
43
 
73
44
  **What would you like to do?**
74
45
  1. Run `dev-story` to implement and mark a story ready for review
@@ -80,17 +51,18 @@
80
51
  <check if="option 3 selected">
81
52
  <ask>What code would you like me to review?
82
53
 
83
- Provide:
84
- - File path(s) or directory to review
85
- - What to review for:
86
- • General quality and standards
87
- • Requirements compliance
88
- • Security concerns
89
- • Performance issues
90
- • Architecture alignment
91
- • Something else (specify)
54
+ Provide:
55
+ - File path(s) or directory to review
56
+ - What to review for:
57
+ • General quality and standards
58
+ • Requirements compliance
59
+ • Security concerns
60
+ • Performance issues
61
+ • Architecture alignment
62
+ • Something else (specify)
92
63
 
93
- Your input:</ask>
64
+ Your input:?
65
+ </ask>
94
66
 
95
67
  <action>Parse user input to extract:
96
68
  - {{review_files}}: file paths or directories to review
@@ -117,6 +89,11 @@ Your input:</ask>
117
89
  <action if="story cannot be read">HALT with message: "Unable to read story file"</action>
118
90
  </step>
119
91
 
92
+ <step n="1.5" goal="Discover and load project documents">
93
+ <invoke-protocol name="discover_inputs" />
94
+ <note>After discovery, these content variables are available: {architecture_content}, {ux_design_content}, {epics_content} (loads only epic for this story if sharded), {document_project_content}</note>
95
+ </step>
96
+
120
97
  <step n="2" goal="Resolve story context file and specification inputs">
121
98
  <action>Locate story context file: Under Dev Agent Record → Context Reference, read referenced path(s). If missing, search {{output_folder}} for files matching pattern "story-{{epic_num}}.{{story_num}}*.context.xml" and use the most recent.</action>
122
99
  <action if="no story context file found">Continue but record a WARNING in review notes: "No story context file found"</action>
@@ -125,6 +102,7 @@ Your input:</ask>
125
102
  <action if="no tech spec found">Continue but record a WARNING in review notes: "No Tech Spec found for epic {{epic_num}}"</action>
126
103
 
127
104
  <action>Load architecture/standards docs: For each file name in {{arch_docs_file_names}} within {{arch_docs_search_dirs}}, read if exists. Collect testing, coding standards, security, and architectural patterns.</action>
105
+ <note>Architecture and brownfield docs were pre-loaded in Step 1.5 as {architecture_content} and {document_project_content}</note>
128
106
  </step>
129
107
 
130
108
  <step n="3" goal="Detect tech stack and establish best-practice reference set">
@@ -363,11 +341,11 @@ Review was saved to story file, but sprint-status.yaml may be out of sync.
363
341
  <action if="user confirms or no ask needed">
364
342
  Append under the story's "Tasks / Subtasks" a new subsection titled "Review Follow-ups (AI)", adding each item as an unchecked checkbox in imperative form, prefixed with "[AI-Review]" and severity. Example: "- [ ] [AI-Review][High] Add input validation on server route /api/x (AC #2)".
365
343
  </action>
366
- <action if="{{persist_action_items}} == true and 'backlog_file' in {{persist_targets}}">
344
+ <action>
367
345
  If {{backlog_file}} does not exist, copy {installed_path}/backlog_template.md to {{backlog_file}} location.
368
346
  Append a row per action item with Date={{date}}, Story={{epic_num}}.{{story_num}}, Epic={{epic_num}}, Type, Severity, Owner (or "TBD"), Status="Open", Notes with short context and file refs.
369
347
  </action>
370
- <action if="{{persist_action_items}} == true and ('epic_followups' in {{persist_targets}} or {{update_epic_followups}} == true)">
348
+ <action>
371
349
  If an epic Tech Spec was found: open it and create (if missing) a section titled "{{epic_followups_section_title}}". Append a bullet list of action items scoped to this epic with references back to Story {{epic_num}}.{{story_num}}.
372
350
  </action>
373
351
  <action>Save modified files.</action>
@@ -376,7 +354,7 @@ Review was saved to story file, but sprint-status.yaml may be out of sync.
376
354
  </step>
377
355
 
378
356
  <step n="10" goal="Validation and completion">
379
- <invoke-task>Run validation checklist at {installed_path}/checklist.md using {project-root}/bmad/core/tasks/validate-workflow.xml</invoke-task>
357
+ <invoke-task>Run validation checklist at {installed_path}/checklist.md using {project-root}/{bmad_folder}/core/tasks/validate-workflow.xml</invoke-task>
380
358
  <action>Report workflow completion.</action>
381
359
 
382
360
  <check if="ad_hoc_review_mode == true">
@@ -4,73 +4,54 @@ description: "Perform a Senior Developer code review on a completed story flagge
4
4
  author: "BMad"
5
5
 
6
6
  # Critical variables from config
7
- config_source: "{project-root}/bmad/bmgd/config.yaml"
7
+ config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
8
8
  output_folder: "{config_source}:output_folder"
9
9
  user_name: "{config_source}:user_name"
10
10
  communication_language: "{config_source}:communication_language"
11
11
  user_skill_level: "{config_source}:user_skill_level"
12
12
  document_output_language: "{config_source}:document_output_language"
13
13
  date: system-generated
14
+ sprint_artifacts: "{config_source}:sprint_artifacts"
15
+ sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
14
16
 
15
17
  # Workflow components
16
- installed_path: "{project-root}/bmad/bmm/workflows/4-implementation/code-review"
18
+ installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/code-review"
17
19
  instructions: "{installed_path}/instructions.md"
18
20
  validation: "{installed_path}/checklist.md"
19
-
20
- # This is an action workflow (no output template document)
21
21
  template: false
22
22
 
23
- # Variables (can be provided by caller)
24
23
  variables:
25
- story_path: "" # Optional: Explicit path to story file. If not provided, finds first story with status "review"
26
- story_dir: "{config_source}:dev_story_location" # Directory containing story files
27
- tech_spec_search_dir: "{project-root}/docs"
24
+ story_dir: "{sprint_artifacts}"
25
+ tech_spec_search_dir: "{output_folder}"
28
26
  tech_spec_glob_template: "tech-spec-epic-{{epic_num}}*.md"
29
27
  arch_docs_search_dirs: |
30
- - "{project-root}/docs"
31
28
  - "{output_folder}"
32
29
  arch_docs_file_names: |
33
30
  - architecture.md
34
- enable_mcp_doc_search: true # Prefer enabled MCP servers for doc/best-practice lookup
35
- enable_web_fallback: true # Fallback to web search/read-url if MCP not available
36
- # Persistence controls for review action items and notes
37
- persist_action_items: true
38
- # Valid targets: story_tasks, story_review_section, backlog_file, epic_followups
39
- persist_targets: |
40
- - story_review_section
41
- - story_tasks
42
- - backlog_file
43
- - epic_followups
44
- backlog_file: "{project-root}/docs/backlog.md"
31
+ backlog_file: "{output_folder}/backlog.md"
45
32
  update_epic_followups: true
46
33
  epic_followups_section_title: "Post-Review Follow-ups"
47
34
 
48
- # Recommended inputs
49
- recommended_inputs:
50
- - story: "Path to the story file (auto-discovered if omitted - finds first story with status 'review')"
51
- - tech_spec: "Epic technical specification document (auto-discovered)"
52
- - story_context_file: "Story context file (.context.xml) (auto-discovered)"
53
-
54
35
  # Smart input file references - handles both whole docs and sharded docs
55
36
  # Priority: Whole document first, then sharded version
56
37
  # Strategy: SELECTIVE LOAD - only load the specific epic needed for this story review
57
38
  input_file_patterns:
58
39
  architecture:
59
40
  whole: "{output_folder}/*architecture*.md"
60
- sharded: "{output_folder}/*architecture*/index.md"
61
-
41
+ sharded: "{output_folder}/*architecture*/*.md"
42
+ load_strategy: "FULL_LOAD"
62
43
  ux_design:
63
44
  whole: "{output_folder}/*ux*.md"
64
- sharded: "{output_folder}/*ux*/index.md"
65
-
45
+ sharded: "{output_folder}/*ux*/*.md"
46
+ load_strategy: "FULL_LOAD"
66
47
  epics:
67
48
  whole: "{output_folder}/*epic*.md"
68
49
  sharded_index: "{output_folder}/*epic*/index.md"
69
50
  sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
70
-
51
+ load_strategy: "SELECTIVE_LOAD"
71
52
  document_project:
72
53
  sharded: "{output_folder}/docs/index.md"
54
+ load_strategy: "INDEX_GUIDED"
73
55
 
74
56
  standalone: true
75
-
76
57
  web_bundle: false
@@ -1,6 +1,6 @@
1
1
  # Change Navigation Checklist
2
2
 
3
- <critical>This checklist is executed as part of: {project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
3
+ <critical>This checklist is executed as part of: {project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
4
4
  <critical>Work through each section systematically with the user, recording findings and impacts</critical>
5
5
 
6
6
  <checklist>
@@ -1,7 +1,7 @@
1
1
  # Correct Course - Sprint Change Management Instructions
2
2
 
3
- <critical>The workflow execution engine is governed by: {project-root}/bmad/core/tasks/workflow.xml</critical>
4
- <critical>You MUST have already loaded and processed: {project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
3
+ <critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
4
+ <critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
5
5
  <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
6
6
  <critical>Generate all documents in {document_output_language}</critical>
7
7
 
@@ -27,6 +27,11 @@
27
27
  <action if="core documents are unavailable">HALT: "Need access to project documents (PRD, Epics, Architecture, UI/UX) to assess change impact. Please ensure these documents are accessible."</action>
28
28
  </step>
29
29
 
30
+ <step n="0.5" goal="Discover and load project documents">
31
+ <invoke-protocol name="discover_inputs" />
32
+ <note>After discovery, these content variables are available: {prd_content}, {epics_content}, {architecture_content}, {ux_design_content}, {tech_spec_content}, {document_project_content}</note>
33
+ </step>
34
+
30
35
  <step n="2" goal="Execute Change Analysis Checklist">
31
36
  <action>Load and execute the systematic analysis from: {checklist}</action>
32
37
  <action>Work through each checklist section interactively with the user</action>
@@ -3,43 +3,50 @@ name: "correct-course"
3
3
  description: "Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation"
4
4
  author: "BMad Method"
5
5
 
6
- config_source: "{project-root}/bmad/bmgd/config.yaml"
6
+ config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
7
7
  output_folder: "{config_source}:output_folder"
8
8
  user_name: "{config_source}:user_name"
9
9
  communication_language: "{config_source}:communication_language"
10
10
  user_skill_level: "{config_source}:user_skill_level"
11
11
  document_output_language: "{config_source}:document_output_language"
12
12
  date: system-generated
13
-
14
- installed_path: "{project-root}/bmad/bmm/workflows/4-implementation/correct-course"
13
+ sprint_artifacts: "{config_source}:sprint_artifacts"
14
+ sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
15
+
16
+ # Smart input file references - handles both whole docs and sharded docs
17
+ # Priority: Whole document first, then sharded version
18
+ # Strategy: Load project context for impact analysis
19
+ input_file_patterns:
20
+ prd:
21
+ whole: "{output_folder}/*prd*.md"
22
+ sharded: "{output_folder}/*prd*/*.md"
23
+ load_strategy: "FULL_LOAD"
24
+ epics:
25
+ whole: "{output_folder}/*epic*.md"
26
+ sharded: "{output_folder}/*epic*/*.md"
27
+ load_strategy: "FULL_LOAD"
28
+ architecture:
29
+ whole: "{output_folder}/*architecture*.md"
30
+ sharded: "{output_folder}/*architecture*/*.md"
31
+ load_strategy: "FULL_LOAD"
32
+ ux_design:
33
+ whole: "{output_folder}/*ux*.md"
34
+ sharded: "{output_folder}/*ux*/*.md"
35
+ load_strategy: "FULL_LOAD"
36
+ tech_spec:
37
+ whole: "{output_folder}/tech-spec*.md"
38
+ load_strategy: "FULL_LOAD"
39
+ document_project:
40
+ sharded: "{output_folder}/docs/index.md"
41
+ load_strategy: "INDEX_GUIDED"
42
+
43
+ installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course"
15
44
  template: false
16
45
  instructions: "{installed_path}/instructions.md"
17
46
  validation: "{installed_path}/checklist.md"
18
47
  checklist: "{installed_path}/checklist.md"
19
48
  default_output_file: "{output_folder}/sprint-change-proposal-{date}.md"
20
49
 
21
- # Workflow execution mode (interactive: step-by-step with user, non-interactive: automated)
22
- mode: interactive
23
-
24
- required_inputs:
25
- - change_trigger: "Description of the issue or change that triggered this workflow"
26
- - project_documents: "Access to PRD, Epics/Stories, Architecture, UI/UX specs"
27
-
28
- output_artifacts:
29
- - sprint_change_proposal: "Comprehensive proposal documenting issue, impact, and recommended changes"
30
- - artifact_edits: "Specific before/after edits for affected documents"
31
- - handoff_plan: "Clear routing for implementation based on change scope"
32
-
33
- halt_conditions:
34
- - "Change trigger unclear or undefined"
35
- - "Core project documents unavailable"
36
- - "Impact analysis incomplete"
37
- - "User approval not obtained"
38
-
39
- execution_modes:
40
- - incremental: "Recommended - Refine each edit with user collaboration"
41
- - batch: "Present all changes at once for review"
42
-
43
50
  standalone: true
44
51
 
45
52
  web_bundle: false