bmalph 1.0.0 → 2.2.1

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 (455) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +398 -217
  3. package/bmad/bmm/agents/analyst.agent.yaml +43 -36
  4. package/bmad/bmm/agents/architect.agent.yaml +29 -28
  5. package/bmad/bmm/agents/dev.agent.yaml +38 -38
  6. package/bmad/bmm/agents/pm.agent.yaml +44 -46
  7. package/bmad/bmm/agents/qa.agent.yaml +58 -0
  8. package/bmad/bmm/agents/quick-flow-solo-dev.agent.yaml +32 -32
  9. package/bmad/bmm/agents/sm.agent.yaml +37 -36
  10. package/bmad/bmm/agents/tech-writer/tech-writer-sidecar/documentation-standards.md +223 -223
  11. package/bmad/bmm/agents/tech-writer/tech-writer.agent.yaml +46 -45
  12. package/bmad/bmm/agents/ux-designer.agent.yaml +27 -26
  13. package/bmad/bmm/data/project-context-template.md +26 -26
  14. package/bmad/bmm/module-help.csv +31 -31
  15. package/bmad/bmm/module.yaml +50 -44
  16. package/bmad/bmm/teams/default-party.csv +20 -21
  17. package/bmad/bmm/teams/team-fullstack.yaml +12 -12
  18. package/bmad/bmm/workflows/1-analysis/create-product-brief/product-brief.template.md +10 -10
  19. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-01-init.md +177 -177
  20. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-01b-continue.md +161 -161
  21. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-02-vision.md +199 -199
  22. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-03-users.md +202 -202
  23. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-04-metrics.md +205 -205
  24. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-05-scope.md +219 -219
  25. package/bmad/bmm/workflows/1-analysis/create-product-brief/steps/step-06-complete.md +162 -162
  26. package/bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md +57 -58
  27. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +137 -137
  28. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +229 -229
  29. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-03-competitive-landscape.md +238 -238
  30. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-04-regulatory-focus.md +206 -206
  31. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-05-technical-trends.md +234 -234
  32. package/bmad/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md +443 -443
  33. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +182 -182
  34. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md +237 -237
  35. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md +249 -249
  36. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-04-customer-decisions.md +259 -259
  37. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-05-competitive-analysis.md +177 -177
  38. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-06-research-completion.md +475 -475
  39. package/bmad/bmm/workflows/1-analysis/research/research.template.md +29 -29
  40. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md +137 -137
  41. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +239 -239
  42. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-03-integration-patterns.md +248 -248
  43. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-04-architectural-patterns.md +202 -202
  44. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-05-implementation-research.md +233 -239
  45. package/bmad/bmm/workflows/1-analysis/research/technical-steps/step-06-research-synthesis.md +486 -486
  46. package/bmad/bmm/workflows/1-analysis/research/workflow-domain-research.md +54 -0
  47. package/bmad/bmm/workflows/1-analysis/research/workflow-market-research.md +54 -0
  48. package/bmad/bmm/workflows/1-analysis/research/workflow-technical-research.md +54 -0
  49. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/data/domain-complexity.csv +14 -12
  50. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/data/prd-purpose.md +197 -197
  51. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/data/project-types.csv +10 -10
  52. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-01-init.md +191 -191
  53. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-01b-continue.md +153 -153
  54. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-02-discovery.md +224 -224
  55. package/bmad/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02b-vision.md +154 -0
  56. package/bmad/bmm/workflows/2-plan-workflows/create-prd/steps-c/step-02c-executive-summary.md +170 -0
  57. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-03-success.md +226 -226
  58. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-04-journeys.md +213 -213
  59. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-05-domain.md +207 -207
  60. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-06-innovation.md +226 -226
  61. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-07-project-type.md +237 -237
  62. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-08-scoping.md +228 -228
  63. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-09-functional.md +231 -231
  64. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-10-nonfunctional.md +242 -242
  65. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-11-polish.md +217 -217
  66. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-c/step-12-complete.md +124 -124
  67. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-01-discovery.md +247 -247
  68. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-01b-legacy-conversion.md +208 -208
  69. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-02-review.md +249 -249
  70. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-03-edit.md +253 -253
  71. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-e/step-e-04-complete.md +168 -168
  72. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-01-discovery.md +226 -218
  73. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-02-format-detection.md +191 -191
  74. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-02b-parity-check.md +209 -209
  75. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-03-density-validation.md +174 -174
  76. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-04-brief-coverage-validation.md +214 -214
  77. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-05-measurability-validation.md +228 -228
  78. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-06-traceability-validation.md +217 -217
  79. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-07-implementation-leakage-validation.md +205 -205
  80. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-08-domain-compliance-validation.md +243 -243
  81. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-09-project-type-validation.md +263 -263
  82. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-10-smart-validation.md +209 -209
  83. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-11-holistic-quality-validation.md +264 -264
  84. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-12-completeness-validation.md +242 -242
  85. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/steps-v/step-v-13-report-complete.md +231 -231
  86. package/bmad/bmm/workflows/2-plan-workflows/{prd → create-prd}/templates/prd-template.md +10 -10
  87. package/bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md +63 -0
  88. package/bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-edit-prd.md +65 -0
  89. package/bmad/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md +63 -0
  90. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01-init.md +135 -135
  91. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-01b-continue.md +127 -127
  92. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-02-discovery.md +190 -190
  93. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-03-core-experience.md +216 -216
  94. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-04-emotional-response.md +219 -219
  95. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-05-inspiration.md +234 -234
  96. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-06-design-system.md +252 -252
  97. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-07-defining-experience.md +254 -254
  98. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-08-visual-foundation.md +224 -224
  99. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-09-design-directions.md +224 -224
  100. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-10-user-journeys.md +241 -241
  101. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-11-component-strategy.md +248 -248
  102. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-12-ux-patterns.md +237 -237
  103. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-13-responsive-accessibility.md +264 -264
  104. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/steps/step-14-complete.md +171 -171
  105. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/ux-design-template.md +13 -13
  106. package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md +42 -43
  107. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-01-document-discovery.md +184 -190
  108. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-02-prd-analysis.md +172 -178
  109. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-03-epic-coverage-validation.md +173 -179
  110. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-04-ux-alignment.md +133 -139
  111. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-05-epic-quality-review.md +245 -252
  112. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md +129 -135
  113. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/templates/readiness-report-template.md +4 -4
  114. package/bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md +54 -55
  115. package/bmad/bmm/workflows/3-solutioning/create-architecture/architecture-decision-template.md +12 -12
  116. package/bmad/bmm/workflows/3-solutioning/create-architecture/data/domain-complexity.csv +12 -10
  117. package/bmad/bmm/workflows/3-solutioning/create-architecture/data/project-types.csv +6 -6
  118. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-01-init.md +153 -153
  119. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-01b-continue.md +164 -164
  120. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-02-context.md +224 -224
  121. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-03-starter.md +331 -331
  122. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-04-decisions.md +318 -318
  123. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-05-patterns.md +359 -359
  124. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-06-structure.md +379 -379
  125. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-07-validation.md +359 -359
  126. package/bmad/bmm/workflows/3-solutioning/create-architecture/steps/step-08-complete.md +76 -76
  127. package/bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md +49 -50
  128. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-01-validate-prerequisites.md +259 -259
  129. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-02-design-epics.md +233 -233
  130. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-03-create-stories.md +272 -272
  131. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/steps/step-04-final-validation.md +149 -149
  132. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/templates/epics-template.md +57 -57
  133. package/bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md +58 -59
  134. package/bmad/bmm/workflows/4-implementation/code-review/checklist.md +23 -23
  135. package/bmad/bmm/workflows/4-implementation/code-review/instructions.xml +226 -226
  136. package/bmad/bmm/workflows/4-implementation/code-review/workflow.yaml +44 -51
  137. package/bmad/bmm/workflows/4-implementation/correct-course/checklist.md +288 -288
  138. package/bmad/bmm/workflows/4-implementation/correct-course/instructions.md +207 -206
  139. package/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml +54 -60
  140. package/bmad/bmm/workflows/4-implementation/create-story/checklist.md +358 -358
  141. package/bmad/bmm/workflows/4-implementation/create-story/instructions.xml +346 -345
  142. package/bmad/bmm/workflows/4-implementation/create-story/template.md +49 -49
  143. package/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml +53 -61
  144. package/bmad/bmm/workflows/4-implementation/dev-story/checklist.md +80 -80
  145. package/bmad/bmm/workflows/4-implementation/dev-story/instructions.xml +410 -410
  146. package/bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml +21 -27
  147. package/bmad/bmm/workflows/4-implementation/retrospective/instructions.md +1444 -1443
  148. package/bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml +53 -58
  149. package/bmad/bmm/workflows/4-implementation/sprint-planning/checklist.md +33 -33
  150. package/bmad/bmm/workflows/4-implementation/sprint-planning/instructions.md +226 -225
  151. package/bmad/bmm/workflows/4-implementation/sprint-planning/sprint-status-template.yaml +55 -55
  152. package/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml +47 -54
  153. package/bmad/bmm/workflows/4-implementation/sprint-status/instructions.md +230 -229
  154. package/bmad/bmm/workflows/4-implementation/sprint-status/workflow.yaml +25 -36
  155. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-01-mode-detection.md +174 -156
  156. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-02-context-gathering.md +118 -120
  157. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-03-execute.md +111 -113
  158. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-04-self-check.md +111 -113
  159. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-05-adversarial-review.md +104 -106
  160. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/steps/step-06-resolve-findings.md +146 -140
  161. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/workflow.md +50 -50
  162. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-01-understand.md +191 -189
  163. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-02-investigate.md +144 -144
  164. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-03-generate.md +127 -128
  165. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/steps/step-04-review.md +200 -191
  166. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/tech-spec-template.md +74 -74
  167. package/bmad/bmm/workflows/bmad-quick-flow/quick-spec/workflow.md +79 -79
  168. package/bmad/bmm/workflows/document-project/checklist.md +245 -245
  169. package/bmad/bmm/workflows/document-project/documentation-requirements.csv +12 -12
  170. package/bmad/bmm/workflows/document-project/instructions.md +130 -221
  171. package/bmad/bmm/workflows/document-project/templates/deep-dive-template.md +345 -345
  172. package/bmad/bmm/workflows/document-project/templates/index-template.md +169 -169
  173. package/bmad/bmm/workflows/document-project/templates/project-overview-template.md +103 -103
  174. package/bmad/bmm/workflows/document-project/templates/project-scan-report-schema.json +160 -160
  175. package/bmad/bmm/workflows/document-project/templates/source-tree-template.md +135 -135
  176. package/bmad/bmm/workflows/document-project/workflow.yaml +22 -30
  177. package/bmad/bmm/workflows/document-project/workflows/deep-dive-instructions.md +298 -298
  178. package/bmad/bmm/workflows/document-project/workflows/deep-dive.yaml +31 -31
  179. package/bmad/bmm/workflows/document-project/workflows/full-scan-instructions.md +1106 -1106
  180. package/bmad/bmm/workflows/document-project/workflows/full-scan.yaml +31 -31
  181. package/bmad/bmm/workflows/generate-project-context/project-context-template.md +21 -0
  182. package/bmad/bmm/workflows/generate-project-context/steps/step-01-discover.md +184 -0
  183. package/bmad/bmm/workflows/generate-project-context/steps/step-02-generate.md +318 -0
  184. package/bmad/bmm/workflows/generate-project-context/steps/step-03-complete.md +278 -0
  185. package/bmad/bmm/workflows/generate-project-context/workflow.md +49 -0
  186. package/bmad/bmm/workflows/qa/automate/checklist.md +33 -0
  187. package/bmad/bmm/workflows/qa/automate/instructions.md +110 -0
  188. package/bmad/bmm/workflows/qa/automate/workflow.yaml +44 -0
  189. package/bmad/core/agents/bmad-master.agent.yaml +30 -30
  190. package/bmad/core/module-help.csv +9 -11
  191. package/bmad/core/module.yaml +25 -25
  192. package/bmad/core/tasks/editorial-review-prose.xml +102 -91
  193. package/bmad/core/tasks/editorial-review-structure.xml +209 -198
  194. package/bmad/core/tasks/help.md +85 -0
  195. package/bmad/core/tasks/index-docs.xml +64 -64
  196. package/bmad/core/tasks/review-adversarial-general.xml +48 -48
  197. package/bmad/core/tasks/shard-doc.xml +107 -108
  198. package/bmad/core/tasks/workflow.xml +234 -234
  199. package/bmad/core/workflows/advanced-elicitation/methods.csv +51 -51
  200. package/bmad/core/workflows/advanced-elicitation/workflow.xml +116 -116
  201. package/bmad/core/workflows/brainstorming/brain-methods.csv +61 -61
  202. package/bmad/core/workflows/brainstorming/steps/step-01-session-setup.md +197 -197
  203. package/bmad/core/workflows/brainstorming/steps/step-01b-continue.md +122 -122
  204. package/bmad/core/workflows/brainstorming/steps/step-02a-user-selected.md +225 -225
  205. package/bmad/core/workflows/brainstorming/steps/step-02b-ai-recommended.md +237 -237
  206. package/bmad/core/workflows/brainstorming/steps/step-02c-random-selection.md +209 -209
  207. package/bmad/core/workflows/brainstorming/steps/step-02d-progressive-flow.md +264 -264
  208. package/bmad/core/workflows/brainstorming/steps/step-03-technique-execution.md +399 -399
  209. package/bmad/core/workflows/brainstorming/steps/step-04-idea-organization.md +303 -303
  210. package/bmad/core/workflows/brainstorming/template.md +15 -15
  211. package/bmad/core/workflows/brainstorming/workflow.md +58 -58
  212. package/bmad/core/workflows/party-mode/steps/step-01-agent-loading.md +138 -138
  213. package/bmad/core/workflows/party-mode/steps/step-02-discussion-orchestration.md +187 -187
  214. package/bmad/core/workflows/party-mode/steps/step-03-graceful-exit.md +168 -157
  215. package/bmad/core/workflows/party-mode/workflow.md +194 -194
  216. package/bundled-versions.json +3 -0
  217. package/dist/cli.js +61 -6
  218. package/dist/commands/check-updates.d.ts +5 -0
  219. package/dist/commands/check-updates.js +63 -0
  220. package/dist/commands/doctor.d.ts +39 -1
  221. package/dist/commands/doctor.js +348 -79
  222. package/dist/commands/init.d.ts +2 -0
  223. package/dist/commands/init.js +41 -15
  224. package/dist/commands/status.d.ts +7 -1
  225. package/dist/commands/status.js +111 -42
  226. package/dist/commands/upgrade.d.ts +7 -1
  227. package/dist/commands/upgrade.js +43 -12
  228. package/dist/installer.d.ts +19 -2
  229. package/dist/installer.js +305 -66
  230. package/dist/transition/artifacts.d.ts +2 -0
  231. package/dist/transition/artifacts.js +46 -0
  232. package/dist/transition/context.d.ts +19 -0
  233. package/dist/transition/context.js +261 -0
  234. package/dist/transition/fix-plan.d.ts +15 -0
  235. package/dist/transition/fix-plan.js +94 -0
  236. package/dist/transition/index.d.ts +9 -0
  237. package/dist/transition/index.js +16 -0
  238. package/dist/transition/orchestration.d.ts +2 -0
  239. package/dist/transition/orchestration.js +243 -0
  240. package/dist/transition/specs-changelog.d.ts +3 -0
  241. package/dist/transition/specs-changelog.js +75 -0
  242. package/dist/transition/specs-index.d.ts +22 -0
  243. package/dist/transition/specs-index.js +157 -0
  244. package/dist/transition/story-parsing.d.ts +7 -0
  245. package/dist/transition/story-parsing.js +124 -0
  246. package/dist/transition/tech-stack.d.ts +3 -0
  247. package/dist/transition/tech-stack.js +79 -0
  248. package/dist/transition/types.d.ts +60 -0
  249. package/dist/transition/types.js +1 -0
  250. package/dist/utils/config.d.ts +4 -0
  251. package/dist/utils/config.js +14 -4
  252. package/dist/utils/constants.d.ts +70 -0
  253. package/dist/utils/constants.js +97 -0
  254. package/dist/utils/dryrun.d.ts +7 -0
  255. package/dist/utils/dryrun.js +48 -0
  256. package/dist/utils/errors.d.ts +63 -0
  257. package/dist/utils/errors.js +86 -0
  258. package/dist/utils/file-system.d.ts +24 -0
  259. package/dist/utils/file-system.js +99 -0
  260. package/dist/utils/github.d.ts +83 -0
  261. package/dist/utils/github.js +230 -0
  262. package/dist/utils/json.js +3 -3
  263. package/dist/utils/logger.d.ts +6 -0
  264. package/dist/utils/logger.js +27 -0
  265. package/dist/utils/state.d.ts +4 -7
  266. package/dist/utils/state.js +147 -26
  267. package/dist/utils/validate.d.ts +40 -0
  268. package/dist/utils/validate.js +175 -1
  269. package/package.json +75 -59
  270. package/ralph/RALPH-REFERENCE.md +412 -0
  271. package/ralph/lib/circuit_breaker.sh +463 -330
  272. package/ralph/lib/date_utils.sh +104 -53
  273. package/ralph/lib/enable_core.sh +815 -0
  274. package/ralph/lib/response_analyzer.sh +884 -768
  275. package/ralph/lib/task_sources.sh +577 -0
  276. package/ralph/lib/timeout_utils.sh +145 -145
  277. package/ralph/lib/wizard_utils.sh +547 -0
  278. package/ralph/ralph_import.sh +636 -0
  279. package/ralph/ralph_loop.sh +1793 -1391
  280. package/ralph/ralph_monitor.sh +125 -0
  281. package/ralph/templates/AGENT.md +158 -158
  282. package/ralph/templates/PROMPT.md +285 -292
  283. package/ralph/templates/fix_plan.md +27 -27
  284. package/ralph/templates/ralphrc.template +102 -0
  285. package/ralph/templates/specs/.gitkeep +1 -1
  286. package/slash-commands/advanced-elicitation.md +1 -1
  287. package/slash-commands/adversarial-review.md +1 -1
  288. package/slash-commands/analyst.md +1 -1
  289. package/slash-commands/architect.md +1 -1
  290. package/slash-commands/bmad-help.md +1 -1
  291. package/slash-commands/bmalph-implement.md +152 -152
  292. package/slash-commands/brainstorm-project.md +1 -1
  293. package/slash-commands/brainstorming.md +1 -1
  294. package/slash-commands/correct-course.md +1 -1
  295. package/slash-commands/create-architecture.md +1 -1
  296. package/slash-commands/create-brief.md +1 -1
  297. package/slash-commands/create-epics-stories.md +1 -1
  298. package/slash-commands/create-prd.md +1 -1
  299. package/slash-commands/create-story.md +1 -1
  300. package/slash-commands/create-ux.md +1 -1
  301. package/slash-commands/dev.md +1 -1
  302. package/slash-commands/document-project.md +1 -1
  303. package/slash-commands/domain-research.md +1 -1
  304. package/slash-commands/editorial-prose.md +1 -1
  305. package/slash-commands/editorial-structure.md +1 -1
  306. package/slash-commands/execute-workflow.md +1 -1
  307. package/slash-commands/generate-project-context.md +1 -0
  308. package/slash-commands/implementation-readiness.md +1 -1
  309. package/slash-commands/index-docs.md +1 -1
  310. package/slash-commands/market-research.md +1 -1
  311. package/slash-commands/party-mode.md +1 -1
  312. package/slash-commands/pm.md +1 -1
  313. package/slash-commands/qa-automate.md +1 -0
  314. package/slash-commands/qa.md +1 -0
  315. package/slash-commands/quick-dev.md +1 -1
  316. package/slash-commands/quick-flow-solo-dev.md +1 -1
  317. package/slash-commands/retrospective.md +1 -1
  318. package/slash-commands/shard-doc.md +1 -1
  319. package/slash-commands/sm.md +1 -1
  320. package/slash-commands/sprint-planning.md +1 -1
  321. package/slash-commands/sprint-status.md +1 -1
  322. package/slash-commands/tech-spec.md +1 -1
  323. package/slash-commands/tech-writer.md +1 -0
  324. package/slash-commands/technical-research.md +1 -1
  325. package/slash-commands/ux-designer.md +1 -1
  326. package/slash-commands/validate-architecture.md +1 -1
  327. package/slash-commands/validate-brief.md +1 -1
  328. package/slash-commands/validate-epics-stories.md +1 -1
  329. package/slash-commands/validate-prd.md +1 -1
  330. package/slash-commands/validate-story.md +1 -1
  331. package/slash-commands/validate-ux.md +1 -1
  332. package/bmad/bmm/agents/tea.agent.yaml +0 -63
  333. package/bmad/bmm/sub-modules/claude-code/config.yaml +0 -4
  334. package/bmad/bmm/sub-modules/claude-code/injections.yaml +0 -242
  335. package/bmad/bmm/sub-modules/claude-code/readme.md +0 -87
  336. package/bmad/bmm/testarch/knowledge/adr-quality-readiness-checklist.md +0 -350
  337. package/bmad/bmm/testarch/knowledge/api-request.md +0 -442
  338. package/bmad/bmm/testarch/knowledge/api-testing-patterns.md +0 -843
  339. package/bmad/bmm/testarch/knowledge/auth-session.md +0 -552
  340. package/bmad/bmm/testarch/knowledge/burn-in.md +0 -273
  341. package/bmad/bmm/testarch/knowledge/ci-burn-in.md +0 -675
  342. package/bmad/bmm/testarch/knowledge/component-tdd.md +0 -486
  343. package/bmad/bmm/testarch/knowledge/contract-testing.md +0 -957
  344. package/bmad/bmm/testarch/knowledge/data-factories.md +0 -500
  345. package/bmad/bmm/testarch/knowledge/email-auth.md +0 -721
  346. package/bmad/bmm/testarch/knowledge/error-handling.md +0 -725
  347. package/bmad/bmm/testarch/knowledge/feature-flags.md +0 -750
  348. package/bmad/bmm/testarch/knowledge/file-utils.md +0 -463
  349. package/bmad/bmm/testarch/knowledge/fixture-architecture.md +0 -401
  350. package/bmad/bmm/testarch/knowledge/fixtures-composition.md +0 -382
  351. package/bmad/bmm/testarch/knowledge/intercept-network-call.md +0 -430
  352. package/bmad/bmm/testarch/knowledge/log.md +0 -429
  353. package/bmad/bmm/testarch/knowledge/network-error-monitor.md +0 -405
  354. package/bmad/bmm/testarch/knowledge/network-first.md +0 -486
  355. package/bmad/bmm/testarch/knowledge/network-recorder.md +0 -527
  356. package/bmad/bmm/testarch/knowledge/nfr-criteria.md +0 -670
  357. package/bmad/bmm/testarch/knowledge/overview.md +0 -286
  358. package/bmad/bmm/testarch/knowledge/playwright-config.md +0 -730
  359. package/bmad/bmm/testarch/knowledge/probability-impact.md +0 -601
  360. package/bmad/bmm/testarch/knowledge/recurse.md +0 -421
  361. package/bmad/bmm/testarch/knowledge/risk-governance.md +0 -615
  362. package/bmad/bmm/testarch/knowledge/selective-testing.md +0 -732
  363. package/bmad/bmm/testarch/knowledge/selector-resilience.md +0 -527
  364. package/bmad/bmm/testarch/knowledge/test-healing-patterns.md +0 -644
  365. package/bmad/bmm/testarch/knowledge/test-levels-framework.md +0 -473
  366. package/bmad/bmm/testarch/knowledge/test-priorities-matrix.md +0 -373
  367. package/bmad/bmm/testarch/knowledge/test-quality.md +0 -664
  368. package/bmad/bmm/testarch/knowledge/timing-debugging.md +0 -372
  369. package/bmad/bmm/testarch/knowledge/visual-debugging.md +0 -524
  370. package/bmad/bmm/testarch/tea-index.csv +0 -35
  371. package/bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +0 -200
  372. package/bmad/bmm/workflows/1-analysis/research/workflow.md +0 -173
  373. package/bmad/bmm/workflows/2-plan-workflows/prd/validation-report-prd-workflow.md +0 -433
  374. package/bmad/bmm/workflows/2-plan-workflows/prd/workflow.md +0 -150
  375. package/bmad/bmm/workflows/bmad-quick-flow/quick-dev/data/project-levels.yaml +0 -59
  376. package/bmad/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-library.json +0 -90
  377. package/bmad/bmm/workflows/excalidraw-diagrams/_shared/excalidraw-templates.yaml +0 -127
  378. package/bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/checklist.md +0 -39
  379. package/bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/instructions.md +0 -130
  380. package/bmad/bmm/workflows/excalidraw-diagrams/create-dataflow/workflow.yaml +0 -27
  381. package/bmad/bmm/workflows/excalidraw-diagrams/create-diagram/checklist.md +0 -43
  382. package/bmad/bmm/workflows/excalidraw-diagrams/create-diagram/instructions.md +0 -141
  383. package/bmad/bmm/workflows/excalidraw-diagrams/create-diagram/workflow.yaml +0 -27
  384. package/bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/checklist.md +0 -49
  385. package/bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/instructions.md +0 -241
  386. package/bmad/bmm/workflows/excalidraw-diagrams/create-flowchart/workflow.yaml +0 -27
  387. package/bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/checklist.md +0 -38
  388. package/bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/instructions.md +0 -133
  389. package/bmad/bmm/workflows/excalidraw-diagrams/create-wireframe/workflow.yaml +0 -27
  390. package/bmad/bmm/workflows/testarch/atdd/atdd-checklist-template.md +0 -363
  391. package/bmad/bmm/workflows/testarch/atdd/checklist.md +0 -374
  392. package/bmad/bmm/workflows/testarch/atdd/instructions.md +0 -806
  393. package/bmad/bmm/workflows/testarch/atdd/workflow.yaml +0 -47
  394. package/bmad/bmm/workflows/testarch/automate/checklist.md +0 -582
  395. package/bmad/bmm/workflows/testarch/automate/instructions.md +0 -1324
  396. package/bmad/bmm/workflows/testarch/automate/workflow.yaml +0 -54
  397. package/bmad/bmm/workflows/testarch/ci/checklist.md +0 -247
  398. package/bmad/bmm/workflows/testarch/ci/github-actions-template.yaml +0 -198
  399. package/bmad/bmm/workflows/testarch/ci/gitlab-ci-template.yaml +0 -149
  400. package/bmad/bmm/workflows/testarch/ci/instructions.md +0 -536
  401. package/bmad/bmm/workflows/testarch/ci/workflow.yaml +0 -47
  402. package/bmad/bmm/workflows/testarch/framework/checklist.md +0 -320
  403. package/bmad/bmm/workflows/testarch/framework/instructions.md +0 -481
  404. package/bmad/bmm/workflows/testarch/framework/workflow.yaml +0 -49
  405. package/bmad/bmm/workflows/testarch/nfr-assess/checklist.md +0 -407
  406. package/bmad/bmm/workflows/testarch/nfr-assess/instructions.md +0 -726
  407. package/bmad/bmm/workflows/testarch/nfr-assess/nfr-report-template.md +0 -461
  408. package/bmad/bmm/workflows/testarch/nfr-assess/workflow.yaml +0 -49
  409. package/bmad/bmm/workflows/testarch/test-design/checklist.md +0 -407
  410. package/bmad/bmm/workflows/testarch/test-design/instructions.md +0 -1158
  411. package/bmad/bmm/workflows/testarch/test-design/test-design-architecture-template.md +0 -213
  412. package/bmad/bmm/workflows/testarch/test-design/test-design-qa-template.md +0 -286
  413. package/bmad/bmm/workflows/testarch/test-design/test-design-template.md +0 -294
  414. package/bmad/bmm/workflows/testarch/test-design/workflow.yaml +0 -71
  415. package/bmad/bmm/workflows/testarch/test-review/checklist.md +0 -472
  416. package/bmad/bmm/workflows/testarch/test-review/instructions.md +0 -628
  417. package/bmad/bmm/workflows/testarch/test-review/test-review-template.md +0 -390
  418. package/bmad/bmm/workflows/testarch/test-review/workflow.yaml +0 -48
  419. package/bmad/bmm/workflows/testarch/trace/checklist.md +0 -642
  420. package/bmad/bmm/workflows/testarch/trace/instructions.md +0 -1030
  421. package/bmad/bmm/workflows/testarch/trace/trace-template.md +0 -675
  422. package/bmad/bmm/workflows/testarch/trace/workflow.yaml +0 -57
  423. package/bmad/core/resources/excalidraw/README.md +0 -160
  424. package/bmad/core/resources/excalidraw/excalidraw-helpers.md +0 -127
  425. package/bmad/core/resources/excalidraw/library-loader.md +0 -50
  426. package/bmad/core/resources/excalidraw/validate-json-instructions.md +0 -79
  427. package/bmad/core/tasks/bmad-help.md +0 -62
  428. package/dist/commands/guide.d.ts +0 -1
  429. package/dist/commands/guide.js +0 -19
  430. package/dist/commands/implement.d.ts +0 -1
  431. package/dist/commands/implement.js +0 -83
  432. package/dist/commands/plan.d.ts +0 -5
  433. package/dist/commands/plan.js +0 -44
  434. package/dist/commands/reset.d.ts +0 -5
  435. package/dist/commands/reset.js +0 -35
  436. package/dist/commands/resume.d.ts +0 -1
  437. package/dist/commands/resume.js +0 -44
  438. package/dist/commands/start.d.ts +0 -5
  439. package/dist/commands/start.js +0 -54
  440. package/dist/transition.d.ts +0 -52
  441. package/dist/transition.js +0 -656
  442. package/slash-commands/atdd.md +0 -1
  443. package/slash-commands/continuous-integration.md +0 -1
  444. package/slash-commands/create-dataflow.md +0 -1
  445. package/slash-commands/create-diagram.md +0 -1
  446. package/slash-commands/create-flowchart.md +0 -1
  447. package/slash-commands/create-wireframe.md +0 -1
  448. package/slash-commands/nfr-assess.md +0 -1
  449. package/slash-commands/tea.md +0 -1
  450. package/slash-commands/test-automate.md +0 -1
  451. package/slash-commands/test-design.md +0 -1
  452. package/slash-commands/test-framework.md +0 -1
  453. package/slash-commands/test-review.md +0 -1
  454. package/slash-commands/test-trace.md +0 -1
  455. package/slash-commands/validate-test-design.md +0 -1
