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,675 +0,0 @@
1
- # Traceability Matrix & Gate Decision - Story {STORY_ID}
2
-
3
- **Story:** {STORY_TITLE}
4
- **Date:** {DATE}
5
- **Evaluator:** {user_name or TEA Agent}
6
-
7
- ---
8
-
9
- Note: This workflow does not generate tests. If gaps exist, run `*atdd` or `*automate` to create coverage.
10
-
11
- ## PHASE 1: REQUIREMENTS TRACEABILITY
12
-
13
- ### Coverage Summary
14
-
15
- | Priority | Total Criteria | FULL Coverage | Coverage % | Status |
16
- | --------- | -------------- | ------------- | ---------- | ------------ |
17
- | P0 | {P0_TOTAL} | {P0_FULL} | {P0_PCT}% | {P0_STATUS} |
18
- | P1 | {P1_TOTAL} | {P1_FULL} | {P1_PCT}% | {P1_STATUS} |
19
- | P2 | {P2_TOTAL} | {P2_FULL} | {P2_PCT}% | {P2_STATUS} |
20
- | P3 | {P3_TOTAL} | {P3_FULL} | {P3_PCT}% | {P3_STATUS} |
21
- | **Total** | **{TOTAL}** | **{FULL}** | **{PCT}%** | **{STATUS}** |
22
-
23
- **Legend:**
24
-
25
- - ✅ PASS - Coverage meets quality gate threshold
26
- - ⚠️ WARN - Coverage below threshold but not critical
27
- - ❌ FAIL - Coverage below minimum threshold (blocker)
28
-
29
- ---
30
-
31
- ### Detailed Mapping
32
-
33
- #### {CRITERION_ID}: {CRITERION_DESCRIPTION} ({PRIORITY})
34
-
35
- - **Coverage:** {COVERAGE_STATUS} {STATUS_ICON}
36
- - **Tests:**
37
- - `{TEST_ID}` - {TEST_FILE}:{LINE}
38
- - **Given:** {GIVEN}
39
- - **When:** {WHEN}
40
- - **Then:** {THEN}
41
- - `{TEST_ID_2}` - {TEST_FILE_2}:{LINE}
42
- - **Given:** {GIVEN_2}
43
- - **When:** {WHEN_2}
44
- - **Then:** {THEN_2}
45
-
46
- - **Gaps:** (if PARTIAL or UNIT-ONLY or INTEGRATION-ONLY)
47
- - Missing: {MISSING_SCENARIO_1}
48
- - Missing: {MISSING_SCENARIO_2}
49
-
50
- - **Recommendation:** {RECOMMENDATION_TEXT}
51
-
52
- ---
53
-
54
- #### Example: AC-1: User can login with email and password (P0)
55
-
56
- - **Coverage:** FULL ✅
57
- - **Tests:**
58
- - `1.3-E2E-001` - tests/e2e/auth.spec.ts:12
59
- - **Given:** User has valid credentials
60
- - **When:** User submits login form
61
- - **Then:** User is redirected to dashboard
62
- - `1.3-UNIT-001` - tests/unit/auth-service.spec.ts:8
63
- - **Given:** Valid email and password hash
64
- - **When:** validateCredentials is called
65
- - **Then:** Returns user object
66
-
67
- ---
68
-
69
- #### Example: AC-3: User can reset password via email (P1)
70
-
71
- - **Coverage:** PARTIAL ⚠️
72
- - **Tests:**
73
- - `1.3-E2E-003` - tests/e2e/auth.spec.ts:44
74
- - **Given:** User requests password reset
75
- - **When:** User clicks reset link in email
76
- - **Then:** User can set new password
77
-
78
- - **Gaps:**
79
- - Missing: Email delivery validation
80
- - Missing: Expired token handling (error path)
81
- - Missing: Invalid token handling (security test)
82
- - Missing: Unit test for token generation logic
83
-
84
- - **Recommendation:** Add `1.3-API-001` for email service integration testing and `1.3-UNIT-003` for token generation logic. Add `1.3-E2E-004` for error path validation (expired/invalid tokens).
85
-
86
- ---
87
-
88
- ### Gap Analysis
89
-
90
- #### Critical Gaps (BLOCKER) ❌
91
-
92
- {CRITICAL_GAP_COUNT} gaps found. **Do not release until resolved.**
93
-
94
- 1. **{CRITERION_ID}: {CRITERION_DESCRIPTION}** (P0)
95
- - Current Coverage: {COVERAGE_STATUS}
96
- - Missing Tests: {MISSING_TEST_DESCRIPTION}
97
- - Recommend: {RECOMMENDED_TEST_ID} ({RECOMMENDED_TEST_LEVEL})
98
- - Impact: {IMPACT_DESCRIPTION}
99
-
100
- ---
101
-
102
- #### High Priority Gaps (PR BLOCKER) ⚠️
103
-
104
- {HIGH_GAP_COUNT} gaps found. **Address before PR merge.**
105
-
106
- 1. **{CRITERION_ID}: {CRITERION_DESCRIPTION}** (P1)
107
- - Current Coverage: {COVERAGE_STATUS}
108
- - Missing Tests: {MISSING_TEST_DESCRIPTION}
109
- - Recommend: {RECOMMENDED_TEST_ID} ({RECOMMENDED_TEST_LEVEL})
110
- - Impact: {IMPACT_DESCRIPTION}
111
-
112
- ---
113
-
114
- #### Medium Priority Gaps (Nightly) ⚠️
115
-
116
- {MEDIUM_GAP_COUNT} gaps found. **Address in nightly test improvements.**
117
-
118
- 1. **{CRITERION_ID}: {CRITERION_DESCRIPTION}** (P2)
119
- - Current Coverage: {COVERAGE_STATUS}
120
- - Recommend: {RECOMMENDED_TEST_ID} ({RECOMMENDED_TEST_LEVEL})
121
-
122
- ---
123
-
124
- #### Low Priority Gaps (Optional) ℹ️
125
-
126
- {LOW_GAP_COUNT} gaps found. **Optional - add if time permits.**
127
-
128
- 1. **{CRITERION_ID}: {CRITERION_DESCRIPTION}** (P3)
129
- - Current Coverage: {COVERAGE_STATUS}
130
-
131
- ---
132
-
133
- ### Quality Assessment
134
-
135
- #### Tests with Issues
136
-
137
- **BLOCKER Issues** ❌
138
-
139
- - `{TEST_ID}` - {ISSUE_DESCRIPTION} - {REMEDIATION}
140
-
141
- **WARNING Issues** ⚠️
142
-
143
- - `{TEST_ID}` - {ISSUE_DESCRIPTION} - {REMEDIATION}
144
-
145
- **INFO Issues** ℹ️
146
-
147
- - `{TEST_ID}` - {ISSUE_DESCRIPTION} - {REMEDIATION}
148
-
149
- ---
150
-
151
- #### Example Quality Issues
152
-
153
- **WARNING Issues** ⚠️
154
-
155
- - `1.3-E2E-001` - 145 seconds (exceeds 90s target) - Optimize fixture setup to reduce test duration
156
- - `1.3-UNIT-005` - 320 lines (exceeds 300 line limit) - Split into multiple focused test files
157
-
158
- **INFO Issues** ℹ️
159
-
160
- - `1.3-E2E-002` - Missing Given-When-Then structure - Refactor describe block to use BDD format
161
-
162
- ---
163
-
164
- #### Tests Passing Quality Gates
165
-
166
- **{PASSING_TEST_COUNT}/{TOTAL_TEST_COUNT} tests ({PASSING_PCT}%) meet all quality criteria** ✅
167
-
168
- ---
169
-
170
- ### Duplicate Coverage Analysis
171
-
172
- #### Acceptable Overlap (Defense in Depth)
173
-
174
- - {CRITERION_ID}: Tested at unit (business logic) and E2E (user journey) ✅
175
-
176
- #### Unacceptable Duplication ⚠️
177
-
178
- - {CRITERION_ID}: Same validation at E2E and Component level
179
- - Recommendation: Remove {TEST_ID} or consolidate with {OTHER_TEST_ID}
180
-
181
- ---
182
-
183
- ### Coverage by Test Level
184
-
185
- | Test Level | Tests | Criteria Covered | Coverage % |
186
- | ---------- | ----------------- | -------------------- | ---------------- |
187
- | E2E | {E2E_COUNT} | {E2E_CRITERIA} | {E2E_PCT}% |
188
- | API | {API_COUNT} | {API_CRITERIA} | {API_PCT}% |
189
- | Component | {COMP_COUNT} | {COMP_CRITERIA} | {COMP_PCT}% |
190
- | Unit | {UNIT_COUNT} | {UNIT_CRITERIA} | {UNIT_PCT}% |
191
- | **Total** | **{TOTAL_TESTS}** | **{TOTAL_CRITERIA}** | **{TOTAL_PCT}%** |
192
-
193
- ---
194
-
195
- ### Traceability Recommendations
196
-
197
- #### Immediate Actions (Before PR Merge)
198
-
199
- 1. **{ACTION_1}** - {DESCRIPTION}
200
- 2. **{ACTION_2}** - {DESCRIPTION}
201
-
202
- #### Short-term Actions (This Sprint)
203
-
204
- 1. **{ACTION_1}** - {DESCRIPTION}
205
- 2. **{ACTION_2}** - {DESCRIPTION}
206
-
207
- #### Long-term Actions (Backlog)
208
-
209
- 1. **{ACTION_1}** - {DESCRIPTION}
210
-
211
- ---
212
-
213
- #### Example Recommendations
214
-
215
- **Immediate Actions (Before PR Merge)**
216
-
217
- 1. **Add P1 Password Reset Tests** - Implement `1.3-API-001` for email service integration and `1.3-E2E-004` for error path validation. P1 coverage currently at 80%, target is 90%.
218
- 2. **Optimize Slow E2E Test** - Refactor `1.3-E2E-001` to use faster fixture setup. Currently 145s, target is <90s.
219
-
220
- **Short-term Actions (This Sprint)**
221
-
222
- 1. **Enhance P2 Coverage** - Add E2E validation for session timeout (`1.3-E2E-005`). Currently UNIT-ONLY coverage.
223
- 2. **Split Large Test File** - Break `1.3-UNIT-005` (320 lines) into multiple focused test files (<300 lines each).
224
-
225
- **Long-term Actions (Backlog)**
226
-
227
- 1. **Enrich P3 Coverage** - Add tests for edge cases in P3 criteria if time permits.
228
-
229
- ---
230
-
231
- ## PHASE 2: QUALITY GATE DECISION
232
-
233
- **Gate Type:** {story | epic | release | hotfix}
234
- **Decision Mode:** {deterministic | manual}
235
-
236
- ---
237
-
238
- ### Evidence Summary
239
-
240
- #### Test Execution Results
241
-
242
- - **Total Tests**: {total_count}
243
- - **Passed**: {passed_count} ({pass_percentage}%)
244
- - **Failed**: {failed_count} ({fail_percentage}%)
245
- - **Skipped**: {skipped_count} ({skip_percentage}%)
246
- - **Duration**: {total_duration}
247
-
248
- **Priority Breakdown:**
249
-
250
- - **P0 Tests**: {p0_passed}/{p0_total} passed ({p0_pass_rate}%) {✅ | ❌}
251
- - **P1 Tests**: {p1_passed}/{p1_total} passed ({p1_pass_rate}%) {✅ | ⚠️ | ❌}
252
- - **P2 Tests**: {p2_passed}/{p2_total} passed ({p2_pass_rate}%) {informational}
253
- - **P3 Tests**: {p3_passed}/{p3_total} passed ({p3_pass_rate}%) {informational}
254
-
255
- **Overall Pass Rate**: {overall_pass_rate}% {✅ | ⚠️ | ❌}
256
-
257
- **Test Results Source**: {CI_run_id | test_report_url | local_run}
258
-
259
- ---
260
-
261
- #### Coverage Summary (from Phase 1)
262
-
263
- **Requirements Coverage:**
264
-
265
- - **P0 Acceptance Criteria**: {p0_covered}/{p0_total} covered ({p0_coverage}%) {✅ | ❌}
266
- - **P1 Acceptance Criteria**: {p1_covered}/{p1_total} covered ({p1_coverage}%) {✅ | ⚠️ | ❌}
267
- - **P2 Acceptance Criteria**: {p2_covered}/{p2_total} covered ({p2_coverage}%) {informational}
268
- - **Overall Coverage**: {overall_coverage}%
269
-
270
- **Code Coverage** (if available):
271
-
272
- - **Line Coverage**: {line_coverage}% {✅ | ⚠️ | ❌}
273
- - **Branch Coverage**: {branch_coverage}% {✅ | ⚠️ | ❌}
274
- - **Function Coverage**: {function_coverage}% {✅ | ⚠️ | ❌}
275
-
276
- **Coverage Source**: {coverage_report_url | coverage_file_path}
277
-
278
- ---
279
-
280
- #### Non-Functional Requirements (NFRs)
281
-
282
- **Security**: {PASS | CONCERNS | FAIL | NOT_ASSESSED} {✅ | ⚠️ | ❌}
283
-
284
- - Security Issues: {security_issue_count}
285
- - {details_if_issues}
286
-
287
- **Performance**: {PASS | CONCERNS | FAIL | NOT_ASSESSED} {✅ | ⚠️ | ❌}
288
-
289
- - {performance_metrics_summary}
290
-
291
- **Reliability**: {PASS | CONCERNS | FAIL | NOT_ASSESSED} {✅ | ⚠️ | ❌}
292
-
293
- - {reliability_metrics_summary}
294
-
295
- **Maintainability**: {PASS | CONCERNS | FAIL | NOT_ASSESSED} {✅ | ⚠️ | ❌}
296
-
297
- - {maintainability_metrics_summary}
298
-
299
- **NFR Source**: {nfr_assessment_file_path | not_assessed}
300
-
301
- ---
302
-
303
- #### Flakiness Validation
304
-
305
- **Burn-in Results** (if available):
306
-
307
- - **Burn-in Iterations**: {iteration_count} (e.g., 10)
308
- - **Flaky Tests Detected**: {flaky_test_count} {✅ if 0 | ❌ if >0}
309
- - **Stability Score**: {stability_percentage}%
310
-
311
- **Flaky Tests List** (if any):
312
-
313
- - {flaky_test_1_name} - {failure_rate}
314
- - {flaky_test_2_name} - {failure_rate}
315
-
316
- **Burn-in Source**: {CI_burn_in_run_id | not_available}
317
-
318
- ---
319
-
320
- ### Decision Criteria Evaluation
321
-
322
- #### P0 Criteria (Must ALL Pass)
323
-
324
- | Criterion | Threshold | Actual | Status |
325
- | --------------------- | --------- | ------------------------- | -------- | -------- |
326
- | P0 Coverage | 100% | {p0_coverage}% | {✅ PASS | ❌ FAIL} |
327
- | P0 Test Pass Rate | 100% | {p0_pass_rate}% | {✅ PASS | ❌ FAIL} |
328
- | Security Issues | 0 | {security_issue_count} | {✅ PASS | ❌ FAIL} |
329
- | Critical NFR Failures | 0 | {critical_nfr_fail_count} | {✅ PASS | ❌ FAIL} |
330
- | Flaky Tests | 0 | {flaky_test_count} | {✅ PASS | ❌ FAIL} |
331
-
332
- **P0 Evaluation**: {✅ ALL PASS | ❌ ONE OR MORE FAILED}
333
-
334
- ---
335
-
336
- #### P1 Criteria (Required for PASS, May Accept for CONCERNS)
337
-
338
- | Criterion | Threshold | Actual | Status |
339
- | ---------------------- | ------------------------- | -------------------- | -------- | ----------- | -------- |
340
- | P1 Coverage | ≥{min_p1_coverage}% | {p1_coverage}% | {✅ PASS | ⚠️ CONCERNS | ❌ FAIL} |
341
- | P1 Test Pass Rate | ≥{min_p1_pass_rate}% | {p1_pass_rate}% | {✅ PASS | ⚠️ CONCERNS | ❌ FAIL} |
342
- | Overall Test Pass Rate | ≥{min_overall_pass_rate}% | {overall_pass_rate}% | {✅ PASS | ⚠️ CONCERNS | ❌ FAIL} |
343
- | Overall Coverage | ≥{min_coverage}% | {overall_coverage}% | {✅ PASS | ⚠️ CONCERNS | ❌ FAIL} |
344
-
345
- **P1 Evaluation**: {✅ ALL PASS | ⚠️ SOME CONCERNS | ❌ FAILED}
346
-
347
- ---
348
-
349
- #### P2/P3 Criteria (Informational, Don't Block)
350
-
351
- | Criterion | Actual | Notes |
352
- | ----------------- | --------------- | ------------------------------------------------------------ |
353
- | P2 Test Pass Rate | {p2_pass_rate}% | {allow_p2_failures ? "Tracked, doesn't block" : "Evaluated"} |
354
- | P3 Test Pass Rate | {p3_pass_rate}% | {allow_p3_failures ? "Tracked, doesn't block" : "Evaluated"} |
355
-
356
- ---
357
-
358
- ### GATE DECISION: {PASS | CONCERNS | FAIL | WAIVED}
359
-
360
- ---
361
-
362
- ### Rationale
363
-
364
- {Explain decision based on criteria evaluation}
365
-
366
- {Highlight key evidence that drove decision}
367
-
368
- {Note any assumptions or caveats}
369
-
370
- **Example (PASS):**
371
-
372
- > All P0 criteria met with 100% coverage and pass rates across critical tests. All P1 criteria exceeded thresholds with 98% overall pass rate and 92% coverage. No security issues detected. No flaky tests in validation. Feature is ready for production deployment with standard monitoring.
373
-
374
- **Example (CONCERNS):**
375
-
376
- > All P0 criteria met, ensuring critical user journeys are protected. However, P1 coverage (88%) falls below threshold (90%) due to missing E2E test for AC-5 edge case. Overall pass rate (96%) is excellent. Issues are non-critical and have acceptable workarounds. Risk is low enough to deploy with enhanced monitoring.
377
-
378
- **Example (FAIL):**
379
-
380
- > CRITICAL BLOCKERS DETECTED:
381
- >
382
- > 1. P0 coverage incomplete (80%) - AC-2 security validation missing
383
- > 2. P0 test failures (75% pass rate) in core search functionality
384
- > 3. Unresolved SQL injection vulnerability in search filter (CRITICAL)
385
- >
386
- > Release MUST BE BLOCKED until P0 issues are resolved. Security vulnerability cannot be waived.
387
-
388
- **Example (WAIVED):**
389
-
390
- > Original decision was FAIL due to P0 test failure in legacy Excel 2007 export module (affects <1% of users). However, release contains critical GDPR compliance features required by regulatory deadline (Oct 15). Business has approved waiver given:
391
- >
392
- > - Regulatory priority overrides legacy module risk
393
- > - Workaround available (use Excel 2010+)
394
- > - Issue will be fixed in v2.4.1 hotfix (due Oct 20)
395
- > - Enhanced monitoring in place
396
-
397
- ---
398
-
399
- ### {Section: Delete if not applicable}
400
-
401
- #### Residual Risks (For CONCERNS or WAIVED)
402
-
403
- List unresolved P1/P2 issues that don't block release but should be tracked:
404
-
405
- 1. **{Risk Description}**
406
- - **Priority**: P1 | P2
407
- - **Probability**: Low | Medium | High
408
- - **Impact**: Low | Medium | High
409
- - **Risk Score**: {probability × impact}
410
- - **Mitigation**: {workaround or monitoring plan}
411
- - **Remediation**: {fix in next sprint/release}
412
-
413
- **Overall Residual Risk**: {LOW | MEDIUM | HIGH}
414
-
415
- ---
416
-
417
- #### Waiver Details (For WAIVED only)
418
-
419
- **Original Decision**: ❌ FAIL
420
-
421
- **Reason for Failure**:
422
-
423
- - {list_of_blocking_issues}
424
-
425
- **Waiver Information**:
426
-
427
- - **Waiver Reason**: {business_justification}
428
- - **Waiver Approver**: {name}, {role} (e.g., Jane Doe, VP Engineering)
429
- - **Approval Date**: {YYYY-MM-DD}
430
- - **Waiver Expiry**: {YYYY-MM-DD} (**NOTE**: Does NOT apply to next release)
431
-
432
- **Monitoring Plan**:
433
-
434
- - {enhanced_monitoring_1}
435
- - {enhanced_monitoring_2}
436
- - {escalation_criteria}
437
-
438
- **Remediation Plan**:
439
-
440
- - **Fix Target**: {next_release_version} (e.g., v2.4.1 hotfix)
441
- - **Due Date**: {YYYY-MM-DD}
442
- - **Owner**: {team_or_person}
443
- - **Verification**: {how_fix_will_be_verified}
444
-
445
- **Business Justification**:
446
- {detailed_explanation_of_why_waiver_is_acceptable}
447
-
448
- ---
449
-
450
- #### Critical Issues (For FAIL or CONCERNS)
451
-
452
- Top blockers requiring immediate attention:
453
-
454
- | Priority | Issue | Description | Owner | Due Date | Status |
455
- | -------- | ------------- | ------------------- | ------------ | ------------ | ------------------ |
456
- | P0 | {issue_title} | {brief_description} | {owner_name} | {YYYY-MM-DD} | {OPEN/IN_PROGRESS} |
457
- | P0 | {issue_title} | {brief_description} | {owner_name} | {YYYY-MM-DD} | {OPEN/IN_PROGRESS} |
458
- | P1 | {issue_title} | {brief_description} | {owner_name} | {YYYY-MM-DD} | {OPEN/IN_PROGRESS} |
459
-
460
- **Blocking Issues Count**: {p0_blocker_count} P0 blockers, {p1_blocker_count} P1 issues
461
-
462
- ---
463
-
464
- ### Gate Recommendations
465
-
466
- #### For PASS Decision ✅
467
-
468
- 1. **Proceed to deployment**
469
- - Deploy to staging environment
470
- - Validate with smoke tests
471
- - Monitor key metrics for 24-48 hours
472
- - Deploy to production with standard monitoring
473
-
474
- 2. **Post-Deployment Monitoring**
475
- - {metric_1_to_monitor}
476
- - {metric_2_to_monitor}
477
- - {alert_thresholds}
478
-
479
- 3. **Success Criteria**
480
- - {success_criterion_1}
481
- - {success_criterion_2}
482
-
483
- ---
484
-
485
- #### For CONCERNS Decision ⚠️
486
-
487
- 1. **Deploy with Enhanced Monitoring**
488
- - Deploy to staging with extended validation period
489
- - Enable enhanced logging/monitoring for known risk areas:
490
- - {risk_area_1}
491
- - {risk_area_2}
492
- - Set aggressive alerts for potential issues
493
- - Deploy to production with caution
494
-
495
- 2. **Create Remediation Backlog**
496
- - Create story: "{fix_title_1}" (Priority: {priority})
497
- - Create story: "{fix_title_2}" (Priority: {priority})
498
- - Target sprint: {next_sprint}
499
-
500
- 3. **Post-Deployment Actions**
501
- - Monitor {specific_areas} closely for {time_period}
502
- - Weekly status updates on remediation progress
503
- - Re-assess after fixes deployed
504
-
505
- ---
506
-
507
- #### For FAIL Decision ❌
508
-
509
- 1. **Block Deployment Immediately**
510
- - Do NOT deploy to any environment
511
- - Notify stakeholders of blocking issues
512
- - Escalate to tech lead and PM
513
-
514
- 2. **Fix Critical Issues**
515
- - Address P0 blockers listed in Critical Issues section
516
- - Owner assignments confirmed
517
- - Due dates agreed upon
518
- - Daily standup on blocker resolution
519
-
520
- 3. **Re-Run Gate After Fixes**
521
- - Re-run full test suite after fixes
522
- - Re-run `bmad tea *trace` workflow
523
- - Verify decision is PASS before deploying
524
-
525
- ---
526
-
527
- #### For WAIVED Decision 🔓
528
-
529
- 1. **Deploy with Business Approval**
530
- - Confirm waiver approver has signed off
531
- - Document waiver in release notes
532
- - Notify all stakeholders of waived risks
533
-
534
- 2. **Aggressive Monitoring**
535
- - {enhanced_monitoring_plan}
536
- - {escalation_procedures}
537
- - Daily checks on waived risk areas
538
-
539
- 3. **Mandatory Remediation**
540
- - Fix MUST be completed by {due_date}
541
- - Issue CANNOT be waived in next release
542
- - Track remediation progress weekly
543
- - Verify fix in next gate
544
-
545
- ---
546
-
547
- ### Next Steps
548
-
549
- **Immediate Actions** (next 24-48 hours):
550
-
551
- 1. {action_1}
552
- 2. {action_2}
553
- 3. {action_3}
554
-
555
- **Follow-up Actions** (next sprint/release):
556
-
557
- 1. {action_1}
558
- 2. {action_2}
559
- 3. {action_3}
560
-
561
- **Stakeholder Communication**:
562
-
563
- - Notify PM: {decision_summary}
564
- - Notify SM: {decision_summary}
565
- - Notify DEV lead: {decision_summary}
566
-
567
- ---
568
-
569
- ## Integrated YAML Snippet (CI/CD)
570
-
571
- ```yaml
572
- traceability_and_gate:
573
- # Phase 1: Traceability
574
- traceability:
575
- story_id: "{STORY_ID}"
576
- date: "{DATE}"
577
- coverage:
578
- overall: {OVERALL_PCT}%
579
- p0: {P0_PCT}%
580
- p1: {P1_PCT}%
581
- p2: {P2_PCT}%
582
- p3: {P3_PCT}%
583
- gaps:
584
- critical: {CRITICAL_COUNT}
585
- high: {HIGH_COUNT}
586
- medium: {MEDIUM_COUNT}
587
- low: {LOW_COUNT}
588
- quality:
589
- passing_tests: {PASSING_COUNT}
590
- total_tests: {TOTAL_TESTS}
591
- blocker_issues: {BLOCKER_COUNT}
592
- warning_issues: {WARNING_COUNT}
593
- recommendations:
594
- - "{RECOMMENDATION_1}"
595
- - "{RECOMMENDATION_2}"
596
-
597
- # Phase 2: Gate Decision
598
- gate_decision:
599
- decision: "{PASS | CONCERNS | FAIL | WAIVED}"
600
- gate_type: "{story | epic | release | hotfix}"
601
- decision_mode: "{deterministic | manual}"
602
- criteria:
603
- p0_coverage: {p0_coverage}%
604
- p0_pass_rate: {p0_pass_rate}%
605
- p1_coverage: {p1_coverage}%
606
- p1_pass_rate: {p1_pass_rate}%
607
- overall_pass_rate: {overall_pass_rate}%
608
- overall_coverage: {overall_coverage}%
609
- security_issues: {security_issue_count}
610
- critical_nfrs_fail: {critical_nfr_fail_count}
611
- flaky_tests: {flaky_test_count}
612
- thresholds:
613
- min_p0_coverage: 100
614
- min_p0_pass_rate: 100
615
- min_p1_coverage: {min_p1_coverage}
616
- min_p1_pass_rate: {min_p1_pass_rate}
617
- min_overall_pass_rate: {min_overall_pass_rate}
618
- min_coverage: {min_coverage}
619
- evidence:
620
- test_results: "{CI_run_id | test_report_url}"
621
- traceability: "{trace_file_path}"
622
- nfr_assessment: "{nfr_file_path}"
623
- code_coverage: "{coverage_report_url}"
624
- next_steps: "{brief_summary_of_recommendations}"
625
- waiver: # Only if WAIVED
626
- reason: "{business_justification}"
627
- approver: "{name}, {role}"
628
- expiry: "{YYYY-MM-DD}"
629
- remediation_due: "{YYYY-MM-DD}"
630
- ```
631
-
632
- ---
633
-
634
- ## Related Artifacts
635
-
636
- - **Story File:** {STORY_FILE_PATH}
637
- - **Test Design:** {TEST_DESIGN_PATH} (if available)
638
- - **Tech Spec:** {TECH_SPEC_PATH} (if available)
639
- - **Test Results:** {TEST_RESULTS_PATH}
640
- - **NFR Assessment:** {NFR_FILE_PATH} (if available)
641
- - **Test Files:** {TEST_DIR_PATH}
642
-
643
- ---
644
-
645
- ## Sign-Off
646
-
647
- **Phase 1 - Traceability Assessment:**
648
-
649
- - Overall Coverage: {OVERALL_PCT}%
650
- - P0 Coverage: {P0_PCT}% {P0_STATUS}
651
- - P1 Coverage: {P1_PCT}% {P1_STATUS}
652
- - Critical Gaps: {CRITICAL_COUNT}
653
- - High Priority Gaps: {HIGH_COUNT}
654
-
655
- **Phase 2 - Gate Decision:**
656
-
657
- - **Decision**: {PASS | CONCERNS | FAIL | WAIVED} {STATUS_ICON}
658
- - **P0 Evaluation**: {✅ ALL PASS | ❌ ONE OR MORE FAILED}
659
- - **P1 Evaluation**: {✅ ALL PASS | ⚠️ SOME CONCERNS | ❌ FAILED}
660
-
661
- **Overall Status:** {STATUS} {STATUS_ICON}
662
-
663
- **Next Steps:**
664
-
665
- - If PASS ✅: Proceed to deployment
666
- - If CONCERNS ⚠️: Deploy with monitoring, create remediation backlog
667
- - If FAIL ❌: Block deployment, fix critical issues, re-run workflow
668
- - If WAIVED 🔓: Deploy with business approval and aggressive monitoring
669
-
670
- **Generated:** {DATE}
671
- **Workflow:** testarch-trace v4.0 (Enhanced with Gate Decision)
672
-
673
- ---
674
-
675
- <!-- Powered by BMAD-CORE™ -->