bmad-method 6.0.0-alpha.13 → 6.0.0-alpha.15

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 (355) hide show
  1. package/.coderabbit.yaml +36 -0
  2. package/.github/CODE_OF_CONDUCT.md +128 -0
  3. package/.github/ISSUE_TEMPLATE/idea_submission.md +1 -1
  4. package/.github/scripts/discord-helpers.sh +15 -0
  5. package/.github/workflows/discord.yaml +278 -8
  6. package/.github/workflows/quality.yaml +19 -0
  7. package/.markdownlint-cli2.yaml +42 -0
  8. package/.prettierignore +3 -0
  9. package/CHANGELOG.md +183 -360
  10. package/README.md +4 -1
  11. package/docs/agent-customization-guide.md +2 -2
  12. package/docs/custom-content-installation.md +245 -0
  13. package/docs/document-sharding-guide.md +1 -1
  14. package/docs/index.md +2 -2
  15. package/docs/installers-bundlers/installers-modules-platforms-reference.md +6 -5
  16. package/docs/web-bundles-gemini-gpt-guide.md +1 -1
  17. package/eslint.config.mjs +14 -0
  18. package/example-custom-content/README.md +8 -0
  19. package/{custom/src → example-custom-content}/agents/commit-poet/commit-poet.agent.yaml +1 -1
  20. package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/instructions.md +5 -5
  21. package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/knowledge/docs.md +1 -1
  22. package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/knowledge/installers.md +1 -1
  23. package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/knowledge/modules.md +2 -2
  24. package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/memories.md +1 -1
  25. package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith.agent.yaml +18 -17
  26. package/example-custom-content/module.yaml +4 -0
  27. package/example-custom-content/workflows/quiz-master/steps/step-01-init.md +168 -0
  28. package/example-custom-content/workflows/quiz-master/steps/step-02-q1.md +155 -0
  29. package/example-custom-content/workflows/quiz-master/steps/step-03-q2.md +89 -0
  30. package/example-custom-content/workflows/quiz-master/steps/step-04-q3.md +36 -0
  31. package/example-custom-content/workflows/quiz-master/steps/step-05-q4.md +36 -0
  32. package/example-custom-content/workflows/quiz-master/steps/step-06-q5.md +36 -0
  33. package/example-custom-content/workflows/quiz-master/steps/step-07-q6.md +36 -0
  34. package/example-custom-content/workflows/quiz-master/steps/step-08-q7.md +36 -0
  35. package/example-custom-content/workflows/quiz-master/steps/step-09-q8.md +36 -0
  36. package/example-custom-content/workflows/quiz-master/steps/step-10-q9.md +36 -0
  37. package/example-custom-content/workflows/quiz-master/steps/step-11-q10.md +36 -0
  38. package/example-custom-content/workflows/quiz-master/steps/step-12-results.md +150 -0
  39. package/example-custom-content/workflows/quiz-master/templates/csv-headers.template +1 -0
  40. package/example-custom-content/workflows/quiz-master/workflow.md +54 -0
  41. package/example-custom-content/workflows/wassup/workflow.md +26 -0
  42. package/example-custom-module/mwm/README.md +9 -0
  43. package/example-custom-module/mwm/agents/cbt-coach/cbt-coach-sidecar/cognitive-distortions.md +47 -0
  44. package/example-custom-module/mwm/agents/cbt-coach/cbt-coach-sidecar/thought-records.md +17 -0
  45. package/example-custom-module/mwm/agents/cbt-coach/cbt-coach.agent.yaml +151 -0
  46. package/example-custom-module/mwm/agents/crisis-navigator.agent.yaml +138 -0
  47. package/example-custom-module/mwm/agents/meditation-guide.agent.yaml +138 -0
  48. package/example-custom-module/mwm/agents/wellness-companion/wellness-companion-sidecar/insights.md +13 -0
  49. package/example-custom-module/mwm/agents/wellness-companion/wellness-companion-sidecar/instructions.md +30 -0
  50. package/example-custom-module/mwm/agents/wellness-companion/wellness-companion-sidecar/memories.md +13 -0
  51. package/example-custom-module/mwm/agents/wellness-companion/wellness-companion-sidecar/patterns.md +17 -0
  52. package/example-custom-module/mwm/agents/wellness-companion/wellness-companion.agent.yaml +125 -0
  53. package/example-custom-module/mwm/module.yaml +28 -0
  54. package/example-custom-module/mwm/workflows/cbt-thought-record/README.md +31 -0
  55. package/example-custom-module/mwm/workflows/cbt-thought-record/workflow.md +45 -0
  56. package/example-custom-module/mwm/workflows/crisis-support/README.md +31 -0
  57. package/example-custom-module/mwm/workflows/crisis-support/workflow.md +45 -0
  58. package/example-custom-module/mwm/workflows/daily-checkin/README.md +32 -0
  59. package/example-custom-module/mwm/workflows/daily-checkin/workflow.md +45 -0
  60. package/example-custom-module/mwm/workflows/guided-meditation/README.md +31 -0
  61. package/example-custom-module/mwm/workflows/guided-meditation/workflow.md +45 -0
  62. package/example-custom-module/mwm/workflows/wellness-journal/README.md +31 -0
  63. package/example-custom-module/mwm/workflows/wellness-journal/workflow.md +45 -0
  64. package/package.json +9 -4
  65. package/src/core/_module-installer/installer.js +1 -1
  66. package/src/core/{_module-installer/install-config.yaml → module.yaml} +5 -1
  67. package/src/core/resources/excalidraw/library-loader.md +2 -2
  68. package/src/core/workflows/brainstorming/steps/step-01-session-setup.md +1 -1
  69. package/src/core/workflows/brainstorming/workflow.md +1 -1
  70. package/src/core/workflows/party-mode/steps/step-03-graceful-exit.md +0 -1
  71. package/src/core/workflows/party-mode/workflow.md +2 -3
  72. package/src/modules/bmb/README.md +1 -1
  73. package/src/modules/bmb/_module-installer/installer.js +76 -0
  74. package/src/modules/bmb/agents/bmad-builder.agent.yaml +32 -9
  75. package/src/modules/bmb/docs/agents/agent-menu-patterns.md +5 -5
  76. package/src/modules/bmb/docs/agents/expert-agent-architecture.md +20 -20
  77. package/src/modules/bmb/docs/agents/index.md +1 -1
  78. package/src/modules/bmb/docs/agents/module-agent-architecture.md +45 -45
  79. package/src/modules/bmb/docs/agents/simple-agent-architecture.md +7 -3
  80. package/src/modules/bmb/docs/workflows/architecture.md +1 -1
  81. package/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md +241 -0
  82. package/src/modules/bmb/docs/workflows/templates/step-1b-template.md +223 -0
  83. package/src/modules/bmb/{workflows/create-workflow → docs/workflows}/templates/step-file.md +4 -4
  84. package/src/modules/bmb/docs/workflows/{step-template.md → templates/step-template.md} +40 -33
  85. package/src/modules/bmb/docs/workflows/templates/workflow-template.md +104 -0
  86. package/src/modules/bmb/{workflows/create-workflow → docs/workflows}/templates/workflow.md +1 -1
  87. package/src/modules/bmb/{_module-installer/install-config.yaml → module.yaml} +4 -9
  88. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/README.md +4 -4
  89. package/src/modules/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml +8 -8
  90. package/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml +6 -6
  91. package/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml +7 -7
  92. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md +2 -3
  93. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md +10 -40
  94. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md +1 -1
  95. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md +1 -0
  96. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md +2 -2
  97. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md +2 -2
  98. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md +2 -2
  99. package/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md +2 -2
  100. package/src/modules/bmb/workflows/create-agent/data/info-and-installation-guide.md +16 -4
  101. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/README.md +4 -4
  102. package/src/modules/bmb/workflows/create-agent/data/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml +7 -7
  103. package/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md +1 -1
  104. package/src/modules/bmb/workflows/create-agent/data/validation-complete.md +3 -3
  105. package/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md +3 -3
  106. package/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md +3 -3
  107. package/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md +3 -3
  108. package/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md +6 -6
  109. package/src/modules/bmb/workflows/create-agent/steps/step-05-name.md +2 -2
  110. package/src/modules/bmb/workflows/create-agent/steps/step-06-build.md +3 -3
  111. package/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md +3 -3
  112. package/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md +2 -2
  113. package/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md +3 -3
  114. package/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md +2 -2
  115. package/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md +2 -2
  116. package/src/modules/bmb/workflows/create-agent/workflow.md +11 -11
  117. package/src/modules/bmb/workflows/create-module/steps/step-01-init.md +155 -0
  118. package/src/modules/bmb/workflows/create-module/steps/step-01b-continue.md +169 -0
  119. package/src/modules/bmb/workflows/create-module/steps/step-02-concept.md +217 -0
  120. package/src/modules/bmb/workflows/create-module/steps/step-03-components.md +267 -0
  121. package/src/modules/bmb/workflows/create-module/steps/step-04-structure.md +228 -0
  122. package/src/modules/bmb/workflows/create-module/steps/step-05-config.md +233 -0
  123. package/src/modules/bmb/workflows/create-module/steps/step-06-agents.md +296 -0
  124. package/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md +228 -0
  125. package/src/modules/bmb/workflows/create-module/steps/step-08-installer.md +186 -0
  126. package/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md +309 -0
  127. package/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md +337 -0
  128. package/src/modules/bmb/workflows/create-module/steps/step-11-validate.md +335 -0
  129. package/src/modules/bmb/workflows/create-module/templates/agent.template.md +317 -0
  130. package/src/modules/bmb/workflows/create-module/templates/installer.template.js +47 -0
  131. package/src/modules/bmb/workflows/create-module/templates/module-plan.template.md +5 -0
  132. package/src/modules/bmb/workflows/create-module/templates/module.template.yaml +53 -0
  133. package/src/modules/bmb/workflows/create-module/templates/workflow-plan-template.md +23 -0
  134. package/src/modules/bmb/workflows/create-module/validation.md +126 -0
  135. package/src/modules/bmb/workflows/create-module/workflow.md +55 -0
  136. package/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md +45 -56
  137. package/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md +9 -31
  138. package/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md +250 -0
  139. package/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md +216 -0
  140. package/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md +289 -0
  141. package/src/modules/bmb/workflows/create-workflow/steps/{step-09-design.md → step-06-design.md} +76 -44
  142. package/src/modules/bmb/workflows/create-workflow/steps/{step-11-build.md → step-07-build.md} +71 -25
  143. package/src/modules/bmb/workflows/create-workflow/steps/{step-12-review.md → step-08-review.md} +30 -16
  144. package/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md +187 -0
  145. package/src/modules/bmb/workflows/create-workflow/workflow.md +2 -2
  146. package/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md +2 -2
  147. package/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md +14 -14
  148. package/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md +4 -4
  149. package/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md +2 -2
  150. package/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md +4 -4
  151. package/src/modules/bmb/workflows/edit-agent/workflow.md +1 -1
  152. package/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md +2 -6
  153. package/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md +2 -2
  154. package/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md +1 -1
  155. package/src/modules/bmb/workflows/edit-workflow/workflow.md +1 -1
  156. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md +2 -2
  157. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md +5 -5
  158. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md +7 -7
  159. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md +3 -3
  160. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md +3 -3
  161. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md +3 -3
  162. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md +3 -3
  163. package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-08-generate-report.md +2 -2
  164. package/src/modules/bmb/workflows/workflow-compliance-check/workflow.md +1 -1
  165. package/src/modules/bmb/workflows-legacy/edit-module/checklist.md +0 -1
  166. package/src/modules/bmgd/README.md +2 -1
  167. package/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md +8 -8
  168. package/src/modules/bmm/_module-installer/installer.js +1 -1
  169. package/src/modules/bmm/_module-installer/platform-specifics/claude-code.js +1 -1
  170. package/src/modules/bmm/_module-installer/platform-specifics/windsurf.js +1 -1
  171. package/src/modules/bmm/agents/analyst.agent.yaml +11 -8
  172. package/src/modules/bmm/agents/architect.agent.yaml +1 -5
  173. package/src/modules/bmm/agents/pm.agent.yaml +5 -5
  174. package/src/modules/bmm/docs/README.md +23 -1
  175. package/src/modules/bmm/docs/agents-guide.md +16 -35
  176. package/src/modules/bmm/docs/brownfield-guide.md +17 -30
  177. package/src/modules/bmm/docs/enterprise-agentic-development.md +2 -2
  178. package/src/modules/bmm/docs/faq.md +6 -39
  179. package/src/modules/bmm/docs/glossary.md +11 -24
  180. package/src/modules/bmm/docs/images/README.md +37 -0
  181. package/src/modules/bmm/docs/images/workflow-method-greenfield.excalidraw +62 -202
  182. package/src/modules/bmm/docs/images/workflow-method-greenfield.svg +3 -1
  183. package/src/modules/bmm/docs/quick-spec-flow.md +652 -0
  184. package/src/modules/bmm/docs/quick-start.md +9 -25
  185. package/src/modules/bmm/docs/test-architecture.md +6 -6
  186. package/src/modules/bmm/docs/troubleshooting.md +680 -0
  187. package/src/modules/bmm/docs/workflow-document-project-reference.md +1 -1
  188. package/src/modules/bmm/docs/workflows-implementation.md +143 -3
  189. package/src/modules/bmm/docs/workflows-solutioning.md +2 -2
  190. package/src/modules/bmm/{_module-installer/install-config.yaml → module.yaml} +1 -1
  191. package/src/modules/bmm/tasks/daily-standup.xml +85 -0
  192. package/src/modules/bmm/testarch/knowledge/ci-burn-in.md +1 -1
  193. package/src/modules/bmm/testarch/knowledge/overview.md +1 -1
  194. package/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-02-vision.md +2 -2
  195. package/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-03-users.md +2 -2
  196. package/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-04-metrics.md +2 -2
  197. package/src/modules/bmm/workflows/1-analysis/product-brief/steps/step-05-scope.md +2 -2
  198. package/src/modules/bmm/workflows/1-analysis/product-brief/workflow.md +1 -1
  199. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +8 -8
  200. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +18 -18
  201. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +18 -18
  202. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +18 -18
  203. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +17 -17
  204. package/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +35 -36
  205. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +5 -6
  206. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +20 -19
  207. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +21 -20
  208. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +20 -19
  209. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +21 -20
  210. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +16 -15
  211. package/src/modules/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +36 -37
  212. package/src/modules/bmm/workflows/1-analysis/research/research.template.md +0 -1
  213. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +8 -8
  214. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +19 -18
  215. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +20 -19
  216. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +21 -20
  217. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +19 -18
  218. package/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +38 -39
  219. package/src/modules/bmm/workflows/1-analysis/research/workflow.md +14 -8
  220. package/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +6 -0
  221. package/src/modules/bmm/workflows/2-plan-workflows/prd/prd-template.md +7 -0
  222. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01-init.md +138 -56
  223. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-01b-continue.md +93 -51
  224. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-02-discovery.md +223 -78
  225. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-03-success.md +20 -2
  226. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-04-journeys.md +18 -0
  227. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-05-domain.md +21 -0
  228. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-06-innovation.md +21 -0
  229. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-07-project-type.md +21 -0
  230. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-08-scoping.md +18 -0
  231. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-09-functional.md +18 -0
  232. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-10-nonfunctional.md +18 -0
  233. package/src/modules/bmm/workflows/2-plan-workflows/prd/steps/step-11-complete.md +13 -0
  234. package/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md +2 -2
  235. package/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-03-starter.md +14 -14
  236. package/src/modules/bmm/workflows/3-solutioning/architecture/steps/step-04-decisions.md +7 -7
  237. package/src/modules/bmm/workflows/3-solutioning/architecture/workflow.md +2 -1
  238. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +258 -0
  239. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +232 -0
  240. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +271 -0
  241. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +144 -0
  242. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -0
  243. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +58 -0
  244. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-01-document-discovery.md +189 -0
  245. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-02-prd-analysis.md +177 -0
  246. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-03-epic-coverage-validation.md +178 -0
  247. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-04-ux-alignment.md +138 -0
  248. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-05-epic-quality-review.md +251 -0
  249. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/steps/step-06-final-assessment.md +132 -0
  250. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/templates/readiness-report-template.md +4 -0
  251. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/workflow.md +54 -0
  252. package/src/modules/{bmgd/workflows/4-production → bmm/workflows/4-implementation}/code-review/checklist.md +2 -1
  253. package/src/modules/bmm/workflows/4-implementation/code-review/instructions.xml +51 -3
  254. package/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml +1 -1
  255. package/src/modules/bmm/workflows/4-implementation/create-story/instructions.xml +32 -2
  256. package/src/modules/bmm/workflows/4-implementation/retrospective/instructions.md +3 -3
  257. package/src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md +19 -21
  258. package/src/modules/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +10 -10
  259. package/src/modules/bmm/workflows/4-implementation/sprint-status/instructions.md +174 -0
  260. package/src/modules/bmm/workflows/4-implementation/sprint-status/workflow.yaml +35 -0
  261. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/instructions.md +104 -7
  262. package/src/modules/bmm/workflows/bmad-quick-flow/quick-dev/workflow.yaml +4 -0
  263. package/src/modules/bmm/workflows/document-project/instructions.md +1 -1
  264. package/src/modules/bmm/workflows/document-project/workflows/deep-dive-instructions.md +2 -2
  265. package/src/modules/bmm/workflows/generate-project-context/workflow.md +1 -1
  266. package/src/modules/bmm/workflows/testarch/atdd/atdd-checklist-template.md +1 -1
  267. package/src/modules/bmm/workflows/testarch/ci/checklist.md +1 -1
  268. package/src/modules/bmm/workflows/testarch/ci/github-actions-template.yaml +36 -3
  269. package/src/modules/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +25 -4
  270. package/src/modules/bmm/workflows/testarch/ci/instructions.md +2 -2
  271. package/src/modules/bmm/workflows/testarch/test-review/instructions.md +1 -1
  272. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +1 -6
  273. package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +1 -6
  274. package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +1 -6
  275. package/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +1 -7
  276. package/src/modules/cis/_module-installer/installer.js +1 -1
  277. package/tools/cli/README.md +7 -7
  278. package/tools/cli/commands/build.js +9 -184
  279. package/tools/cli/commands/install.js +1 -6
  280. package/tools/cli/installers/lib/core/config-collector.js +80 -12
  281. package/tools/cli/installers/lib/core/custom-module-cache.js +239 -0
  282. package/tools/cli/installers/lib/core/detector.js +8 -4
  283. package/tools/cli/installers/lib/core/installer.js +933 -376
  284. package/tools/cli/installers/lib/core/manifest-generator.js +265 -41
  285. package/tools/cli/installers/lib/core/manifest.js +47 -0
  286. package/tools/cli/installers/lib/core/post-install-sidecar-replacement.js +79 -0
  287. package/tools/cli/installers/lib/custom/handler.js +396 -0
  288. package/tools/cli/installers/lib/ide/_base-ide.js +10 -0
  289. package/tools/cli/installers/lib/ide/auggie.js +19 -7
  290. package/tools/cli/installers/lib/ide/crush.js +19 -6
  291. package/tools/cli/installers/lib/ide/cursor.js +29 -13
  292. package/tools/cli/installers/lib/ide/gemini.js +49 -1
  293. package/tools/cli/installers/lib/ide/iflow.js +20 -1
  294. package/tools/cli/installers/lib/ide/kiro-cli.js +327 -0
  295. package/tools/cli/installers/lib/ide/opencode.js +3 -3
  296. package/tools/cli/installers/lib/ide/roo.js +120 -184
  297. package/tools/cli/installers/lib/ide/rovo-dev.js +1 -1
  298. package/tools/cli/installers/lib/ide/shared/agent-command-generator.js +8 -2
  299. package/tools/cli/installers/lib/ide/shared/bmad-artifacts.js +34 -19
  300. package/tools/cli/installers/lib/ide/shared/workflow-command-generator.js +18 -14
  301. package/tools/cli/installers/lib/ide/templates/agent-command-template.md +1 -1
  302. package/tools/cli/installers/lib/ide/templates/workflow-commander.md +5 -0
  303. package/tools/cli/installers/lib/modules/manager.js +535 -56
  304. package/tools/cli/lib/agent/compiler.js +57 -16
  305. package/tools/cli/lib/agent/installer.js +129 -28
  306. package/tools/cli/lib/cli-utils.js +21 -4
  307. package/tools/cli/lib/config.js +2 -1
  308. package/tools/cli/lib/ui.js +561 -12
  309. package/tools/cli/lib/yaml-xml-builder.js +0 -15
  310. package/tools/maintainer/review-pr-README.md +55 -0
  311. package/tools/maintainer/review-pr.md +242 -0
  312. package/tools/migrate-custom-module-paths.js +124 -0
  313. package/tools/schema/agent.js +149 -89
  314. package/tools/validate-svg-changes.sh +356 -0
  315. package/custom/src/agents/commit-poet/installation-guide.md +0 -36
  316. package/custom/src/agents/toolsmith/installation-guide.md +0 -36
  317. package/docs/custom-agent-installation.md +0 -183
  318. package/src/modules/bmb/docs/workflows/workflow-template.md +0 -152
  319. package/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-overview.md +0 -127
  320. package/src/modules/bmb/workflows/create-workflow/steps/step-04-core-tools.md +0 -145
  321. package/src/modules/bmb/workflows/create-workflow/steps/step-05-memory-requirements.md +0 -136
  322. package/src/modules/bmb/workflows/create-workflow/steps/step-06-external-tools.md +0 -154
  323. package/src/modules/bmb/workflows/create-workflow/steps/step-07-installation-guidance.md +0 -159
  324. package/src/modules/bmb/workflows/create-workflow/steps/step-08-tools-summary.md +0 -167
  325. package/src/modules/bmb/workflows/create-workflow/steps/step-10-plan-review.md +0 -215
  326. package/src/modules/bmb/workflows/create-workflow/templates/build-summary.md +0 -36
  327. package/src/modules/bmb/workflows/create-workflow/templates/completion-section.md +0 -39
  328. package/src/modules/bmb/workflows/create-workflow/templates/content-template.md +0 -21
  329. package/src/modules/bmb/workflows/create-workflow/templates/design-section.md +0 -53
  330. package/src/modules/bmb/workflows/create-workflow/templates/project-info.md +0 -18
  331. package/src/modules/bmb/workflows/create-workflow/templates/requirements-section.md +0 -47
  332. package/src/modules/bmb/workflows/create-workflow/templates/review-section.md +0 -56
  333. package/src/modules/bmb/workflows/create-workflow/templates/workflow-plan.md +0 -54
  334. package/src/modules/bmb/workflows-legacy/create-module/README.md +0 -229
  335. package/src/modules/bmb/workflows-legacy/create-module/brainstorm-context.md +0 -137
  336. package/src/modules/bmb/workflows-legacy/create-module/checklist.md +0 -235
  337. package/src/modules/bmb/workflows-legacy/create-module/installer-templates/install-config.yaml +0 -92
  338. package/src/modules/bmb/workflows-legacy/create-module/installer-templates/installer.js +0 -231
  339. package/src/modules/bmb/workflows-legacy/create-module/instructions.md +0 -577
  340. package/src/modules/bmb/workflows-legacy/create-module/module-structure.md +0 -400
  341. package/src/modules/bmb/workflows-legacy/create-module/workflow.yaml +0 -52
  342. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/epics-template.md +0 -80
  343. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/instructions.md +0 -387
  344. package/src/modules/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.yaml +0 -53
  345. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/checklist.md +0 -169
  346. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/instructions.md +0 -332
  347. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/template.md +0 -146
  348. package/src/modules/bmm/workflows/3-solutioning/implementation-readiness/workflow.yaml +0 -64
  349. package/tools/cli/commands/agent-install.js +0 -409
  350. package/tools/cli/commands/cleanup.js +0 -141
  351. /package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/knowledge/bundlers.md +0 -0
  352. /package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/knowledge/deploy.md +0 -0
  353. /package/{custom/src → example-custom-content}/agents/toolsmith/toolsmith-sidecar/knowledge/tests.md +0 -0
  354. /package/src/modules/bmgd/{_module-installer/install-config.yaml → module.yaml} +0 -0
  355. /package/src/modules/cis/{_module-installer/install-config.yaml → module.yaml} +0 -0