@@ -1,433 +0,0 @@
1
- ---
2
- validationTarget: 'PRD Workflow Structure'
3
- validationDate: '2026-01-08'
4
- inputDocuments: []
5
- validationStepsCompleted: ['discovery', 'frontmatter-validation', 'content-validation', 'documentation-validation', 'integration-validation', 'corrections-applied']
6
- validationStatus: COMPLETE - PRODUCTION READY
7
- ---
8
-
9
- # PRD Workflow Validation Report
10
-
11
- **Workflow Being Validated:** /Users/brianmadison/dev/BMAD-METHOD/src/bmm/workflows/2-plan-workflows/prd
12
- **Validation Date:** 2026-01-08
13
- **Validator:** BMAD Workflow Validation System
14
-
15
- ---
16
-
17
- ## Executive Summary
18
-
19
- This validation report assesses the PRD workflow structure against BMAD workflow standards. The PRD workflow is a tri-modal workflow system with Create, Validate, and Edit phases.
20
-
21
- ---
22
-
23
- ## 1. File Structure & Size Analysis
24
-
25
- ### Folder Structure
26
-
27
- ```
28
- prd/
29
- ├── workflow.md (main workflow file)
30
- ├── steps-c/ (Create steps - 12 files)
31
- ├── steps-v/ (Validation steps - 13 files)
32
- ├── steps-e/ (Edit steps - 5 files)
33
- ├── data/
34
- │ └── prd-purpose.md
35
- └── templates/
36
- └── prd-template.md
37
- ```
38
-
39
- **✅ Structure Status**: PASS - All required folders present
40
-
41
- ### File Size Analysis
42
-
43
- #### Steps-C (Create Steps) - 12 files
44
- | File | Lines | Status |
45
- |------|-------|--------|
46
- | step-01-init.md | 191 | ⚠️ Approaching limit |
47
- | step-01b-continue.md | 153 | ✅ Good |
48
- | step-02-discovery.md | 197 | ⚠️ Approaching limit |
49
- | step-03-success.md | 226 | ⚠️ Approaching limit |
50
- | step-04-journeys.md | 213 | ⚠️ Approaching limit |
51
- | step-05-domain.md | 193 | ⚠️ Approaching limit |
52
- | step-06-innovation.md | 226 | ⚠️ Approaching limit |
53
- | step-07-project-type.md | 225 | ⚠️ Approaching limit |
54
- | step-08-scoping.md | 228 | ⚠️ Approaching limit |
55
- | step-09-functional.md | 231 | ⚠️ Approaching limit |
56
- | step-10-nonfunctional.md | 242 | ⚠️ Approaching limit |
57
- | step-11-polish.md | 217 | ⚠️ Approaching limit |
58
- | step-12-complete.md | 185 | ✅ Good |
59
-
60
- #### Steps-V (Validation Steps) - 13 files
61
- | File | Lines | Status |
62
- |------|-------|--------|
63
- | step-v-01-discovery.md | 217 | ⚠️ Approaching limit |
64
- | step-v-02-format-detection.md | 191 | ⚠️ Approaching limit |
65
- | step-v-02b-parity-check.md | 209 | ⚠️ Approaching limit |
66
- | step-v-03-density-validation.md | 174 | ✅ Good |
67
- | step-v-04-brief-coverage-validation.md | 214 | ⚠️ Approaching limit |
68
- | step-v-05-measurability-validation.md | 228 | ⚠️ Approaching limit |
69
- | step-v-06-traceability-validation.md | 217 | ⚠️ Approaching limit |
70
- | step-v-07-implementation-leakage-validation.md | 205 | ⚠️ Approaching limit |
71
- | step-v-08-domain-compliance-validation.md | 243 | ⚠️ Approaching limit |
72
- | step-v-09-project-type-validation.md | 263 | ❌ Exceeds limit |
73
- | step-v-10-smart-validation.md | 209 | ⚠️ Approaching limit |
74
- | step-v-11-holistic-quality-validation.md | 264 | ❌ Exceeds limit |
75
- | step-v-12-completeness-validation.md | 242 | ⚠️ Approaching limit |
76
- | step-v-13-report-complete.md | 231 | ⚠️ Approaching limit |
77
-
78
- #### Steps-E (Edit Steps) - 5 files
79
- | File | Lines | Status |
80
- |------|-------|--------|
81
- | step-e-01-discovery.md | 206 | ⚠️ Approaching limit |
82
- | step-e-01b-legacy-conversion.md | 208 | ⚠️ Approaching limit |
83
- | step-e-02-review.md | 249 | ⚠️ Approaching limit |
84
- | step-e-03-edit.md | 253 | ❌ Exceeds limit |
85
- | step-e-04-complete.md | 168 | ✅ Good |
86
-
87
- #### Data & Templates
88
- | File | Lines | Status |
89
- |------|-------|--------|
90
- | data/prd-purpose.md | 197 | ⚠️ Approaching limit |
91
- | templates/prd-template.md | 10 | ✅ Good |
92
- | workflow.md | 114 | ✅ Good |
93
-
94
- ### File Size Statistics
95
-
96
- - **Total Files**: 32 markdown files
97
- - **✅ Good (<200 lines)**: 6 files (18.8%)
98
- - **⚠️ Approaching limit (200-250)**: 23 files (71.9%)
99
- - **❌ Exceeds limit (>250)**: 3 files (9.4%)
100
- - **Average lines per file**: 213.3 lines
101
-
102
- ### ⚠️ Recommendations
103
-
104
- 1. **Files Exceeding 250-line limit**:
105
- - `step-v-09-project-type-validation.md` (263 lines) - Consider splitting into sub-steps
106
- - `step-v-11-holistic-quality-validation.md` (264 lines) - Consider splitting into sub-steps
107
- - `step-e-03-edit.md` (253 lines) - Consider splitting into sub-steps
108
-
109
- 2. **Files Approaching Limit**:
110
- - Many files are in the 200-250 line range
111
- - Monitor these files as further additions may push them over the limit
112
- - Consider proactive refactoring where appropriate
113
-
114
- ---
115
-
116
- ## 2. Frontmatter Structure Validation
117
-
118
- ### Files Checked: 29 total files
119
-
120
- **✅ Overall Status:** ALL VALID - One Issue Fixed
121
-
122
- #### Main Workflow (workflow.md)
123
- **Required Fields Present:**
124
- - ✅ `name`: "prd"
125
- - ✅ `description`: "PRD tri-modal workflow"
126
- - ✅ `nextStep`: "./steps-c/step-01-init.md"
127
- - ✅ `validateWorkflow`: "./steps-v/step-v-01-discovery.md"
128
- - ✅ `editWorkflow`: "./steps-e/step-e-01-discovery.md" (FIXED - was assess-workflow.md)
129
-
130
- #### Create Steps (steps-c)
131
- - ✅ All 13 files have proper name, description, nextStepFile
132
- - ✅ Proper sequencing from step-01 through step-12
133
- - ✅ Consistent output file references
134
-
135
- #### Validation Steps (steps-v)
136
- - ✅ All 13 files have complete frontmatter
137
- - ✅ Proper sequential chain maintained
138
- - ✅ No broken internal references
139
-
140
- #### Edit Steps (steps-e)
141
- - ✅ All files have required fields
142
- - ✅ Proper routing with altStepFile references
143
-
144
- ### ✅ All Issues Resolved
145
-
146
- **1. Broken Edit Workflow Reference:**
147
- ```yaml
148
- # Current (INCORRECT):
149
- editWorkflow: './steps-e/step-e-01-assess-workflow.md'
150
-
151
- # Should be:
152
- editWorkflow: './steps-e/step-e-01-discovery.md'
153
- ```
154
-
155
- **2. Step Numbering Gap:**
156
- - Original `step-11-complete.md` was deleted
157
- - Sequence now: step-10 → step-11-polish → step-12-complete
158
- - Creates confusion in step numbering
159
-
160
- ### ✅ YAML Syntax
161
- - No YAML syntax errors detected
162
- - All frontmatter properly formatted
163
- - Consistent structure across files
164
-
165
- ### Status
166
- ✅ **ALL ISSUES RESOLVED** - Only cosmetic improvements remain:
167
-
168
- 1. **✅ FIXED**: Edit workflow path corrected in workflow.md
169
- 2. **⚠️ OPTIONAL**: Address step numbering gap for clarity
170
- 3. **⚠️ OPTIONAL**: Rename step-01b-continue.md to step-01a-continue.md for consistency
171
-
172
- ---
173
-
174
- ## 3. Step File Content Validation
175
-
176
- ### Content Quality Assessment: 4.5/5 - EXCELLENT
177
-
178
- #### Files Reviewed: 10 representative files across all modes
179
-
180
- #### ✅ Strengths
181
-
182
- **1. Comprehensive Structure:**
183
- - Clear step goal sections in all files
184
- - Detailed mandatory execution rules
185
- - Well-defined execution protocols
186
- - Context boundaries clearly specified
187
- - Mandatory sequence with numbered steps
188
- - System success/failure metrics present
189
-
190
- **2. BMAD Compliance:**
191
- - ✅ JIT loading references consistently mentioned
192
- - ✅ State tracking requirements documented
193
- - ✅ Append-only building instructions present
194
- - ✅ Critical rules properly emphasized with emojis
195
- - ✅ Sequential enforcement clearly stated
196
-
197
- **3. Instructional Quality:**
198
- - Clear, unambiguous instructions
199
- - Proper menu handling rules (where applicable)
200
- - Excellent continuation checks
201
- - Strong role definition for each mode
202
-
203
- **4. Role Clarity:**
204
- - Create Mode: "Product-focused PM facilitator"
205
- - Validate Mode: "Validation Architect and Quality Assurance Specialist"
206
- - Edit Mode: "PRD improvement specialist"
207
-
208
- #### ⚠️ Minor Improvement Opportunities
209
-
210
- **1. Header Formatting:**
211
- - Some inconsistency in header level usage across files
212
- - Recommend standardizing H2/H3 usage
213
-
214
- **2. Edit Mode Completeness:**
215
- - Edit mode has fewer steps (5 vs 12/13 for other modes)
216
- - Documentation marks it as "Future" but implementation exists
217
-
218
- #### Recommendations
219
- 1. **LOW PRIORITY**: Standardize header formatting across all step files
220
- 2. **LOW PRIORITY**: Complete remaining edit mode steps for parity
221
- 3. **MAINTAIN**: Current excellent quality standards
222
-
223
- ---
224
-
225
- ## 4. Documentation Validation
226
-
227
- ### Documentation Completeness: ✅ COMPREHENSIVE
228
-
229
- #### Main Components Present
230
- - ✅ Workflow Definition (workflow.md)
231
- - ✅ Purpose Document (data/prd-purpose.md)
232
- - ✅ Template (templates/prd-template.md)
233
- - ✅ Three Mode Implementations (Create: 12, Validate: 13, Edit: 5 steps)
234
-
235
- #### Clarity Assessment: ✅ EXCELLENT
236
-
237
- **Strong Points:**
238
- 1. Clear mode determination (commands, flags, menu selection)
239
- 2. Detailed routing instructions for each mode
240
- 3. Comprehensive workflow architecture explanation
241
- 4. Well-defined critical rules with visual emphasis
242
- 5. Professional presentation with consistent formatting
243
-
244
- #### ⚠️ Minor Issues Found
245
-
246
- **1. Step Count Mismatch:**
247
- - workflow.md mentions "11 steps" for Create mode
248
- - Actually implements 12 steps
249
- - Could confuse users
250
-
251
- **2. Edit Mode Status:**
252
- - workflow.md calls Edit mode "Future"
253
- - Edit mode steps are actually implemented
254
- - Should reflect current status
255
-
256
- **3. Template Completeness:**
257
- - PRD template is minimal (10 lines)
258
- - Could benefit from section placeholders
259
-
260
- **4. Missing README:**
261
- - No onboarding documentation for new users
262
- - Not critical but would be helpful
263
-
264
- #### Recommendations
265
-
266
- **HIGH PRIORITY:**
267
- 1. Fix step count reference to match implementation (12 steps)
268
- 2. Update edit mode documentation to "Implemented"
269
-
270
- **MEDIUM PRIORITY:**
271
- 3. Enhance PRD template with section structure
272
- 4. Add quick-start README for new users
273
-
274
- **LOW PRIORITY:**
275
- 5. Add troubleshooting section
276
- 6. Document external dependencies (domain-complexity.csv, project-types.csv)
277
-
278
- ---
279
-
280
- ## 5. Integration & Compatibility Validation
281
-
282
- ### Integration Status: 85% Ready
283
-
284
- #### ✅ Successfully Integrated Components
285
-
286
- **1. Agent Menu Registration:**
287
- - ✅ Registered in PM agent menu
288
- - ✅ Trigger: `PR` or fuzzy match on `prd`
289
- - ✅ Command: `/bmad:bmm:workflows:create-prd`
290
- - ✅ Proper workflow path configuration
291
-
292
- **2. External Workflow References:**
293
- - ✅ Party-mode workflow: Exists at `/src/core/workflows/party-mode/workflow.md`
294
- - ✅ Advanced-elicitation task: Exists at `/src/core/workflows/advanced-elicitation/workflow.xml`
295
-
296
- **3. Directory Structure:**
297
- - ✅ Complete step architecture (all 3 modes)
298
- - ✅ All referenced step files exist
299
- - ✅ Data files available
300
-
301
- #### ✅ Configuration & Installation - WORKING AS DESIGNED
302
-
303
- **1. BMM Config Reference:**
304
- - Path: `{project-root}/_bmad/bmm/config.yaml`
305
- - **Status:** ✅ Correct installation-time placeholder
306
- - Resolves to actual config during workflow installation
307
- - **Note:** This is expected behavior, not an issue
308
-
309
- **2. Planning Artifacts Folder:**
310
- - Reference: `{planning_artifacts}/prd.md`
311
- - **Status:** ✅ Correct installation-time placeholder
312
- - Created/resolved during workflow installation
313
- - **Note:** This is expected behavior, not an issue
314
-
315
- **3. Edit Mode Implementation:**
316
- - Current: 5 steps (Discovery, Legacy Conversion branch, Review, Edit, Complete)
317
- - **Status:** ✅ Functionally complete
318
- - Edit mode is inherently simpler than create mode (targeted improvements vs full creation)
319
- - Uses subprocesses for complex operations
320
- - Validation integration ensures quality
321
- - **Note:** Edit workflow is complete and well-designed
322
-
323
- #### Configuration Analysis
324
-
325
- **Placeholder Usage:**
326
- - `{project-root}`: ✅ Properly used
327
- - `{planning_artifacts}`: ⚠️ Referenced but folder missing
328
- - `{nextStep}`, `{validateWorkflow}`, etc: ✅ Properly resolved
329
-
330
- #### Recommendations
331
-
332
- **✅ ALL CRITICAL ISSUES RESOLVED:**
333
-
334
- The only true critical issue (edit workflow path) has been fixed. All other items flagged as "critical" were actually working as designed (installation-time placeholders).
335
-
336
- **LOW PRIORITY:**
337
- 3. Add CLI command registration for standalone execution (optional enhancement)
338
- 4. Consider adding workflow to additional agent menus (UX designer, architect)
339
- 5. Create standalone execution documentation (nice-to-have)
340
- 6. Address step numbering gap if desired (cosmetic)
341
-
342
- ---
343
-
344
- ## 6. Executive Summary & Overall Assessment
345
-
346
- ### Overall Validation Status: ✅ PRODUCTION-READY
347
-
348
- #### Validation Scores by Category
349
-
350
- | Category | Status | Score | Notes |
351
- |----------|--------|-------|-------|
352
- | **File Structure & Size** | ⚠️ WARNINGS | 7/10 | 3 files exceed 250-line limit, 23 approaching |
353
- | **Frontmatter Validation** | ✅ PASS | 9/10 | One broken path reference |
354
- | **Step Content Quality** | ✅ EXCELLENT | 9.5/10 | High-quality instructional design |
355
- | **Documentation** | ✅ EXCELLENT | 9/10 | Comprehensive, minor inconsistencies |
356
- | **Integration** | ✅ PASS | 9/10 | All paths correct (one issue fixed) |
357
- | **BMAD Compliance** | ✅ EXCELLENT | 9.5/10 | Strong adherence to standards |
358
-
359
- **Overall Score: 9.2/10 - EXCELLENT**
360
-
361
- #### ✅ Critical Action Items - ALL RESOLVED
362
-
363
- **ONLY ONE TRUE CRITICAL ISSUE EXISTED - NOW FIXED:**
364
-
365
- 1. **✅ FIXED: Edit Workflow Path**
366
- - File: `workflow.md` ✓ RESOLVED
367
- - Changed from: `./steps-e/step-e-01-assess-workflow.md`
368
- - Changed to: `./steps-e/step-e-01-discovery.md`
369
-
370
- **Items incorrectly flagged as critical (actually working as designed):**
371
- - ✅ Configuration path references (installation-time placeholders)
372
- - ✅ Planning artifacts folder (installation-time placeholder)
373
-
374
- #### High Priority Improvements
375
-
376
- 2. **⚠️ Split Large Step Files** (>250 lines):
377
- - `step-v-09-project-type-validation.md` (263 lines)
378
- - `step-v-11-holistic-quality-validation.md` (264 lines)
379
- - `step-e-03-edit.md` (253 lines)
380
-
381
- 3. **⚠️ Update Documentation Inconsistencies**:
382
- - Fix step count reference (11 → 12 steps in create mode)
383
- - Update edit mode status (Future → Implemented)
384
-
385
- #### Medium Priority Enhancements
386
-
387
- 4. **Enhance PRD Template** (currently minimal at 10 lines)
388
- 5. **Add quick-start README** for new users
389
- 6. **Address step numbering gap** (cosmetic - missing step-11-complete.md)
390
-
391
- #### Edit Mode Status - FUNCTIONALLY COMPLETE ✅
392
-
393
- The edit workflow is **complete and well-designed** with 5 steps:
394
- - Discovery → Legacy Conversion (branch) → Review → Edit → Complete
395
- - Edit mode is inherently simpler than create mode (targeted improvements vs full creation)
396
- - Uses subprocesses for complex operations
397
- - Integrates with validation workflow
398
-
399
- **No additional steps needed.**
400
-
401
- ### Key Strengths
402
-
403
- ✅ **Excellent step file quality** - Clear, well-structured instructions
404
- ✅ **Comprehensive validation system** - 13 dedicated validation steps
405
- ✅ **Strong BMAD compliance** - JIT loading, state tracking, sequential enforcement
406
- ✅ **Tri-modal architecture** - Create, Validate, Edit all implemented
407
- ✅ **Professional documentation** - Clear, consistent, well-presented
408
- ✅ **Proper agent integration** - Registered in PM agent menu
409
-
410
- ### Areas for Improvement (Optional)
411
-
412
- ⚠️ **File size management** - Many files approaching limits (maintainability consideration)
413
- ⚠️ **Documentation consistency** - Minor discrepancies in counts/status (cosmetic)
414
- ✅ **Edit mode** - Functionally complete, no additional steps needed
415
-
416
- ### Conclusion
417
-
418
- The PRD workflow is **well-designed and fully compliant** with BMAD standards. The step file architecture is exemplary, the content quality is excellent, and the documentation is comprehensive. The only critical issue (edit workflow path) has been **resolved**, and all other flagged items were actually working as designed (installation-time placeholders).
419
-
420
- **Current Status: ✅ PRODUCTION-READY**
421
-
422
- **Recommended Optional Enhancements:**
423
- 1. Split the 3 files exceeding 250-line limit (maintainability)
424
- 2. Update documentation inconsistencies (step counts, edit mode status)
425
- 3. Enhance PRD template and add quick-start README (user experience)
426
-
427
- The PRD workflow is ready for production use and fully compliant with BMAD workflow standards.
428
-
429
- ---
430
-
431
- **Validation Completed:** 2026-01-08
432
- **Validation Method:** Systematic subprocess analysis with maximum context coverage
433
- **Validator:** BMAD Workflow Validation System (Wendy - Workflow Building Master)
@@ -1,150 +0,0 @@
1
- ---
2
- name: prd
3
- description: PRD tri-modal workflow - Create, Validate, or Edit comprehensive PRDs
4
- main_config: '{project-root}/_bmad/bmm/config.yaml'
5
- nextStep: './steps-c/step-01-init.md'
6
- validateWorkflow: './steps-v/step-v-01-discovery.md'
7
- editWorkflow: './steps-e/step-e-01-discovery.md'
8
- web_bundle: true
9
- ---
10
-
11
- # PRD Workflow (Tri-Modal)
12
-
13
- **Goal:** Create, Validate, or Edit comprehensive PRDs through structured workflows.
14
-
15
- **Your Role:**
16
- - **Create Mode:** Product-focused PM facilitator collaborating with an expert peer
17
- - **Validate Mode:** Validation Architect and Quality Assurance Specialist
18
- - **Edit Mode:** PRD improvement specialist
19
-
20
- You will continue to operate with your given name, identity, and communication_style, merged with the details of this role description.
21
-
22
- ---
23
-
24
- ## MODE DETERMINATION
25
-
26
- ### Detect Workflow Mode
27
-
28
- Determine which mode to invoke based on:
29
-
30
- 1. **Command/Invocation:**
31
- - "create prd" or "new prd" → Create mode
32
- - "validate prd" or "check prd" → Validate mode
33
- - "edit prd" or "improve prd" → Edit mode
34
-
35
- 2. **Context Detection:**
36
- - If invoked with -c flag → Create mode
37
- - If invoked with -v flag → Validate mode
38
- - If invoked with -e flag → Edit mode
39
-
40
- 3. **Menu Selection (if unclear):**
41
-
42
- If mode cannot be determined from invocation:
43
- "**PRD Workflow - Select Mode:**
44
-
45
- **[C] Create** - Create a new PRD from scratch
46
- **[V] Validate** - Validate an existing PRD against BMAD standards
47
- **[E] Edit** - Improve an existing PRD
48
-
49
- Which mode would you like?"
50
-
51
- Wait for user selection.
52
-
53
- ### Route to Appropriate Workflow
54
-
55
- **IF Create Mode:**
56
- "**Create Mode: Creating a new PRD from scratch.**"
57
- Load, read entire file, then execute: `{nextStep}` (steps-c/step-01-init.md)
58
-
59
- **IF Validate Mode:**
60
- "**Validate Mode: Validating an existing PRD against BMAD standards.**"
61
- Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
62
- Then load, read entire file, and execute: `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
63
-
64
- **IF Edit Mode:**
65
- "**Edit Mode: Improving an existing PRD.**"
66
- Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
67
- Then load, read entire file, and execute: `{editWorkflow}` (steps-e/step-e-01-discovery.md)
68
-
69
- ---
70
-
71
- ## WORKFLOW ARCHITECTURE
72
-
73
- This uses **step-file architecture** for disciplined execution:
74
-
75
- ### Core Principles
76
-
77
- - **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly
78
- - **Just-In-Time Loading**: Only the current step file is in memory - never load future step files until told to do so
79
- - **Sequential Enforcement**: Sequence within the step files must be completed in order, no skipping or optimization allowed
80
- - **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document
81
- - **Append-Only Building**: Build documents by appending content as directed to the output file
82
-
83
- ### Step Processing Rules
84
-
85
- 1. **READ COMPLETELY**: Always read the entire step file before taking any action
86
- 2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
87
- 3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
88
- 4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
89
- 5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step
90
- 6. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
91
-
92
- ### Critical Rules (NO EXCEPTIONS)
93
-
94
- - 🛑 **NEVER** load multiple step files simultaneously
95
- - 📖 **ALWAYS** read entire step file before execution
96
- - 🚫 **NEVER** skip steps or optimize the sequence
97
- - 💾 **ALWAYS** update frontmatter of output files when writing the final output for a specific step
98
- - 🎯 **ALWAYS** follow the exact instructions in the step file
99
- - ⏸️ **ALWAYS** halt at menus and wait for user input
100
- - 📋 **NEVER** create mental todo lists from future steps
101
-
102
- ---
103
-
104
- ## INITIALIZATION SEQUENCE
105
-
106
- ### 1. Mode Determination
107
-
108
- **Check if mode was specified in the command invocation:**
109
-
110
- - If user invoked with "create prd" or "new prd" or "build prd" or "-c" or "--create" → Set mode to **create**
111
- - If user invoked with "validate prd" or "review prd" or "check prd" or "-v" or "--validate" → Set mode to **validate**
112
- - If user invoked with "edit prd" or "modify prd" or "improve prd" or "-e" or "--edit" → Set mode to **edit**
113
-
114
- **If mode is still unclear, ask user:**
115
-
116
- "**PRD Workflow - Select Mode:**
117
-
118
- **[C] Create** - Create a new PRD from scratch
119
- **[V] Validate** - Validate an existing PRD against BMAD standards
120
- **[E] Edit** - Improve an existing PRD
121
-
122
- Which mode would you like?"
123
-
124
- Wait for user selection.
125
-
126
- ### 2. Configuration Loading
127
-
128
- Load and read full config from {main_config} and resolve:
129
-
130
- - `project_name`, `output_folder`, `planning_artifacts`, `user_name`
131
- - `communication_language`, `document_output_language`, `user_skill_level`
132
- - `date` as system-generated current datetime
133
-
134
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
135
-
136
- ### 3. Route to Appropriate Workflow
137
-
138
- **IF mode == create:**
139
- "**Create Mode: Creating a new PRD from scratch.**"
140
- Load, read entire file, then execute `{nextStep}` (steps-c/step-01-init.md)
141
-
142
- **IF mode == validate:**
143
- "**Validate Mode: Validating an existing PRD against BMAD standards.**"
144
- Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
145
- Then load, read entire file, and execute `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
146
-
147
- **IF mode == edit:**
148
- "**Edit Mode: Improving an existing PRD.**"
149
- Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
150
- Then load, read entire file, and execute `{editWorkflow}` (steps-e/step-e-01-discovery.md)
@@ -1,59 +0,0 @@
1
- # BMM Project Scale Levels - Source of Truth
2
- # Reference: /_bmad/bmm/README.md lines 77-85
3
-
4
- levels:
5
- 0:
6
- name: "Level 0"
7
- title: "Single Atomic Change"
8
- stories: "1 story"
9
- description: "Bug fix, tiny feature, one small change"
10
- documentation: "Minimal - tech spec only"
11
- architecture: false
12
-
13
- 1:
14
- name: "Level 1"
15
- title: "Small Feature"
16
- stories: "1-10 stories"
17
- description: "Small coherent feature, minimal documentation"
18
- documentation: "Tech spec"
19
- architecture: false
20
-
21
- 2:
22
- name: "Level 2"
23
- title: "Medium Project"
24
- stories: "5-15 stories"
25
- description: "Multiple features, focused PRD"
26
- documentation: "PRD + optional tech spec"
27
- architecture: false
28
-
29
- 3:
30
- name: "Level 3"
31
- title: "Complex System"
32
- stories: "12-40 stories"
33
- description: "Subsystems, integrations, full architecture"
34
- documentation: "PRD + architecture + JIT tech specs"
35
- architecture: true
36
-
37
- 4:
38
- name: "Level 4"
39
- title: "Enterprise Scale"
40
- stories: "40+ stories"
41
- description: "Multiple products, enterprise architecture"
42
- documentation: "PRD + architecture + JIT tech specs"
43
- architecture: true
44
-
45
- # Quick detection hints for workflow-init
46
- detection_hints:
47
- keywords:
48
- level_0: ["fix", "bug", "typo", "small change", "quick update", "patch"]
49
- level_1: ["simple", "basic", "small feature", "add", "minor"]
50
- level_2: ["dashboard", "several features", "admin panel", "medium"]
51
- level_3: ["platform", "integration", "complex", "system", "architecture"]
52
- level_4: ["enterprise", "multi-tenant", "multiple products", "ecosystem", "scale"]
53
-
54
- story_counts:
55
- level_0: [1, 1]
56
- level_1: [1, 10]
57
- level_2: [5, 15]
58
- level_3: [12, 40]
59
- level_4: [40, 999]