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
@@ -0,0 +1,170 @@
1
+ ---
2
+ name: 'step-02c-executive-summary'
3
+ description: 'Generate and append the Executive Summary section to the PRD document'
4
+
5
+ # File References
6
+ nextStepFile: './step-03-success.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Task References
10
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
+ ---
13
+
14
+ # Step 2c: Executive Summary Generation
15
+
16
+ **Progress: Step 2c of 13** - Next: Success Criteria
17
+
18
+ ## STEP GOAL:
19
+
20
+ Generate the Executive Summary content using insights from classification (step 2) and vision discovery (step 2b), then append it to the PRD document.
21
+
22
+ ## MANDATORY EXECUTION RULES (READ FIRST):
23
+
24
+ ### Universal Rules:
25
+
26
+ - 🛑 NEVER generate content without user input
27
+ - 📖 CRITICAL: Read the complete step file before taking any action
28
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read
29
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
30
+ - 📋 YOU ARE A FACILITATOR, not a content generator
31
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
32
+
33
+ ### Role Reinforcement:
34
+
35
+ - ✅ You are a product-focused PM facilitator collaborating with an expert peer
36
+ - ✅ We engage in collaborative dialogue, not command-response
37
+ - ✅ Content is drafted collaboratively — present for review before saving
38
+
39
+ ### Step-Specific Rules:
40
+
41
+ - 🎯 Generate Executive Summary content based on discovered insights
42
+ - 💬 Present draft content for user review and refinement before appending
43
+ - 🚫 FORBIDDEN to append content without user approval via 'C'
44
+ - 🎯 Content must be dense, precise, and zero-fluff (PRD quality standards)
45
+
46
+ ## EXECUTION PROTOCOLS:
47
+
48
+ - 🎯 Show your analysis before taking any action
49
+ - ⚠️ Present A/P/C menu after generating executive summary content
50
+ - 💾 ONLY save when user chooses C (Continue)
51
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
52
+ - 🚫 FORBIDDEN to load next step until C is selected
53
+
54
+ ## CONTEXT BOUNDARIES:
55
+
56
+ - Current document and frontmatter from steps 1, 2, and 2b are available
57
+ - Project classification exists from step 2 (project type, domain, complexity, context)
58
+ - Vision and differentiator insights exist from step 2b
59
+ - Input documents from step 1 are available (product briefs, research, brainstorming, project docs)
60
+ - This step generates and appends the first substantive content to the PRD
61
+
62
+ ## YOUR TASK:
63
+
64
+ Draft the Executive Summary section using all discovered insights, present it for user review, and append it to the PRD document when approved.
65
+
66
+ ## EXECUTIVE SUMMARY GENERATION SEQUENCE:
67
+
68
+ ### 1. Synthesize Available Context
69
+
70
+ Review all available context before drafting:
71
+ - Classification from step 2: project type, domain, complexity, project context
72
+ - Vision and differentiator from step 2b: what makes this special, core insight
73
+ - Input documents: product briefs, research, brainstorming, project docs
74
+
75
+ ### 2. Draft Executive Summary Content
76
+
77
+ Generate the Executive Summary section using the content structure below. Apply PRD quality standards:
78
+ - High information density — every sentence carries weight
79
+ - Zero fluff — no filler phrases or vague language
80
+ - Precise and actionable — clear, specific statements
81
+ - Dual-audience optimized — readable by humans, consumable by LLMs
82
+
83
+ ### 3. Present Draft for Review
84
+
85
+ Present the drafted content to the user for review:
86
+
87
+ "Here's the Executive Summary I've drafted based on our discovery work. Please review and let me know if you'd like any changes:"
88
+
89
+ Show the full drafted content using the structure from the Content Structure section below.
90
+
91
+ Allow the user to:
92
+ - Request specific changes to any section
93
+ - Add missing information
94
+ - Refine the language or emphasis
95
+ - Approve as-is
96
+
97
+ ### N. Present MENU OPTIONS
98
+
99
+ Present the executive summary content for user review, then display menu:
100
+
101
+ "Here's the Executive Summary for your PRD. Review the content above and let me know what you'd like to do."
102
+
103
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Success Criteria (Step 3 of 13)"
104
+
105
+ #### Menu Handling Logic:
106
+ - IF A: Read fully and follow: {advancedElicitationTask} with the current executive summary content, process the enhanced content that comes back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
107
+ - IF P: Read fully and follow: {partyModeWorkflow} with the current executive summary content, process the collaborative improvements, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
108
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
109
+ - IF Any other: help user respond, then redisplay menu
110
+
111
+ #### EXECUTION RULES:
112
+ - ALWAYS halt and wait for user input after presenting menu
113
+ - ONLY proceed to next step when user selects 'C'
114
+ - After other menu items execution, return to this menu
115
+
116
+ ## APPEND TO DOCUMENT:
117
+
118
+ When user selects 'C', append the following content structure directly to the document:
119
+
120
+ ```markdown
121
+ ## Executive Summary
122
+
123
+ {vision_alignment_content}
124
+
125
+ ### What Makes This Special
126
+
127
+ {product_differentiator_content}
128
+
129
+ ## Project Classification
130
+
131
+ {project_classification_content}
132
+ ```
133
+
134
+ Where:
135
+ - `{vision_alignment_content}` — Product vision, target users, and the problem being solved. Dense, precise summary drawn from step 2b vision discovery.
136
+ - `{product_differentiator_content}` — What makes this product unique, the core insight, and why users will choose it over alternatives. Drawn from step 2b differentiator discovery.
137
+ - `{project_classification_content}` — Project type, domain, complexity level, and project context (greenfield/brownfield). Drawn from step 2 classification.
138
+
139
+ ## CRITICAL STEP COMPLETION NOTE
140
+
141
+ ONLY WHEN [C continue option] is selected and [content appended to document], will you then read fully and follow: `{nextStepFile}` to define success criteria.
142
+
143
+ ---
144
+
145
+ ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
146
+
147
+ ### ✅ SUCCESS:
148
+
149
+ - Executive Summary drafted using insights from steps 2 and 2b
150
+ - Content meets PRD quality standards (dense, precise, zero-fluff)
151
+ - Draft presented to user for review before saving
152
+ - User given opportunity to refine content
153
+ - Content properly appended to document when C selected
154
+ - A/P/C menu presented and handled correctly
155
+ - Frontmatter updated with stepsCompleted when C selected
156
+
157
+ ### ❌ SYSTEM FAILURE:
158
+
159
+ - Generating content without incorporating discovered vision and classification
160
+ - Appending content without user selecting 'C'
161
+ - Producing vague, fluffy, or low-density content
162
+ - Not presenting draft for user review
163
+ - Not presenting A/P/C menu after content generation
164
+ - Skipping directly to next step without appending content
165
+
166
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
167
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
168
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
169
+
170
+ **Master Rule:** Generate high-quality Executive Summary content from discovered insights. Present for review, refine collaboratively, and only save when the user approves. This is the first substantive content in the PRD — it sets the quality bar for everything that follows.
@@ -1,226 +1,226 @@
1
- ---
2
- name: 'step-03-success'
3
- description: 'Define comprehensive success criteria covering user, business, and technical success'
4
-
5
- # File References
6
- nextStepFile: './step-04-journeys.md'
7
- outputFile: '{planning_artifacts}/prd.md'
8
-
9
- # Task References
10
- advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
- partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
- ---
13
-
14
- # Step 3: Success Criteria Definition
15
-
16
- **Progress: Step 3 of 11** - Next: User Journey Mapping
17
-
18
- ## MANDATORY EXECUTION RULES (READ FIRST):
19
-
20
- - 🛑 NEVER generate content without user input
21
-
22
- - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
23
- - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
24
- - ✅ ALWAYS treat this as collaborative discovery between PM peers
25
- - 📋 YOU ARE A FACILITATOR, not a content generator
26
- - 💬 FOCUS on defining what winning looks like for this product
27
- - 🎯 COLLABORATIVE discovery, not assumption-based goal setting
28
- - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
-
30
- ## EXECUTION PROTOCOLS:
31
-
32
- - 🎯 Show your analysis before taking any action
33
- - ⚠️ Present A/P/C menu after generating success criteria content
34
- - 💾 ONLY save when user chooses C (Continue)
35
- - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
36
- - 🚫 FORBIDDEN to load next step until C is selected
37
-
38
- ## CONTEXT BOUNDARIES:
39
-
40
- - Current document and frontmatter from previous steps are available
41
- - Executive Summary and Project Classification already exist in document
42
- - Input documents from step-01 are available (product briefs, research, brainstorming)
43
- - No additional data files needed for this step
44
- - Focus on measurable, specific success criteria
45
- - LEVERAGE existing input documents to inform success criteria
46
-
47
- ## YOUR TASK:
48
-
49
- Define comprehensive success criteria that cover user success, business success, and technical success, using input documents as a foundation while allowing user refinement.
50
-
51
- ## SUCCESS DISCOVERY SEQUENCE:
52
-
53
- ### 1. Begin Success Definition Conversation
54
-
55
- **Check Input Documents for Success Indicators:**
56
- Analyze product brief, research, and brainstorming documents for success criteria already mentioned.
57
-
58
- **If Input Documents Contain Success Criteria:**
59
- Guide user to refine existing success criteria:
60
- - Acknowledge what's already documented in their materials
61
- - Extract key success themes from brief, research, and brainstorming
62
- - Help user identify gaps and areas for expansion
63
- - Probe for specific, measurable outcomes: When do users feel delighted/relieved/empowered?
64
- - Ask about emotional success moments and completion scenarios
65
- - Explore what "worth it" means beyond what's already captured
66
-
67
- **If No Success Criteria in Input Documents:**
68
- Start with user-centered success exploration:
69
- - Guide conversation toward defining what "worth it" means for users
70
- - Ask about the moment users realize their problem is solved
71
- - Explore specific user outcomes and emotional states
72
- - Identify success "aha!" moments and completion scenarios
73
- - Focus on user experience of success first
74
-
75
- ### 2. Explore User Success Metrics
76
-
77
- Listen for specific user outcomes and help make them measurable:
78
-
79
- - Guide from vague to specific: NOT "users are happy" → "users complete [key action] within [timeframe]"
80
- - Ask about emotional success: "When do they feel delighted/relieved/empowered?"
81
- - Identify success moments: "What's the 'aha!' moment?"
82
- - Define completion scenarios: "What does 'done' look like for the user?"
83
-
84
- ### 3. Define Business Success
85
-
86
- Transition to business metrics:
87
- - Guide conversation to business perspective on success
88
- - Explore timelines: What does 3-month success look like? 12-month success?
89
- - Identify key business metrics: revenue, user growth, engagement, or other measures?
90
- - Ask what specific metric would indicate "this is working"
91
- - Understand business success from their perspective
92
-
93
- ### 4. Challenge Vague Metrics
94
-
95
- Push for specificity on business metrics:
96
-
97
- - "10,000 users" → "What kind of users? Doing what?"
98
- - "99.9% uptime" → "What's the real concern - data loss? Failed payments?"
99
- - "Fast" → "How fast, and what specifically needs to be fast?"
100
- - "Good adoption" → "What percentage adoption by when?"
101
-
102
- ### 5. Connect to Product Differentiator
103
-
104
- Tie success metrics back to what makes the product special:
105
- - Connect success criteria to the product's unique differentiator
106
- - Ensure metrics reflect the specific value proposition
107
- - Adapt success criteria to domain context:
108
- - Consumer: User love, engagement, retention
109
- - B2B: ROI, efficiency, adoption
110
- - Developer tools: Developer experience, community
111
- - Regulated: Compliance, safety, validation
112
- - GovTech: Government compliance, accessibility, procurement
113
-
114
- ### 6. Smart Scope Negotiation
115
-
116
- Guide scope definition through success lens:
117
- - Help user distinguish MVP (must work to be useful) from growth (competitive) and vision (dream)
118
- - Guide conversation through three scope levels:
119
- 1. MVP: What's essential for proving the concept?
120
- 2. Growth: What makes it competitive?
121
- 3. Vision: What's the dream version?
122
- - Challenge scope creep conversationally: Could this wait until after launch? Is this essential for MVP?
123
- - For complex domains: Ensure compliance minimums are included in MVP
124
-
125
- ### 7. Generate Success Criteria Content
126
-
127
- Prepare the content to append to the document:
128
-
129
- #### Content Structure:
130
-
131
- When saving to document, append these Level 2 and Level 3 sections:
132
-
133
- ```markdown
134
- ## Success Criteria
135
-
136
- ### User Success
137
-
138
- [Content about user success criteria based on conversation]
139
-
140
- ### Business Success
141
-
142
- [Content about business success metrics based on conversation]
143
-
144
- ### Technical Success
145
-
146
- [Content about technical success requirements based on conversation]
147
-
148
- ### Measurable Outcomes
149
-
150
- [Content about specific measurable outcomes based on conversation]
151
-
152
- ## Product Scope
153
-
154
- ### MVP - Minimum Viable Product
155
-
156
- [Content about MVP scope based on conversation]
157
-
158
- ### Growth Features (Post-MVP)
159
-
160
- [Content about growth features based on conversation]
161
-
162
- ### Vision (Future)
163
-
164
- [Content about future vision based on conversation]
165
- ```
166
-
167
- ### 8. Present MENU OPTIONS
168
-
169
- Present the success criteria content for user review, then display menu:
170
-
171
- - Show the drafted success criteria and scope definition (using structure from section 7)
172
- - Ask if they'd like to refine further, get other perspectives, or proceed
173
- - Present menu options naturally as part of the conversation
174
-
175
- Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)"
176
-
177
- #### Menu Handling Logic:
178
- - IF A: Execute {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
179
- - IF P: Execute {partyModeWorkflow} with the current success criteria, process the collaborative improvements to metrics and scope, ask user "Accept these changes to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
180
- - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then load, read entire file, then execute {nextStepFile}
181
- - IF Any other: help user respond, then redisplay menu
182
-
183
- #### EXECUTION RULES:
184
- - ALWAYS halt and wait for user input after presenting menu
185
- - ONLY proceed to next step when user selects 'C'
186
- - After other menu items execution, return to this menu
187
-
188
- ## APPEND TO DOCUMENT:
189
-
190
- When user selects 'C', append the content directly to the document using the structure from step 7.
191
-
192
- ## SUCCESS METRICS:
193
-
194
- ✅ User success criteria clearly identified and made measurable
195
- ✅ Business success metrics defined with specific targets
196
- ✅ Success criteria connected to product differentiator
197
- ✅ Scope properly negotiated (MVP, Growth, Vision)
198
- ✅ A/P/C menu presented and handled correctly
199
- ✅ Content properly appended to document when C selected
200
-
201
- ## FAILURE MODES:
202
-
203
- ❌ Accepting vague success metrics without pushing for specificity
204
- ❌ Not connecting success criteria back to product differentiator
205
- ❌ Missing scope negotiation and leaving it undefined
206
- ❌ Generating content without real user input on what success looks like
207
- ❌ Not presenting A/P/C menu after content generation
208
- ❌ Appending content without user selecting 'C'
209
-
210
- ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
211
- ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
212
- ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
213
-
214
- ## DOMAIN CONSIDERATIONS:
215
-
216
- If working in regulated domains (healthcare, fintech, govtech):
217
-
218
- - Include compliance milestones in success criteria
219
- - Add regulatory approval timelines to MVP scope
220
- - Consider audit requirements as technical success metrics
221
-
222
- ## NEXT STEP:
223
-
224
- After user selects 'C' and content is saved to document, load `./step-04-journeys.md` to map user journeys.
225
-
226
- Remember: Do NOT proceed to step-04 until user explicitly selects 'C' from the A/P/C menu and content is saved!
1
+ ---
2
+ name: 'step-03-success'
3
+ description: 'Define comprehensive success criteria covering user, business, and technical success'
4
+
5
+ # File References
6
+ nextStepFile: './step-04-journeys.md'
7
+ outputFile: '{planning_artifacts}/prd.md'
8
+
9
+ # Task References
10
+ advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
11
+ partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
12
+ ---
13
+
14
+ # Step 3: Success Criteria Definition
15
+
16
+ **Progress: Step 3 of 11** - Next: User Journey Mapping
17
+
18
+ ## MANDATORY EXECUTION RULES (READ FIRST):
19
+
20
+ - 🛑 NEVER generate content without user input
21
+
22
+ - 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
23
+ - 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
24
+ - ✅ ALWAYS treat this as collaborative discovery between PM peers
25
+ - 📋 YOU ARE A FACILITATOR, not a content generator
26
+ - 💬 FOCUS on defining what winning looks like for this product
27
+ - 🎯 COLLABORATIVE discovery, not assumption-based goal setting
28
+ - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
29
+
30
+ ## EXECUTION PROTOCOLS:
31
+
32
+ - 🎯 Show your analysis before taking any action
33
+ - ⚠️ Present A/P/C menu after generating success criteria content
34
+ - 💾 ONLY save when user chooses C (Continue)
35
+ - 📖 Update output file frontmatter, adding this step name to the end of the list of stepsCompleted
36
+ - 🚫 FORBIDDEN to load next step until C is selected
37
+
38
+ ## CONTEXT BOUNDARIES:
39
+
40
+ - Current document and frontmatter from previous steps are available
41
+ - Executive Summary and Project Classification already exist in document
42
+ - Input documents from step-01 are available (product briefs, research, brainstorming)
43
+ - No additional data files needed for this step
44
+ - Focus on measurable, specific success criteria
45
+ - LEVERAGE existing input documents to inform success criteria
46
+
47
+ ## YOUR TASK:
48
+
49
+ Define comprehensive success criteria that cover user success, business success, and technical success, using input documents as a foundation while allowing user refinement.
50
+
51
+ ## SUCCESS DISCOVERY SEQUENCE:
52
+
53
+ ### 1. Begin Success Definition Conversation
54
+
55
+ **Check Input Documents for Success Indicators:**
56
+ Analyze product brief, research, and brainstorming documents for success criteria already mentioned.
57
+
58
+ **If Input Documents Contain Success Criteria:**
59
+ Guide user to refine existing success criteria:
60
+ - Acknowledge what's already documented in their materials
61
+ - Extract key success themes from brief, research, and brainstorming
62
+ - Help user identify gaps and areas for expansion
63
+ - Probe for specific, measurable outcomes: When do users feel delighted/relieved/empowered?
64
+ - Ask about emotional success moments and completion scenarios
65
+ - Explore what "worth it" means beyond what's already captured
66
+
67
+ **If No Success Criteria in Input Documents:**
68
+ Start with user-centered success exploration:
69
+ - Guide conversation toward defining what "worth it" means for users
70
+ - Ask about the moment users realize their problem is solved
71
+ - Explore specific user outcomes and emotional states
72
+ - Identify success "aha!" moments and completion scenarios
73
+ - Focus on user experience of success first
74
+
75
+ ### 2. Explore User Success Metrics
76
+
77
+ Listen for specific user outcomes and help make them measurable:
78
+
79
+ - Guide from vague to specific: NOT "users are happy" → "users complete [key action] within [timeframe]"
80
+ - Ask about emotional success: "When do they feel delighted/relieved/empowered?"
81
+ - Identify success moments: "What's the 'aha!' moment?"
82
+ - Define completion scenarios: "What does 'done' look like for the user?"
83
+
84
+ ### 3. Define Business Success
85
+
86
+ Transition to business metrics:
87
+ - Guide conversation to business perspective on success
88
+ - Explore timelines: What does 3-month success look like? 12-month success?
89
+ - Identify key business metrics: revenue, user growth, engagement, or other measures?
90
+ - Ask what specific metric would indicate "this is working"
91
+ - Understand business success from their perspective
92
+
93
+ ### 4. Challenge Vague Metrics
94
+
95
+ Push for specificity on business metrics:
96
+
97
+ - "10,000 users" → "What kind of users? Doing what?"
98
+ - "99.9% uptime" → "What's the real concern - data loss? Failed payments?"
99
+ - "Fast" → "How fast, and what specifically needs to be fast?"
100
+ - "Good adoption" → "What percentage adoption by when?"
101
+
102
+ ### 5. Connect to Product Differentiator
103
+
104
+ Tie success metrics back to what makes the product special:
105
+ - Connect success criteria to the product's unique differentiator
106
+ - Ensure metrics reflect the specific value proposition
107
+ - Adapt success criteria to domain context:
108
+ - Consumer: User love, engagement, retention
109
+ - B2B: ROI, efficiency, adoption
110
+ - Developer tools: Developer experience, community
111
+ - Regulated: Compliance, safety, validation
112
+ - GovTech: Government compliance, accessibility, procurement
113
+
114
+ ### 6. Smart Scope Negotiation
115
+
116
+ Guide scope definition through success lens:
117
+ - Help user distinguish MVP (must work to be useful) from growth (competitive) and vision (dream)
118
+ - Guide conversation through three scope levels:
119
+ 1. MVP: What's essential for proving the concept?
120
+ 2. Growth: What makes it competitive?
121
+ 3. Vision: What's the dream version?
122
+ - Challenge scope creep conversationally: Could this wait until after launch? Is this essential for MVP?
123
+ - For complex domains: Ensure compliance minimums are included in MVP
124
+
125
+ ### 7. Generate Success Criteria Content
126
+
127
+ Prepare the content to append to the document:
128
+
129
+ #### Content Structure:
130
+
131
+ When saving to document, append these Level 2 and Level 3 sections:
132
+
133
+ ```markdown
134
+ ## Success Criteria
135
+
136
+ ### User Success
137
+
138
+ [Content about user success criteria based on conversation]
139
+
140
+ ### Business Success
141
+
142
+ [Content about business success metrics based on conversation]
143
+
144
+ ### Technical Success
145
+
146
+ [Content about technical success requirements based on conversation]
147
+
148
+ ### Measurable Outcomes
149
+
150
+ [Content about specific measurable outcomes based on conversation]
151
+
152
+ ## Product Scope
153
+
154
+ ### MVP - Minimum Viable Product
155
+
156
+ [Content about MVP scope based on conversation]
157
+
158
+ ### Growth Features (Post-MVP)
159
+
160
+ [Content about growth features based on conversation]
161
+
162
+ ### Vision (Future)
163
+
164
+ [Content about future vision based on conversation]
165
+ ```
166
+
167
+ ### 8. Present MENU OPTIONS
168
+
169
+ Present the success criteria content for user review, then display menu:
170
+
171
+ - Show the drafted success criteria and scope definition (using structure from section 7)
172
+ - Ask if they'd like to refine further, get other perspectives, or proceed
173
+ - Present menu options naturally as part of the conversation
174
+
175
+ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)"
176
+
177
+ #### Menu Handling Logic:
178
+ - IF A: Read fully and follow: {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
179
+ - IF P: Read fully and follow: {partyModeWorkflow} with the current success criteria, process the collaborative improvements to metrics and scope, ask user "Accept these changes to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
180
+ - IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: {nextStepFile}
181
+ - IF Any other: help user respond, then redisplay menu
182
+
183
+ #### EXECUTION RULES:
184
+ - ALWAYS halt and wait for user input after presenting menu
185
+ - ONLY proceed to next step when user selects 'C'
186
+ - After other menu items execution, return to this menu
187
+
188
+ ## APPEND TO DOCUMENT:
189
+
190
+ When user selects 'C', append the content directly to the document using the structure from step 7.
191
+
192
+ ## SUCCESS METRICS:
193
+
194
+ ✅ User success criteria clearly identified and made measurable
195
+ ✅ Business success metrics defined with specific targets
196
+ ✅ Success criteria connected to product differentiator
197
+ ✅ Scope properly negotiated (MVP, Growth, Vision)
198
+ ✅ A/P/C menu presented and handled correctly
199
+ ✅ Content properly appended to document when C selected
200
+
201
+ ## FAILURE MODES:
202
+
203
+ ❌ Accepting vague success metrics without pushing for specificity
204
+ ❌ Not connecting success criteria back to product differentiator
205
+ ❌ Missing scope negotiation and leaving it undefined
206
+ ❌ Generating content without real user input on what success looks like
207
+ ❌ Not presenting A/P/C menu after content generation
208
+ ❌ Appending content without user selecting 'C'
209
+
210
+ ❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
211
+ ❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
212
+ ❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
213
+
214
+ ## DOMAIN CONSIDERATIONS:
215
+
216
+ If working in regulated domains (healthcare, fintech, govtech):
217
+
218
+ - Include compliance milestones in success criteria
219
+ - Add regulatory approval timelines to MVP scope
220
+ - Consider audit requirements as technical success metrics
221
+
222
+ ## NEXT STEP:
223
+
224
+ After user selects 'C' and content is saved to document, load `./step-04-journeys.md` to map user journeys.
225
+
226
+ Remember: Do NOT proceed to step-04 until user explicitly selects 'C' from the A/P/C menu and content is saved!