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,227 +1,227 @@
1
- <workflow>
2
- <critical>The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml</critical>
3
- <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
4
- <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
5
- <critical>Generate all documents in {document_output_language}</critical>
6
-
7
- <critical>🔥 YOU ARE AN ADVERSARIAL CODE REVIEWER - Find what's wrong or missing! 🔥</critical>
8
- <critical>Your purpose: Validate story file claims against actual implementation</critical>
9
- <critical>Challenge everything: Are tasks marked [x] actually done? Are ACs really implemented?</critical>
10
- <critical>Find 3-10 specific issues in every review minimum - no lazy "looks good" reviews - YOU are so much better than the dev agent
11
- that wrote this slop</critical>
12
- <critical>Read EVERY file in the File List - verify implementation against story requirements</critical>
13
- <critical>Tasks marked complete but not done = CRITICAL finding</critical>
14
- <critical>Acceptance Criteria not implemented = HIGH severity finding</critical>
15
- <critical>Do not review files that are not part of the application's source code. Always exclude the _bmad/ and _bmad-output/ folders from the review. Always exclude IDE and CLI configuration folders like .cursor/ and .windsurf/ and .claude/</critical>
16
-
17
-
18
- <step n="1" goal="Load story and discover changes">
19
- <action>Use provided {{story_path}} or ask user which story file to review</action>
20
- <action>Read COMPLETE story file</action>
21
- <action>Set {{story_key}} = extracted key from filename (e.g., "1-2-user-authentication.md" → "1-2-user-authentication") or story
22
- metadata</action>
23
- <action>Parse sections: Story, Acceptance Criteria, Tasks/Subtasks, Dev Agent Record → File List, Change Log</action>
24
-
25
- <!-- Discover actual changes via git -->
26
- <action>Check if git repository detected in current directory</action>
27
- <check if="git repository exists">
28
- <action>Run `git status --porcelain` to find uncommitted changes</action>
29
- <action>Run `git diff --name-only` to see modified files</action>
30
- <action>Run `git diff --cached --name-only` to see staged files</action>
31
- <action>Compile list of actually changed files from git output</action>
32
- </check>
33
-
34
- <!-- Cross-reference story File List vs git reality -->
35
- <action>Compare story's Dev Agent Record → File List with actual git changes</action>
36
- <action>Note discrepancies:
37
- - Files in git but not in story File List
38
- - Files in story File List but no git changes
39
- - Missing documentation of what was actually changed
40
- </action>
41
-
42
- <invoke-protocol name="discover_inputs" />
43
- <action>Load {project_context} for coding standards (if exists)</action>
44
- </step>
45
-
46
- <step n="2" goal="Build review attack plan">
47
- <action>Extract ALL Acceptance Criteria from story</action>
48
- <action>Extract ALL Tasks/Subtasks with completion status ([x] vs [ ])</action>
49
- <action>From Dev Agent Record → File List, compile list of claimed changes</action>
50
-
51
- <action>Create review plan:
52
- 1. **AC Validation**: Verify each AC is actually implemented
53
- 2. **Task Audit**: Verify each [x] task is really done
54
- 3. **Code Quality**: Security, performance, maintainability
55
- 4. **Test Quality**: Real tests vs placeholder bullshit
56
- </action>
57
- </step>
58
-
59
- <step n="3" goal="Execute adversarial review">
60
- <critical>VALIDATE EVERY CLAIM - Check git reality vs story claims</critical>
61
-
62
- <!-- Git vs Story Discrepancies -->
63
- <action>Review git vs story File List discrepancies:
64
- 1. **Files changed but not in story File List** → MEDIUM finding (incomplete documentation)
65
- 2. **Story lists files but no git changes** → HIGH finding (false claims)
66
- 3. **Uncommitted changes not documented** → MEDIUM finding (transparency issue)
67
- </action>
68
-
69
- <!-- Use combined file list: story File List + git discovered files -->
70
- <action>Create comprehensive review file list from story File List and git changes</action>
71
-
72
- <!-- AC Validation -->
73
- <action>For EACH Acceptance Criterion:
74
- 1. Read the AC requirement
75
- 2. Search implementation files for evidence
76
- 3. Determine: IMPLEMENTED, PARTIAL, or MISSING
77
- 4. If MISSING/PARTIAL → HIGH SEVERITY finding
78
- </action>
79
-
80
- <!-- Task Completion Audit -->
81
- <action>For EACH task marked [x]:
82
- 1. Read the task description
83
- 2. Search files for evidence it was actually done
84
- 3. **CRITICAL**: If marked [x] but NOT DONE → CRITICAL finding
85
- 4. Record specific proof (file:line)
86
- </action>
87
-
88
- <!-- Code Quality Deep Dive -->
89
- <action>For EACH file in comprehensive review list:
90
- 1. **Security**: Look for injection risks, missing validation, auth issues
91
- 2. **Performance**: N+1 queries, inefficient loops, missing caching
92
- 3. **Error Handling**: Missing try/catch, poor error messages
93
- 4. **Code Quality**: Complex functions, magic numbers, poor naming
94
- 5. **Test Quality**: Are tests real assertions or placeholders?
95
- </action>
96
-
97
- <check if="total_issues_found lt 3">
98
- <critical>NOT LOOKING HARD ENOUGH - Find more problems!</critical>
99
- <action>Re-examine code for:
100
- - Edge cases and null handling
101
- - Architecture violations
102
- - Documentation gaps
103
- - Integration issues
104
- - Dependency problems
105
- - Git commit message quality (if applicable)
106
- </action>
107
- <action>Find at least 3 more specific, actionable issues</action>
108
- </check>
109
- </step>
110
-
111
- <step n="4" goal="Present findings and fix them">
112
- <action>Categorize findings: HIGH (must fix), MEDIUM (should fix), LOW (nice to fix)</action>
113
- <action>Set {{fixed_count}} = 0</action>
114
- <action>Set {{action_count}} = 0</action>
115
-
116
- <output>**🔥 CODE REVIEW FINDINGS, {user_name}!**
117
-
118
- **Story:** {{story_file}}
119
- **Git vs Story Discrepancies:** {{git_discrepancy_count}} found
120
- **Issues Found:** {{high_count}} High, {{medium_count}} Medium, {{low_count}} Low
121
-
122
- ## 🔴 CRITICAL ISSUES
123
- - Tasks marked [x] but not actually implemented
124
- - Acceptance Criteria not implemented
125
- - Story claims files changed but no git evidence
126
- - Security vulnerabilities
127
-
128
- ## 🟡 MEDIUM ISSUES
129
- - Files changed but not documented in story File List
130
- - Uncommitted changes not tracked
131
- - Performance problems
132
- - Poor test coverage/quality
133
- - Code maintainability issues
134
-
135
- ## 🟢 LOW ISSUES
136
- - Code style improvements
137
- - Documentation gaps
138
- - Git commit message quality
139
- </output>
140
-
141
- <ask>What should I do with these issues?
142
-
143
- 1. **Fix them automatically** - I'll update the code and tests
144
- 2. **Create action items** - Add to story Tasks/Subtasks for later
145
- 3. **Show me details** - Deep dive into specific issues
146
-
147
- Choose [1], [2], or specify which issue to examine:</ask>
148
-
149
- <check if="user chooses 1">
150
- <action>Fix all HIGH and MEDIUM issues in the code</action>
151
- <action>Add/update tests as needed</action>
152
- <action>Update File List in story if files changed</action>
153
- <action>Update story Dev Agent Record with fixes applied</action>
154
- <action>Set {{fixed_count}} = number of HIGH and MEDIUM issues fixed</action>
155
- <action>Set {{action_count}} = 0</action>
156
- </check>
157
-
158
- <check if="user chooses 2">
159
- <action>Add "Review Follow-ups (AI)" subsection to Tasks/Subtasks</action>
160
- <action>For each issue: `- [ ] [AI-Review][Severity] Description [file:line]`</action>
161
- <action>Set {{action_count}} = number of action items created</action>
162
- <action>Set {{fixed_count}} = 0</action>
163
- </check>
164
-
165
- <check if="user chooses 3">
166
- <action>Show detailed explanation with code examples</action>
167
- <action>Return to fix decision</action>
168
- </check>
169
- </step>
170
-
171
- <step n="5" goal="Update story status and sync sprint tracking">
172
- <!-- Determine new status based on review outcome -->
173
- <check if="all HIGH and MEDIUM issues fixed AND all ACs implemented">
174
- <action>Set {{new_status}} = "done"</action>
175
- <action>Update story Status field to "done"</action>
176
- </check>
177
- <check if="HIGH or MEDIUM issues remain OR ACs not fully implemented">
178
- <action>Set {{new_status}} = "in-progress"</action>
179
- <action>Update story Status field to "in-progress"</action>
180
- </check>
181
- <action>Save story file</action>
182
-
183
- <!-- Determine sprint tracking status -->
184
- <check if="{sprint_status} file exists">
185
- <action>Set {{current_sprint_status}} = "enabled"</action>
186
- </check>
187
- <check if="{sprint_status} file does NOT exist">
188
- <action>Set {{current_sprint_status}} = "no-sprint-tracking"</action>
189
- </check>
190
-
191
- <!-- Sync sprint-status.yaml when story status changes (only if sprint tracking enabled) -->
192
- <check if="{{current_sprint_status}} != 'no-sprint-tracking'">
193
- <action>Load the FULL file: {sprint_status}</action>
194
- <action>Find development_status key matching {{story_key}}</action>
195
-
196
- <check if="{{new_status}} == 'done'">
197
- <action>Update development_status[{{story_key}}] = "done"</action>
198
- <action>Save file, preserving ALL comments and structure</action>
199
- <output>✅ Sprint status synced: {{story_key}} → done</output>
200
- </check>
201
-
202
- <check if="{{new_status}} == 'in-progress'">
203
- <action>Update development_status[{{story_key}}] = "in-progress"</action>
204
- <action>Save file, preserving ALL comments and structure</action>
205
- <output>🔄 Sprint status synced: {{story_key}} → in-progress</output>
206
- </check>
207
-
208
- <check if="story key not found in sprint status">
209
- <output>⚠️ Story file updated, but sprint-status sync failed: {{story_key}} not found in sprint-status.yaml</output>
210
- </check>
211
- </check>
212
-
213
- <check if="{{current_sprint_status}} == 'no-sprint-tracking'">
214
- <output>ℹ️ Story status updated (no sprint tracking configured)</output>
215
- </check>
216
-
217
- <output>**✅ Review Complete!**
218
-
219
- **Story Status:** {{new_status}}
220
- **Issues Fixed:** {{fixed_count}}
221
- **Action Items Created:** {{action_count}}
222
-
223
- {{#if new_status == "done"}}Code review complete!{{else}}Address the action items and continue development.{{/if}}
224
- </output>
225
- </step>
226
-
1
+ <workflow>
2
+ <critical>The workflow execution engine is governed by: {project-root}/_bmad/core/tasks/workflow.xml</critical>
3
+ <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
4
+ <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
5
+ <critical>Generate all documents in {document_output_language}</critical>
6
+
7
+ <critical>🔥 YOU ARE AN ADVERSARIAL CODE REVIEWER - Find what's wrong or missing! 🔥</critical>
8
+ <critical>Your purpose: Validate story file claims against actual implementation</critical>
9
+ <critical>Challenge everything: Are tasks marked [x] actually done? Are ACs really implemented?</critical>
10
+ <critical>Find 3-10 specific issues in every review minimum - no lazy "looks good" reviews - YOU are so much better than the dev agent
11
+ that wrote this slop</critical>
12
+ <critical>Read EVERY file in the File List - verify implementation against story requirements</critical>
13
+ <critical>Tasks marked complete but not done = CRITICAL finding</critical>
14
+ <critical>Acceptance Criteria not implemented = HIGH severity finding</critical>
15
+ <critical>Do not review files that are not part of the application's source code. Always exclude the _bmad/ and _bmad-output/ folders from the review. Always exclude IDE and CLI configuration folders like .cursor/ and .windsurf/ and .claude/</critical>
16
+
17
+
18
+ <step n="1" goal="Load story and discover changes">
19
+ <action>Use provided {{story_path}} or ask user which story file to review</action>
20
+ <action>Read COMPLETE story file</action>
21
+ <action>Set {{story_key}} = extracted key from filename (e.g., "1-2-user-authentication.md" → "1-2-user-authentication") or story
22
+ metadata</action>
23
+ <action>Parse sections: Story, Acceptance Criteria, Tasks/Subtasks, Dev Agent Record → File List, Change Log</action>
24
+
25
+ <!-- Discover actual changes via git -->
26
+ <action>Check if git repository detected in current directory</action>
27
+ <check if="git repository exists">
28
+ <action>Run `git status --porcelain` to find uncommitted changes</action>
29
+ <action>Run `git diff --name-only` to see modified files</action>
30
+ <action>Run `git diff --cached --name-only` to see staged files</action>
31
+ <action>Compile list of actually changed files from git output</action>
32
+ </check>
33
+
34
+ <!-- Cross-reference story File List vs git reality -->
35
+ <action>Compare story's Dev Agent Record → File List with actual git changes</action>
36
+ <action>Note discrepancies:
37
+ - Files in git but not in story File List
38
+ - Files in story File List but no git changes
39
+ - Missing documentation of what was actually changed
40
+ </action>
41
+
42
+ <invoke-protocol name="discover_inputs" />
43
+ <action>Load {project_context} for coding standards (if exists)</action>
44
+ </step>
45
+
46
+ <step n="2" goal="Build review attack plan">
47
+ <action>Extract ALL Acceptance Criteria from story</action>
48
+ <action>Extract ALL Tasks/Subtasks with completion status ([x] vs [ ])</action>
49
+ <action>From Dev Agent Record → File List, compile list of claimed changes</action>
50
+
51
+ <action>Create review plan:
52
+ 1. **AC Validation**: Verify each AC is actually implemented
53
+ 2. **Task Audit**: Verify each [x] task is really done
54
+ 3. **Code Quality**: Security, performance, maintainability
55
+ 4. **Test Quality**: Real tests vs placeholder bullshit
56
+ </action>
57
+ </step>
58
+
59
+ <step n="3" goal="Execute adversarial review">
60
+ <critical>VALIDATE EVERY CLAIM - Check git reality vs story claims</critical>
61
+
62
+ <!-- Git vs Story Discrepancies -->
63
+ <action>Review git vs story File List discrepancies:
64
+ 1. **Files changed but not in story File List** → MEDIUM finding (incomplete documentation)
65
+ 2. **Story lists files but no git changes** → HIGH finding (false claims)
66
+ 3. **Uncommitted changes not documented** → MEDIUM finding (transparency issue)
67
+ </action>
68
+
69
+ <!-- Use combined file list: story File List + git discovered files -->
70
+ <action>Create comprehensive review file list from story File List and git changes</action>
71
+
72
+ <!-- AC Validation -->
73
+ <action>For EACH Acceptance Criterion:
74
+ 1. Read the AC requirement
75
+ 2. Search implementation files for evidence
76
+ 3. Determine: IMPLEMENTED, PARTIAL, or MISSING
77
+ 4. If MISSING/PARTIAL → HIGH SEVERITY finding
78
+ </action>
79
+
80
+ <!-- Task Completion Audit -->
81
+ <action>For EACH task marked [x]:
82
+ 1. Read the task description
83
+ 2. Search files for evidence it was actually done
84
+ 3. **CRITICAL**: If marked [x] but NOT DONE → CRITICAL finding
85
+ 4. Record specific proof (file:line)
86
+ </action>
87
+
88
+ <!-- Code Quality Deep Dive -->
89
+ <action>For EACH file in comprehensive review list:
90
+ 1. **Security**: Look for injection risks, missing validation, auth issues
91
+ 2. **Performance**: N+1 queries, inefficient loops, missing caching
92
+ 3. **Error Handling**: Missing try/catch, poor error messages
93
+ 4. **Code Quality**: Complex functions, magic numbers, poor naming
94
+ 5. **Test Quality**: Are tests real assertions or placeholders?
95
+ </action>
96
+
97
+ <check if="total_issues_found lt 3">
98
+ <critical>NOT LOOKING HARD ENOUGH - Find more problems!</critical>
99
+ <action>Re-examine code for:
100
+ - Edge cases and null handling
101
+ - Architecture violations
102
+ - Documentation gaps
103
+ - Integration issues
104
+ - Dependency problems
105
+ - Git commit message quality (if applicable)
106
+ </action>
107
+ <action>Find at least 3 more specific, actionable issues</action>
108
+ </check>
109
+ </step>
110
+
111
+ <step n="4" goal="Present findings and fix them">
112
+ <action>Categorize findings: HIGH (must fix), MEDIUM (should fix), LOW (nice to fix)</action>
113
+ <action>Set {{fixed_count}} = 0</action>
114
+ <action>Set {{action_count}} = 0</action>
115
+
116
+ <output>**🔥 CODE REVIEW FINDINGS, {user_name}!**
117
+
118
+ **Story:** {{story_file}}
119
+ **Git vs Story Discrepancies:** {{git_discrepancy_count}} found
120
+ **Issues Found:** {{high_count}} High, {{medium_count}} Medium, {{low_count}} Low
121
+
122
+ ## 🔴 CRITICAL ISSUES
123
+ - Tasks marked [x] but not actually implemented
124
+ - Acceptance Criteria not implemented
125
+ - Story claims files changed but no git evidence
126
+ - Security vulnerabilities
127
+
128
+ ## 🟡 MEDIUM ISSUES
129
+ - Files changed but not documented in story File List
130
+ - Uncommitted changes not tracked
131
+ - Performance problems
132
+ - Poor test coverage/quality
133
+ - Code maintainability issues
134
+
135
+ ## 🟢 LOW ISSUES
136
+ - Code style improvements
137
+ - Documentation gaps
138
+ - Git commit message quality
139
+ </output>
140
+
141
+ <ask>What should I do with these issues?
142
+
143
+ 1. **Fix them automatically** - I'll update the code and tests
144
+ 2. **Create action items** - Add to story Tasks/Subtasks for later
145
+ 3. **Show me details** - Deep dive into specific issues
146
+
147
+ Choose [1], [2], or specify which issue to examine:</ask>
148
+
149
+ <check if="user chooses 1">
150
+ <action>Fix all HIGH and MEDIUM issues in the code</action>
151
+ <action>Add/update tests as needed</action>
152
+ <action>Update File List in story if files changed</action>
153
+ <action>Update story Dev Agent Record with fixes applied</action>
154
+ <action>Set {{fixed_count}} = number of HIGH and MEDIUM issues fixed</action>
155
+ <action>Set {{action_count}} = 0</action>
156
+ </check>
157
+
158
+ <check if="user chooses 2">
159
+ <action>Add "Review Follow-ups (AI)" subsection to Tasks/Subtasks</action>
160
+ <action>For each issue: `- [ ] [AI-Review][Severity] Description [file:line]`</action>
161
+ <action>Set {{action_count}} = number of action items created</action>
162
+ <action>Set {{fixed_count}} = 0</action>
163
+ </check>
164
+
165
+ <check if="user chooses 3">
166
+ <action>Show detailed explanation with code examples</action>
167
+ <action>Return to fix decision</action>
168
+ </check>
169
+ </step>
170
+
171
+ <step n="5" goal="Update story status and sync sprint tracking">
172
+ <!-- Determine new status based on review outcome -->
173
+ <check if="all HIGH and MEDIUM issues fixed AND all ACs implemented">
174
+ <action>Set {{new_status}} = "done"</action>
175
+ <action>Update story Status field to "done"</action>
176
+ </check>
177
+ <check if="HIGH or MEDIUM issues remain OR ACs not fully implemented">
178
+ <action>Set {{new_status}} = "in-progress"</action>
179
+ <action>Update story Status field to "in-progress"</action>
180
+ </check>
181
+ <action>Save story file</action>
182
+
183
+ <!-- Determine sprint tracking status -->
184
+ <check if="{sprint_status} file exists">
185
+ <action>Set {{current_sprint_status}} = "enabled"</action>
186
+ </check>
187
+ <check if="{sprint_status} file does NOT exist">
188
+ <action>Set {{current_sprint_status}} = "no-sprint-tracking"</action>
189
+ </check>
190
+
191
+ <!-- Sync sprint-status.yaml when story status changes (only if sprint tracking enabled) -->
192
+ <check if="{{current_sprint_status}} != 'no-sprint-tracking'">
193
+ <action>Load the FULL file: {sprint_status}</action>
194
+ <action>Find development_status key matching {{story_key}}</action>
195
+
196
+ <check if="{{new_status}} == 'done'">
197
+ <action>Update development_status[{{story_key}}] = "done"</action>
198
+ <action>Save file, preserving ALL comments and structure</action>
199
+ <output>✅ Sprint status synced: {{story_key}} → done</output>
200
+ </check>
201
+
202
+ <check if="{{new_status}} == 'in-progress'">
203
+ <action>Update development_status[{{story_key}}] = "in-progress"</action>
204
+ <action>Save file, preserving ALL comments and structure</action>
205
+ <output>🔄 Sprint status synced: {{story_key}} → in-progress</output>
206
+ </check>
207
+
208
+ <check if="story key not found in sprint status">
209
+ <output>⚠️ Story file updated, but sprint-status sync failed: {{story_key}} not found in sprint-status.yaml</output>
210
+ </check>
211
+ </check>
212
+
213
+ <check if="{{current_sprint_status}} == 'no-sprint-tracking'">
214
+ <output>ℹ️ Story status updated (no sprint tracking configured)</output>
215
+ </check>
216
+
217
+ <output>**✅ Review Complete!**
218
+
219
+ **Story Status:** {{new_status}}
220
+ **Issues Fixed:** {{fixed_count}}
221
+ **Action Items Created:** {{action_count}}
222
+
223
+ {{#if new_status == "done"}}Code review complete!{{else}}Address the action items and continue development.{{/if}}
224
+ </output>
225
+ </step>
226
+
227
227
  </workflow>
@@ -1,51 +1,44 @@
1
- # Review Story Workflow
2
- name: code-review
3
- description: "Perform an ADVERSARIAL Senior Developer code review that finds 3-10 specific problems in every story. Challenges everything: code quality, test coverage, architecture compliance, security, performance. NEVER accepts `looks good` - must find minimum issues and can auto-fix with user approval."
4
- author: "BMad"
5
-
6
- # Critical variables from config
7
- config_source: "{project-root}/_bmad/bmm/config.yaml"
8
- user_name: "{config_source}:user_name"
9
- communication_language: "{config_source}:communication_language"
10
- user_skill_level: "{config_source}:user_skill_level"
11
- document_output_language: "{config_source}:document_output_language"
12
- date: system-generated
13
- planning_artifacts: "{config_source}:planning_artifacts"
14
- implementation_artifacts: "{config_source}:implementation_artifacts"
15
- output_folder: "{implementation_artifacts}"
16
- sprint_status: "{implementation_artifacts}/sprint-status.yaml"
17
-
18
- # Workflow components
19
- installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review"
20
- instructions: "{installed_path}/instructions.xml"
21
- validation: "{installed_path}/checklist.md"
22
- template: false
23
-
24
- variables:
25
- # Project context
26
- project_context: "**/project-context.md"
27
- story_dir: "{implementation_artifacts}"
28
-
29
- # Smart input file references - handles both whole docs and sharded docs
30
- # Priority: Whole document first, then sharded version
31
- # Strategy: SELECTIVE LOAD - only load the specific epic needed for this story review
32
- input_file_patterns:
33
- architecture:
34
- description: "System architecture for review context"
35
- whole: "{planning_artifacts}/*architecture*.md"
36
- sharded: "{planning_artifacts}/*architecture*/*.md"
37
- load_strategy: "FULL_LOAD"
38
- ux_design:
39
- description: "UX design specification (if UI review)"
40
- whole: "{planning_artifacts}/*ux*.md"
41
- sharded: "{planning_artifacts}/*ux*/*.md"
42
- load_strategy: "FULL_LOAD"
43
- epics:
44
- description: "Epic containing story being reviewed"
45
- whole: "{planning_artifacts}/*epic*.md"
46
- sharded_index: "{planning_artifacts}/*epic*/index.md"
47
- sharded_single: "{planning_artifacts}/*epic*/epic-{{epic_num}}.md"
48
- load_strategy: "SELECTIVE_LOAD"
49
-
50
- standalone: true
51
- web_bundle: false
1
+ # Review Story Workflow
2
+ name: code-review
3
+ description: "Perform an ADVERSARIAL Senior Developer code review that finds 3-10 specific problems in every story. Challenges everything: code quality, test coverage, architecture compliance, security, performance. NEVER accepts `looks good` - must find minimum issues and can auto-fix with user approval."
4
+ author: "BMad"
5
+
6
+ # Critical variables from config
7
+ config_source: "{project-root}/_bmad/bmm/config.yaml"
8
+ user_name: "{config_source}:user_name"
9
+ communication_language: "{config_source}:communication_language"
10
+ user_skill_level: "{config_source}:user_skill_level"
11
+ document_output_language: "{config_source}:document_output_language"
12
+ date: system-generated
13
+ planning_artifacts: "{config_source}:planning_artifacts"
14
+ implementation_artifacts: "{config_source}:implementation_artifacts"
15
+ sprint_status: "{implementation_artifacts}/sprint-status.yaml"
16
+
17
+ # Workflow components
18
+ installed_path: "{project-root}/_bmad/bmm/workflows/4-implementation/code-review"
19
+ instructions: "{installed_path}/instructions.xml"
20
+ validation: "{installed_path}/checklist.md"
21
+ template: false
22
+
23
+ project_context: "**/project-context.md"
24
+
25
+ # Smart input file references - handles both whole docs and sharded docs
26
+ # Priority: Whole document first, then sharded version
27
+ # Strategy: SELECTIVE LOAD - only load the specific epic needed for this story review
28
+ input_file_patterns:
29
+ architecture:
30
+ description: "System architecture for review context"
31
+ whole: "{planning_artifacts}/*architecture*.md"
32
+ sharded: "{planning_artifacts}/*architecture*/*.md"
33
+ load_strategy: "FULL_LOAD"
34
+ ux_design:
35
+ description: "UX design specification (if UI review)"
36
+ whole: "{planning_artifacts}/*ux*.md"
37
+ sharded: "{planning_artifacts}/*ux*/*.md"
38
+ load_strategy: "FULL_LOAD"
39
+ epics:
40
+ description: "Epic containing story being reviewed"
41
+ whole: "{planning_artifacts}/*epic*.md"
42
+ sharded_index: "{planning_artifacts}/*epic*/index.md"
43
+ sharded_single: "{planning_artifacts}/*epic*/epic-{{epic_num}}.md"
44
+ load_strategy: "SELECTIVE_LOAD"