@@ -1,16 +1,53 @@
1
+ ---
2
+ name: 'step-02-discovery'
3
+ description: 'Conduct project and domain discovery with data-driven classification'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-02-discovery.md'
10
+ nextStepFile: '{workflow_path}/steps/step-03-success.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Data Files
15
+ projectTypesCSV: '{workflow_path}/project-types.csv'
16
+ domainComplexityCSV: '{workflow_path}/domain-complexity.csv'
17
+
18
+ # Task References
19
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
20
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
21
+ ---
22
+
1
23
  # Step 2: Project & Domain Discovery
2
24
 
3
- **Progress: Step 2 of 10** - Next: Success Criteria Definition
25
+ **Progress: Step 2 of 11** - Next: Success Criteria Definition
26
+
27
+ ## STEP GOAL:
28
+
29
+ Conduct comprehensive project discovery that leverages existing input documents while allowing user refinement, with data-driven classification, and generate the Executive Summary content.
4
30
 
5
31
  ## MANDATORY EXECUTION RULES (READ FIRST):
6
32
 
7
- - 🛑 NEVER generate content without user input
33
+ ### Universal Rules:
8
34
 
9
- - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
10
- - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
11
- - ALWAYS treat this as collaborative discovery between PM peers
35
+ - 🛑 NEVER generate content without user input
36
+ - 📖 CRITICAL: Read the complete step file before taking any action
37
+ - 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
12
38
  - 📋 YOU ARE A FACILITATOR, not a content generator
13
- - 💬 FOCUS on project classification and vision alignment only
39
+
40
+ ### Role Reinforcement:
41
+
42
+ - ✅ You are a product-focused PM facilitator collaborating with an expert peer
43
+ - ✅ We engage in collaborative dialogue, not command-response
44
+ - ✅ You bring structured thinking and facilitation skills, while the user brings domain expertise and product vision
45
+
46
+ ### Step-Specific Rules:
47
+
48
+ - 🎯 Focus on project classification and vision alignment only
49
+ - 🚫 FORBIDDEN to generate content without real user input
50
+ - 💬 APPROACH: Adapt questions based on document context (brownfield vs greenfield)
14
51
  - 🎯 LOAD classification data BEFORE starting discovery conversation
15
52
 
16
53
  ## EXECUTION PROTOCOLS:
@@ -31,8 +68,8 @@ This step will generate content and present choices:
31
68
 
32
69
  ## PROTOCOL INTEGRATION:
33
70
 
34
- - When 'A' selected: Execute {project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml
35
- - When 'P' selected: Execute {project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md
71
+ - When 'A' selected: Execute {advancedElicitationTask}
72
+ - When 'P' selected: Execute {partyModeWorkflow}
36
73
  - PROTOCOLS always return to this step's A/P/C menu
37
74
  - User accepts/rejects protocol changes before proceeding
38
75
 
@@ -40,40 +77,56 @@ This step will generate content and present choices:
40
77
 
41
78
  - Current document and frontmatter from step 1 are available
42
79
  - Input documents already loaded are in memory (product briefs, research, brainstorming, project docs)
80
+ - **Document counts available in frontmatter `documentCounts`**
43
81
  - Classification CSV data will be loaded in this step only
44
82
  - This will be the first content section appended to the document
45
- - LEVERAGE existing input documents to accelerate discovery process
46
- - installed_path = `{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd`
47
83
 
48
- ## YOUR TASK:
84
+ ## Sequence of Instructions (Do not deviate, skip, or optimize)
85
+
86
+ ### 1. Read Document State from Frontmatter
87
+
88
+ **CRITICAL FIRST ACTION:** Read the frontmatter from `{outputFile}` to get document counts.
89
+
90
+ ```
91
+ Read documentCounts from prd.md frontmatter:
92
+ - briefCount = documentCounts.briefs
93
+ - researchCount = documentCounts.research
94
+ - brainstormingCount = documentCounts.brainstorming
95
+ - projectDocsCount = documentCounts.projectDocs
96
+ ```
49
97
 
50
- Conduct comprehensive project discovery that leverages existing input documents while allowing user refinement, with data-driven classification and generate the first content section.
98
+ **ANNOUNCE your understanding:**
51
99
 
52
- ## DISCOVERY SEQUENCE:
100
+ "From step 1, I have loaded:
53
101
 
54
- ### 1. Load Classification Data
102
+ - Product briefs: {{briefCount}} files
103
+ - Research: {{researchCount}} files
104
+ - Brainstorming: {{brainstormingCount}} files
105
+ - Project docs: {{projectDocsCount}} files
106
+
107
+ {if projectDocsCount > 0}This is a **brownfield project** - I'll focus on understanding what you want to add or change.{else}This is a **greenfield project** - I'll help you define the full product vision.{/if}"
108
+
109
+ ### 2. Load Classification Data
55
110
 
56
111
  Load and prepare CSV data for intelligent classification:
57
112
 
58
- - Load `{installed_path}/project-types.csv` completely
59
- - Load `{installed_path/domain-complexity.csv` completely
113
+ - Load `{projectTypesCSV}` completely
114
+ - Load `{domainComplexityCSV}` completely
60
115
  - Parse column structures and store in memory for this step only
61
116
 
62
- ### 2. Leverage Input Documents for Head Start
117
+ ### 3. Begin Discovery Conversation
118
+
119
+ **SELECT EXACTLY ONE DISCOVERY PATH based on document state:**
63
120
 
64
- Analyze available input documents to provide informed discovery:
121
+ ---
65
122
 
66
- **Check Input Documents Available:**
123
+ #### PATH A: Has Product Brief (briefCount > 0)
67
124
 
68
- - Product Briefs: {{number_of_briefs}} documents loaded
69
- - Research Documents: {{number_of_research}} documents loaded
70
- - Brainstorming Results: {{number_of_brainstorming}} documents loaded
71
- - Project Documentation: {{number_of_project_docs}} documents loaded
125
+ **Use this path when:** `briefCount > 0`
72
126
 
73
- **If Input Documents Exist:**
74
- "As your PM peer, I've reviewed your existing project documentation and have a great starting point for our discovery. Let me share what I understand and you can refine or correct as needed.
127
+ "As your PM peer, I've reviewed your product brief and have a great starting point for our discovery. Let me share what I understand and you can refine or correct as needed.
75
128
 
76
- **Based on your product brief and research:**
129
+ **Based on your product brief:**
77
130
 
78
131
  **What you're building:**
79
132
  {{extracted_vision_from_brief}}
@@ -87,9 +140,47 @@ Analyze available input documents to provide informed discovery:
87
140
  **What makes it special:**
88
141
  {{extracted_differentiator_from_brief}}
89
142
 
143
+ {if projectDocsCount > 0}I also see you have existing project documentation. This PRD will define how new features integrate with your existing system architecture.{/if}
144
+
90
145
  **How does this align with your vision?** Should we refine any of these points or are there important aspects I'm missing?"
91
146
 
92
- **If No Input Documents:**
147
+ **AFTER this message, SKIP to Section 4.**
148
+
149
+ ---
150
+
151
+ #### PATH B: No Brief but Has Project Docs - Brownfield (briefCount == 0 AND projectDocsCount > 0)
152
+
153
+ **Use this path when:** `briefCount == 0 AND projectDocsCount > 0`
154
+
155
+ **NOTE:** Extract the following from loaded project documentation (index.md, architecture.md, project-overview.md, etc.):
156
+
157
+ "As your PM peer, I've reviewed your existing project documentation from document-project.
158
+
159
+ **Your existing system includes:**
160
+
161
+ - **Tech Stack:** {analyze index.md and architecture.md for technologies used}
162
+ - **Architecture:** {summarize architecture patterns from architecture.md}
163
+ - **Key Components:** {list main components from source-tree-analysis.md or project-overview.md}
164
+
165
+ This PRD will define **new features or changes** to add to this existing codebase.
166
+
167
+ **Tell me about what you want to add or change:**
168
+
169
+ - What new capability or feature do you want to build?
170
+ - What problem will this solve for your users?
171
+ - How should it integrate with the existing system?
172
+ - Is this adding new functionality, improving existing features, or fixing issues?
173
+
174
+ I'll help you create a PRD focused on these additions while respecting your existing patterns and architecture."
175
+
176
+ **AFTER this message, SKIP to Section 4.**
177
+
178
+ ---
179
+
180
+ #### PATH C: No Documents - Greenfield (briefCount == 0 AND projectDocsCount == 0)
181
+
182
+ **Use this path when:** `briefCount == 0 AND projectDocsCount == 0`
183
+
93
184
  "As your PM peer, I'm excited to help you shape {{project_name}}. Let me start by understanding what you want to build.
94
185
 
95
186
  **Tell me about what you want to create:**
@@ -100,9 +191,13 @@ Analyze available input documents to provide informed discovery:
100
191
 
101
192
  I'll be listening for signals to help us classify the project and domain so we can ask the right questions throughout our process."
102
193
 
103
- ### 3. Listen for Classification Signals
194
+ **AFTER this message, continue to Section 4.**
195
+
196
+ ---
197
+
198
+ ### 4. Listen for Classification Signals
104
199
 
105
- As the user describes their product, listen for and match against:
200
+ As the user describes their product/feature, listen for and match against:
106
201
 
107
202
  #### Project Type Signals
108
203
 
@@ -122,11 +217,14 @@ Compare user description against `signals` from `domain-complexity.csv`:
122
217
  - Examples: "payment,banking,trading" → fintech
123
218
  - Store the matched `domain` and `complexity_level`
124
219
 
125
- ### 4. Enhanced Classification with Document Context
220
+ ### 5. Present Classification for Validation
126
221
 
127
- Leverage both user input and document analysis for classification:
222
+ **SELECT EXACTLY ONE CLASSIFICATION PRESENTATION based on document state:**
223
+
224
+ ---
225
+
226
+ #### IF PATH A was used (briefCount > 0):
128
227
 
129
- **If Input Documents Exist:**
130
228
  "Based on your product brief and our discussion, I'm classifying this as:
131
229
 
132
230
  - **Project Type:** {project_type_from_brief_or_conversation}
@@ -136,10 +234,33 @@ Leverage both user input and document analysis for classification:
136
234
  From your brief, I detected these classification signals:
137
235
  {{classification_signals_from_brief}}
138
236
 
237
+ {if projectDocsCount > 0}Your existing project documentation also indicates:
238
+
239
+ - **Existing Tech Stack:** {from architecture.md or index.md}
240
+ - **Architecture Pattern:** {from architecture.md}
241
+
242
+ I'll ensure the new features align with your existing system.{/if}
243
+
139
244
  Combined with our conversation, this suggests the above classification. Does this sound right?"
140
245
 
141
- **If No Input Documents:**
142
- Present your classifications for user validation:
246
+ ---
247
+
248
+ #### IF PATH B was used (briefCount == 0 AND projectDocsCount > 0):
249
+
250
+ "Based on your existing project documentation and our discussion about new features:
251
+
252
+ - **Existing Project Type:** {detected from project docs - e.g., web_app, api_backend}
253
+ - **Tech Stack:** {from architecture.md or index.md}
254
+ - **New Feature Type:** {from user's description of what they want to add}
255
+ - **Domain:** {detected_domain}
256
+ - **Complexity:** {complexity_level}
257
+
258
+ I'll ensure the PRD aligns with your existing architecture patterns. Does this classification sound right?"
259
+
260
+ ---
261
+
262
+ #### IF PATH C was used (briefCount == 0 AND projectDocsCount == 0):
263
+
143
264
  "Based on our conversation, I'm hearing this as:
144
265
 
145
266
  - **Project Type:** {detected_project_type}
@@ -148,11 +269,16 @@ Present your classifications for user validation:
148
269
 
149
270
  Does this sound right to you? I want to make sure we're on the same page before diving deeper."
150
271
 
151
- ### 5. Identify What Makes It Special
272
+ ---
273
+
274
+ ### 6. Identify What Makes It Special
275
+
276
+ **SELECT EXACTLY ONE DIFFERENTIATOR DISCOVERY based on document state:**
152
277
 
153
- Leverage input documents for initial understanding, then refine:
278
+ ---
279
+
280
+ #### IF PATH A was used (briefCount > 0):
154
281
 
155
- **If Input Documents Exist:**
156
282
  "From your product brief, I understand that what makes this special is:
157
283
  {{extracted_differentiator_from_brief}}
158
284
 
@@ -162,7 +288,21 @@ Let's explore this deeper:
162
288
  - **Missing aspects:** Are there other differentiators that aren't captured in your brief?
163
289
  - **Evolution:** How has your thinking on this evolved since you wrote the brief?"
164
290
 
165
- **If No Input Documents:**
291
+ ---
292
+
293
+ #### IF PATH B was used (briefCount == 0 AND projectDocsCount > 0):
294
+
295
+ "Your existing system already provides certain capabilities. Now let's define what makes these **new additions** special:
296
+
297
+ - What gap in your current system will this fill?
298
+ - How will this improve the experience for your existing users?
299
+ - What's the key insight that led you to prioritize this addition?
300
+ - What would make users say 'finally, this is what we needed'?"
301
+
302
+ ---
303
+
304
+ #### IF PATH C was used (briefCount == 0 AND projectDocsCount == 0):
305
+
166
306
  Ask focused questions to capture the product's unique value:
167
307
 
168
308
  - "What would make users say 'this is exactly what I needed'?"
@@ -170,7 +310,9 @@ Ask focused questions to capture the product's unique value:
170
310
  - "What assumption about [problem space] are you challenging?"
171
311
  - "If this succeeds wildly, what changed for your users?"
172
312
 
173
- ### 6. Generate Executive Summary Content
313
+ ---
314
+
315
+ ### 7. Generate Executive Summary Content
174
316
 
175
317
  Based on the conversation, prepare the content to append to the document:
176
318
 
@@ -190,75 +332,84 @@ Based on the conversation, prepare the content to append to the document:
190
332
  **Technical Type:** {project_type}
191
333
  **Domain:** {domain}
192
334
  **Complexity:** {complexity_level}
335
+ {if projectDocsCount > 0}**Project Context:** Brownfield - extending existing system{else}**Project Context:** Greenfield - new project{/if}
193
336
 
194
337
  {project_classification_content}
195
338
  ```
196
339
 
197
- ### 7. Present Content and Menu
340
+ ### 8. Present Content and Menu
198
341
 
199
342
  Show the generated content to the user and present:
343
+
200
344
  "I've drafted our Executive Summary based on our conversation. This will be the first section of your PRD.
201
345
 
202
346
  **Here's what I'll add to the document:**
203
347
 
204
- [Show the complete markdown content from step 6]
348
+ [Show the complete markdown content from step 7]
205
349
 
206
- **What would you like to do?**
350
+ **Select an Option:**
207
351
  [A] Advanced Elicitation - Let's dive deeper and refine this content
208
352
  [P] Party Mode - Bring in different perspectives to improve this
209
- [C] Continue - Save this and move to Success Criteria Definition (Step 3 of 10)"
353
+ [C] Continue - Save this and move to Success Criteria Definition (Step 3 of 11)"
210
354
 
211
- ### 8. Handle Menu Selection
355
+ ### 9. Handle Menu Selection
212
356
 
213
- #### If 'A' (Advanced Elicitation):
357
+ #### IF A (Advanced Elicitation):
214
358
 
215
- - Execute {project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml with the current content
359
+ - Execute {advancedElicitationTask} with the current content
216
360
  - Process the enhanced content that comes back
217
361
  - Ask user: "Accept these changes to the Executive Summary? (y/n)"
218
362
  - If yes: Update the content with improvements, then return to A/P/C menu
219
363
  - If no: Keep original content, then return to A/P/C menu
220
364
 
221
- #### If 'P' (Party Mode):
365
+ #### IF P (Party Mode):
222
366
 
223
- - Execute {project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md with the current content
367
+ - Execute {partyModeWorkflow} with the current content
224
368
  - Process the collaborative improvements that come back
225
369
  - Ask user: "Accept these changes to the Executive Summary? (y/n)"
226
370
  - If yes: Update the content with improvements, then return to A/P/C menu
227
371
  - If no: Keep original content, then return to A/P/C menu
228
372
 
229
- #### If 'C' (Continue):
373
+ #### IF C (Continue):
230
374
 
231
- - Append the final content to `{output_folder}/prd.md`
375
+ - Append the final content to `{outputFile}`
232
376
  - Update frontmatter: `stepsCompleted: [1, 2]`
233
- - Load `./step-03-success.md`
377
+ - Load `{nextStepFile}`
378
+
379
+ ## CRITICAL STEP COMPLETION NOTE
234
380
 
235
- ## APPEND TO DOCUMENT:
381
+ ONLY WHEN [C continue option] is selected and [executive summary content finalized and saved to document with frontmatter updated], will you then load and read fully `{nextStepFile}` to execute and begin success criteria definition.
236
382
 
237
- When user selects 'C', append the content directly to the document using the structure from step 6.
383
+ ---
238
384
 
239
- ## SUCCESS METRICS:
385
+ ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
240
386
 
241
- Classification data loaded and used effectively
242
- ✅ Input documents analyzed and leveraged for head start
243
- ✅ User classifications validated and confirmed
244
- ✅ Product differentiator clearly identified and refined
245
- ✅ Executive summary content generated collaboratively with document context
246
- ✅ A/P/C menu presented and handled correctly
247
- ✅ Content properly appended to document when C selected
387
+ ### SUCCESS:
248
388
 
249
- ## FAILURE MODES:
389
+ - Document counts read from frontmatter and announced
390
+ - Classification data loaded and used effectively
391
+ - **Correct discovery path selected based on document counts**
392
+ - Input documents analyzed and leveraged for head start
393
+ - User classifications validated and confirmed
394
+ - Product differentiator clearly identified and refined
395
+ - Executive summary content generated collaboratively with document context
396
+ - A/P/C menu presented and handled correctly
397
+ - Content properly appended to document when C selected
398
+ - Frontmatter updated with stepsCompleted: [1, 2]
250
399
 
251
- Skipping classification data loading and guessing classifications
252
- ❌ Not leveraging existing input documents to accelerate discovery
253
- ❌ Not validating classifications with user before proceeding
254
- ❌ Generating executive summary without real user input
255
- ❌ Missing the "what makes it special" discovery and refinement
256
- ❌ Not presenting A/P/C menu after content generation
257
- ❌ Appending content without user selecting 'C'
400
+ ### SYSTEM FAILURE:
258
401
 
259
- **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
260
- **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
261
- **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
402
+ - **Not reading documentCounts from frontmatter first**
403
+ - **Executing multiple discovery paths instead of exactly one**
404
+ - Skipping classification data loading and guessing classifications
405
+ - Not leveraging existing input documents to accelerate discovery
406
+ - Not validating classifications with user before proceeding
407
+ - Generating executive summary without real user input
408
+ - Missing the "what makes it special" discovery and refinement
409
+ - Not presenting A/P/C menu after content generation
410
+ - Appending content without user selecting 'C'
411
+
412
+ **Master Rule:** Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.
262
413
 
263
414
  ## COMPLEXITY HANDLING:
264
415
 
@@ -267,9 +418,3 @@ If `complexity_level = "high"`:
267
418
  - Note the `suggested_workflow` and `web_searches` from domain CSV
268
419
  - Consider mentioning domain research needs in classification section
269
420
  - Document complexity implications in project classification
270
-
271
- ## NEXT STEP:
272
-
273
- After user selects 'C' and content is saved to document, load `installed_path/steps/step-03-success.md` to define success criteria.
274
-
275
- Remember: Do NOT proceed to step-03 until user explicitly selects 'C' from the A/P/C menu and content is saved!
@@ -1,6 +1,24 @@
1
+ ---
2
+ name: 'step-03-success'
3
+ description: 'Define comprehensive success criteria covering user, business, and technical success'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-03-success.md'
10
+ nextStepFile: '{workflow_path}/steps/step-04-journeys.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
1
19
  # Step 3: Success Criteria Definition
2
20
 
3
- **Progress: Step 3 of 10** - Next: User Journey Mapping
21
+ **Progress: Step 3 of 11** - Next: User Journey Mapping
4
22
 
5
23
  ## MANDATORY EXECUTION RULES (READ FIRST):
6
24
 
@@ -204,7 +222,7 @@ Show the generated content and present choices:
204
222
  **What would you like to do?**
205
223
  [A] Advanced Elicitation - Let's dive deeper and refine these success metrics
206
224
  [P] Party Mode - Bring in different perspectives on success criteria
207
- [C] Continue - Save success criteria and move to User Journey Mapping (Step 4 of 10)"
225
+ [C] Continue - Save success criteria and move to User Journey Mapping (Step 4 of 11)"
208
226
 
209
227
  ### 9. Handle Menu Selection
210
228
 
@@ -1,3 +1,21 @@
1
+ ---
2
+ name: 'step-04-journeys'
3
+ description: 'Map ALL user types that interact with the system with narrative story-based journeys'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-04-journeys.md'
10
+ nextStepFile: '{workflow_path}/steps/step-05-domain.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
1
19
  # Step 4: User Journey Mapping
2
20
 
3
21
  **Progress: Step 4 of 11** - Next: Domain Requirements
@@ -1,3 +1,24 @@
1
+ ---
2
+ name: 'step-05-domain'
3
+ description: 'Explore domain-specific requirements for complex domains (optional step)'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-05-domain.md'
10
+ nextStepFile: '{workflow_path}/steps/step-06-innovation.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Data Files
15
+ domainComplexityCSV: '{workflow_path}/domain-complexity.csv'
16
+
17
+ # Task References
18
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
19
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
20
+ ---
21
+
1
22
  # Step 5: Domain-Specific Exploration
2
23
 
3
24
  **Progress: Step 5 of 11** - Next: Innovation Focus
@@ -1,3 +1,24 @@
1
+ ---
2
+ name: 'step-06-innovation'
3
+ description: 'Detect and explore innovative aspects of the product (optional step)'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-06-innovation.md'
10
+ nextStepFile: '{workflow_path}/steps/step-07-project-type.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Data Files
15
+ projectTypesCSV: '{workflow_path}/project-types.csv'
16
+
17
+ # Task References
18
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
19
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
20
+ ---
21
+
1
22
  # Step 6: Innovation Discovery
2
23
 
3
24
  **Progress: Step 6 of 11** - Next: Project Type Analysis
@@ -1,3 +1,24 @@
1
+ ---
2
+ name: 'step-07-project-type'
3
+ description: 'Conduct project-type specific discovery using CSV-driven guidance'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-07-project-type.md'
10
+ nextStepFile: '{workflow_path}/steps/step-08-scoping.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Data Files
15
+ projectTypesCSV: '{workflow_path}/project-types.csv'
16
+
17
+ # Task References
18
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
19
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
20
+ ---
21
+
1
22
  # Step 7: Project-Type Deep Dive
2
23
 
3
24
  **Progress: Step 7 of 11** - Next: Scoping
@@ -1,3 +1,21 @@
1
+ ---
2
+ name: 'step-08-scoping'
3
+ description: 'Define MVP boundaries and prioritize features across development phases'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-08-scoping.md'
10
+ nextStepFile: '{workflow_path}/steps/step-09-functional.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
1
19
  # Step 8: Scoping Exercise - MVP & Future Features
2
20
 
3
21
  **Progress: Step 8 of 11** - Next: Functional Requirements
@@ -1,3 +1,21 @@
1
+ ---
2
+ name: 'step-09-functional'
3
+ description: 'Synthesize all discovery into comprehensive functional requirements'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-09-functional.md'
10
+ nextStepFile: '{workflow_path}/steps/step-10-nonfunctional.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
1
19
  # Step 9: Functional Requirements Synthesis
2
20
 
3
21
  **Progress: Step 9 of 11** - Next: Non-Functional Requirements
@@ -1,3 +1,21 @@
1
+ ---
2
+ name: 'step-10-nonfunctional'
3
+ description: 'Define quality attributes that matter for this specific product'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-10-nonfunctional.md'
10
+ nextStepFile: '{workflow_path}/steps/step-11-complete.md'
11
+ workflowFile: '{workflow_path}/workflow.md'
12
+ outputFile: '{output_folder}/prd.md'
13
+
14
+ # Task References
15
+ advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
16
+ partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
17
+ ---
18
+
1
19
  # Step 10: Non-Functional Requirements
2
20
 
3
21
  **Progress: Step 10 of 11** - Next: Complete PRD
@@ -1,3 +1,16 @@
1
+ ---
2
+ name: 'step-11-complete'
3
+ description: 'Complete the PRD workflow, update status files, and suggest next steps'
4
+
5
+ # Path Definitions
6
+ workflow_path: '{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd'
7
+
8
+ # File References
9
+ thisStepFile: '{workflow_path}/steps/step-11-complete.md'
10
+ workflowFile: '{workflow_path}/workflow.md'
11
+ outputFile: '{output_folder}/prd.md'
12
+ ---
13
+
1
14
  # Step 11: Workflow Completion
2
15
 
3
16
  **Final Step - Complete the PRD**