bmad-method 6.1.1-next.8 → 6.2.0

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 (308) hide show
  1. package/AGENTS.md +9 -0
  2. package/README_CN.md +9 -9
  3. package/package.json +2 -1
  4. package/src/bmm/agents/analyst.agent.yaml +3 -3
  5. package/src/bmm/agents/architect.agent.yaml +1 -1
  6. package/src/bmm/agents/dev.agent.yaml +1 -1
  7. package/src/bmm/agents/pm.agent.yaml +6 -6
  8. package/src/bmm/agents/qa.agent.yaml +1 -1
  9. package/src/bmm/agents/quick-flow-solo-dev.agent.yaml +2 -2
  10. package/src/bmm/agents/sm.agent.yaml +3 -3
  11. package/src/bmm/agents/tech-writer/tech-writer.agent.yaml +1 -1
  12. package/src/bmm/module-help.csv +16 -16
  13. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md +1 -1
  14. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/product-brief.template.md +2 -2
  15. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-01-init.md +4 -11
  16. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-01b-continue.md +0 -3
  17. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-02-vision.md +5 -11
  18. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-03-users.md +5 -11
  19. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-04-metrics.md +5 -11
  20. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-05-scope.md +5 -11
  21. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-06-complete.md +0 -3
  22. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/workflow.md +3 -0
  23. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/SKILL.md +88 -0
  24. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/agents/artifact-analyzer.md +60 -0
  25. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/agents/opportunity-reviewer.md +44 -0
  26. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/agents/skeptic-reviewer.md +44 -0
  27. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/agents/web-researcher.md +49 -0
  28. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/bmad-manifest.json +17 -0
  29. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/contextual-discovery.md +57 -0
  30. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/draft-and-review.md +86 -0
  31. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/finalize.md +75 -0
  32. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/guided-elicitation.md +70 -0
  33. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/resources/brief-template.md +60 -0
  34. package/src/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md +1 -1
  35. package/src/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md +6 -0
  36. package/src/bmm/workflows/1-analysis/research/bmad-market-research/research.template.md +29 -0
  37. package/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-01-init.md +184 -0
  38. package/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-02-customer-behavior.md +239 -0
  39. package/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-03-customer-pain-points.md +251 -0
  40. package/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-04-customer-decisions.md +261 -0
  41. package/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-05-competitive-analysis.md +173 -0
  42. package/src/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-06-research-completion.md +478 -0
  43. package/src/bmm/workflows/1-analysis/research/{workflow-market-research.md → bmad-market-research/workflow.md} +1 -6
  44. package/src/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md +6 -0
  45. package/src/bmm/workflows/1-analysis/research/bmad-technical-research/research.template.md +29 -0
  46. package/src/bmm/workflows/1-analysis/research/{technical-steps → bmad-technical-research/technical-steps}/step-01-init.md +2 -2
  47. package/src/bmm/workflows/1-analysis/research/{technical-steps → bmad-technical-research/technical-steps}/step-02-technical-overview.md +2 -2
  48. package/src/bmm/workflows/1-analysis/research/{technical-steps → bmad-technical-research/technical-steps}/step-03-integration-patterns.md +2 -2
  49. package/src/bmm/workflows/1-analysis/research/{technical-steps → bmad-technical-research/technical-steps}/step-04-architectural-patterns.md +2 -2
  50. package/src/bmm/workflows/1-analysis/research/{technical-steps → bmad-technical-research/technical-steps}/step-05-implementation-research.md +2 -2
  51. package/src/bmm/workflows/1-analysis/research/{workflow-technical-research.md → bmad-technical-research/workflow.md} +0 -4
  52. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md +1 -1
  53. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-01-init.md +2 -2
  54. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-01b-continue.md +1 -1
  55. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-02-discovery.md +2 -2
  56. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-03-core-experience.md +5 -4
  57. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-04-emotional-response.md +5 -4
  58. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-05-inspiration.md +5 -4
  59. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-06-design-system.md +5 -4
  60. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-07-defining-experience.md +5 -4
  61. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-08-visual-foundation.md +5 -4
  62. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-09-design-directions.md +5 -4
  63. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-10-user-journeys.md +5 -4
  64. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-11-component-strategy.md +5 -4
  65. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-12-ux-patterns.md +5 -4
  66. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-13-responsive-accessibility.md +5 -4
  67. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-14-complete.md +2 -2
  68. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/workflow.md +1 -2
  69. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md +6 -0
  70. package/src/bmm/workflows/2-plan-workflows/{create-prd → bmad-edit-prd}/steps-e/step-e-01-discovery.md +3 -8
  71. package/src/bmm/workflows/2-plan-workflows/{create-prd → bmad-edit-prd}/steps-e/step-e-01b-legacy-conversion.md +1 -5
  72. package/src/bmm/workflows/2-plan-workflows/{create-prd → bmad-edit-prd}/steps-e/step-e-02-review.md +5 -9
  73. package/src/bmm/workflows/2-plan-workflows/{create-prd → bmad-edit-prd}/steps-e/step-e-03-edit.md +3 -6
  74. package/src/bmm/workflows/2-plan-workflows/{create-prd → bmad-edit-prd}/steps-e/step-e-04-complete.md +2 -5
  75. package/src/bmm/workflows/2-plan-workflows/{create-prd/workflow-edit-prd.md → bmad-edit-prd/workflow.md} +2 -4
  76. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md +6 -0
  77. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/data/domain-complexity.csv +15 -0
  78. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/data/prd-purpose.md +197 -0
  79. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/data/project-types.csv +11 -0
  80. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md +221 -0
  81. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02-format-detection.md +188 -0
  82. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02b-parity-check.md +206 -0
  83. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-03-density-validation.md +171 -0
  84. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-04-brief-coverage-validation.md +211 -0
  85. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-05-measurability-validation.md +225 -0
  86. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-06-traceability-validation.md +214 -0
  87. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-07-implementation-leakage-validation.md +202 -0
  88. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-08-domain-compliance-validation.md +240 -0
  89. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-09-project-type-validation.md +260 -0
  90. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-10-smart-validation.md +206 -0
  91. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md +261 -0
  92. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-12-completeness-validation.md +239 -0
  93. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md +229 -0
  94. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/workflow.md +62 -0
  95. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +2 -4
  96. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-10-smart-validation.md +1 -0
  97. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +3 -3
  98. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +2 -1
  99. package/src/bmm/workflows/2-plan-workflows/create-prd/workflow-validate-prd.md +2 -0
  100. package/src/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md +6 -0
  101. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/steps/step-01-document-discovery.md +3 -8
  102. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/steps/step-02-prd-analysis.md +1 -5
  103. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/steps/step-03-epic-coverage-validation.md +1 -5
  104. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/steps/step-04-ux-alignment.md +1 -5
  105. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/steps/step-05-epic-quality-review.md +2 -6
  106. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/steps/step-06-final-assessment.md +0 -3
  107. package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/workflow.md +0 -5
  108. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md +1 -1
  109. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-01-init.md +4 -4
  110. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-02-context.md +2 -2
  111. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-03-starter.md +4 -4
  112. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-04-decisions.md +4 -4
  113. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-05-patterns.md +4 -4
  114. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-06-structure.md +4 -4
  115. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/steps/step-07-validation.md +4 -4
  116. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/workflow.md +0 -6
  117. package/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md +6 -0
  118. package/src/bmm/workflows/3-solutioning/{create-epics-and-stories → bmad-create-epics-and-stories}/steps/step-01-validate-prerequisites.md +7 -29
  119. package/src/bmm/workflows/3-solutioning/{create-epics-and-stories → bmad-create-epics-and-stories}/steps/step-02-design-epics.md +7 -28
  120. package/src/bmm/workflows/3-solutioning/{create-epics-and-stories → bmad-create-epics-and-stories}/steps/step-03-create-stories.md +8 -29
  121. package/src/bmm/workflows/3-solutioning/{create-epics-and-stories → bmad-create-epics-and-stories}/steps/step-04-final-validation.md +2 -20
  122. package/src/bmm/workflows/3-solutioning/{create-epics-and-stories → bmad-create-epics-and-stories}/workflow.md +1 -6
  123. package/src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md +6 -0
  124. package/src/bmm/workflows/4-implementation/bmad-code-review/steps/step-01-gather-context.md +61 -0
  125. package/src/bmm/workflows/4-implementation/bmad-code-review/steps/step-02-review.md +41 -0
  126. package/src/bmm/workflows/4-implementation/bmad-code-review/steps/step-03-triage.md +50 -0
  127. package/src/bmm/workflows/4-implementation/bmad-code-review/steps/step-04-present.md +38 -0
  128. package/src/bmm/workflows/4-implementation/bmad-code-review/workflow.md +54 -0
  129. package/src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md +6 -0
  130. package/src/bmm/workflows/4-implementation/{correct-course → bmad-correct-course}/checklist.md +1 -1
  131. package/src/bmm/workflows/4-implementation/{correct-course → bmad-correct-course}/workflow.md +3 -10
  132. package/src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md +1 -1
  133. package/src/bmm/workflows/4-implementation/bmad-create-story/checklist.md +2 -2
  134. package/src/bmm/workflows/4-implementation/bmad-create-story/workflow.md +3 -11
  135. package/src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md +1 -1
  136. package/src/bmm/workflows/4-implementation/bmad-dev-story/workflow.md +0 -1
  137. package/src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md +6 -0
  138. package/src/bmm/workflows/4-implementation/{retrospective → bmad-retrospective}/workflow.md +0 -6
  139. package/src/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md +6 -0
  140. package/src/bmm/workflows/4-implementation/bmad-sprint-planning/bmad-skill-manifest.yaml +1 -0
  141. package/src/bmm/workflows/4-implementation/{sprint-planning → bmad-sprint-planning}/workflow.md +0 -8
  142. package/src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md +6 -0
  143. package/src/bmm/workflows/4-implementation/bmad-sprint-status/bmad-skill-manifest.yaml +1 -0
  144. package/src/bmm/workflows/4-implementation/{sprint-status → bmad-sprint-status}/workflow.md +0 -6
  145. package/src/bmm/workflows/bmad-document-project/SKILL.md +6 -0
  146. package/src/bmm/workflows/bmad-document-project/bmad-skill-manifest.yaml +1 -0
  147. package/src/bmm/workflows/{document-project → bmad-document-project}/instructions.md +6 -6
  148. package/src/bmm/workflows/bmad-document-project/workflow.md +27 -0
  149. package/src/bmm/workflows/{document-project → bmad-document-project}/workflows/deep-dive-instructions.md +3 -1
  150. package/src/bmm/workflows/{document-project → bmad-document-project}/workflows/deep-dive-workflow.md +4 -12
  151. package/src/bmm/workflows/{document-project → bmad-document-project}/workflows/full-scan-instructions.md +5 -3
  152. package/src/bmm/workflows/{document-project → bmad-document-project}/workflows/full-scan-workflow.md +4 -12
  153. package/src/bmm/workflows/bmad-generate-project-context/SKILL.md +6 -0
  154. package/src/bmm/workflows/bmad-generate-project-context/bmad-skill-manifest.yaml +1 -0
  155. package/src/bmm/workflows/{generate-project-context → bmad-generate-project-context}/steps/step-01-discover.md +4 -2
  156. package/src/bmm/workflows/{generate-project-context → bmad-generate-project-context}/steps/step-02-generate.md +8 -5
  157. package/src/bmm/workflows/{generate-project-context → bmad-generate-project-context}/workflow.md +2 -8
  158. package/src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md +6 -0
  159. package/src/bmm/workflows/bmad-qa-generate-e2e-tests/bmad-skill-manifest.yaml +1 -0
  160. package/src/bmm/workflows/{qa-generate-e2e-tests → bmad-qa-generate-e2e-tests}/workflow.md +2 -9
  161. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md +1 -1
  162. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-01-mode-detection.md +9 -14
  163. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-02-context-gathering.md +1 -5
  164. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-03-execute.md +1 -5
  165. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-04-self-check.md +1 -5
  166. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-05-adversarial-review.md +1 -5
  167. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-06-resolve-findings.md +0 -2
  168. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/workflow.md +0 -6
  169. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md +1 -1
  170. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-01-clarify-and-route.md +2 -5
  171. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-02-plan.md +2 -6
  172. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-03-implement.md +1 -3
  173. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-04-review.md +3 -6
  174. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/steps/step-05-present.md +0 -2
  175. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/workflow.md +0 -1
  176. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md +6 -0
  177. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/bmad-skill-manifest.yaml +1 -0
  178. package/src/bmm/workflows/bmad-quick-flow/{quick-spec → bmad-quick-spec}/steps/step-01-understand.md +7 -11
  179. package/src/bmm/workflows/bmad-quick-flow/{quick-spec → bmad-quick-spec}/steps/step-02-investigate.md +3 -6
  180. package/src/bmm/workflows/bmad-quick-flow/{quick-spec → bmad-quick-spec}/steps/step-03-generate.md +1 -4
  181. package/src/bmm/workflows/bmad-quick-flow/{quick-spec → bmad-quick-spec}/steps/step-04-review.md +4 -7
  182. package/src/bmm/workflows/bmad-quick-flow/{quick-spec → bmad-quick-spec}/workflow.md +1 -6
  183. package/src/core/module-help.csv +1 -0
  184. package/src/core/skills/bmad-advanced-elicitation/SKILL.md +6 -0
  185. package/src/core/skills/bmad-advanced-elicitation/bmad-skill-manifest.yaml +1 -0
  186. package/src/core/{tasks → skills}/bmad-advanced-elicitation/workflow.md +3 -4
  187. package/src/core/{workflows → skills}/bmad-brainstorming/SKILL.md +1 -1
  188. package/src/core/skills/bmad-brainstorming/bmad-skill-manifest.yaml +1 -0
  189. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-01-session-setup.md +5 -1
  190. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-01b-continue.md +3 -1
  191. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-02a-user-selected.md +5 -1
  192. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-02b-ai-recommended.md +3 -1
  193. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-02c-random-selection.md +3 -1
  194. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-02d-progressive-flow.md +3 -1
  195. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-03-technique-execution.md +4 -2
  196. package/src/core/{workflows → skills}/bmad-brainstorming/steps/step-04-idea-organization.md +2 -0
  197. package/src/core/{workflows → skills}/bmad-brainstorming/workflow.md +1 -5
  198. package/src/core/skills/bmad-distillator/SKILL.md +178 -0
  199. package/src/core/skills/bmad-distillator/agents/distillate-compressor.md +116 -0
  200. package/src/core/skills/bmad-distillator/agents/round-trip-reconstructor.md +68 -0
  201. package/src/core/skills/bmad-distillator/bmad-skill-manifest.yaml +15 -0
  202. package/src/core/skills/bmad-distillator/resources/compression-rules.md +51 -0
  203. package/src/core/skills/bmad-distillator/resources/distillate-format-reference.md +227 -0
  204. package/src/core/skills/bmad-distillator/resources/splitting-strategy.md +78 -0
  205. package/src/core/skills/bmad-distillator/scripts/analyze_sources.py +300 -0
  206. package/src/core/skills/bmad-distillator/scripts/tests/test_analyze_sources.py +204 -0
  207. package/src/core/{tasks → skills}/bmad-editorial-review-prose/SKILL.md +1 -1
  208. package/src/core/skills/bmad-editorial-review-prose/bmad-skill-manifest.yaml +1 -0
  209. package/src/core/{tasks → skills}/bmad-editorial-review-structure/SKILL.md +1 -1
  210. package/src/core/skills/bmad-editorial-review-structure/bmad-skill-manifest.yaml +1 -0
  211. package/src/core/skills/bmad-help/SKILL.md +6 -0
  212. package/src/core/skills/bmad-help/bmad-skill-manifest.yaml +1 -0
  213. package/src/core/{tasks → skills}/bmad-index-docs/SKILL.md +1 -1
  214. package/src/core/skills/bmad-index-docs/bmad-skill-manifest.yaml +1 -0
  215. package/src/core/{workflows → skills}/bmad-party-mode/SKILL.md +1 -1
  216. package/src/core/skills/bmad-party-mode/bmad-skill-manifest.yaml +1 -0
  217. package/src/core/{tasks → skills}/bmad-review-adversarial-general/SKILL.md +1 -1
  218. package/src/core/skills/bmad-review-adversarial-general/bmad-skill-manifest.yaml +1 -0
  219. package/src/core/{tasks → skills}/bmad-review-edge-case-hunter/SKILL.md +2 -2
  220. package/src/core/skills/bmad-review-edge-case-hunter/bmad-skill-manifest.yaml +1 -0
  221. package/src/core/{tasks → skills}/bmad-shard-doc/SKILL.md +1 -1
  222. package/src/core/skills/bmad-shard-doc/bmad-skill-manifest.yaml +1 -0
  223. package/src/core/tasks/bmad-create-prd/SKILL.md +6 -0
  224. package/src/core/tasks/bmad-create-prd/bmad-skill-manifest.yaml +1 -0
  225. package/src/core/tasks/bmad-create-prd/data/domain-complexity.csv +15 -0
  226. package/src/core/tasks/bmad-create-prd/data/prd-purpose.md +197 -0
  227. package/src/core/tasks/bmad-create-prd/data/project-types.csv +11 -0
  228. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-01-init.md +7 -20
  229. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-01b-continue.md +29 -20
  230. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-02-discovery.md +7 -23
  231. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-02b-vision.md +5 -17
  232. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-02c-executive-summary.md +5 -17
  233. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-03-success.md +5 -17
  234. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-04-journeys.md +5 -17
  235. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-05-domain.md +7 -20
  236. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-06-innovation.md +8 -23
  237. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-07-project-type.md +6 -21
  238. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-08-scoping.md +5 -17
  239. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-09-functional.md +5 -17
  240. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-10-nonfunctional.md +5 -17
  241. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-11-polish.md +6 -19
  242. package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/steps-c/step-12-complete.md +3 -12
  243. package/src/{bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md → core/tasks/bmad-create-prd/workflow.md} +3 -4
  244. package/tools/cli/external-official-modules.yaml +9 -9
  245. package/tools/cli/installers/lib/core/manifest.js +4 -2
  246. package/tools/skill-validator.md +322 -0
  247. package/src/bmm/workflows/1-analysis/research/bmad-skill-manifest.yaml +0 -9
  248. package/src/bmm/workflows/2-plan-workflows/create-prd/bmad-skill-manifest.yaml +0 -14
  249. package/src/bmm/workflows/3-solutioning/check-implementation-readiness/bmad-skill-manifest.yaml +0 -3
  250. package/src/bmm/workflows/3-solutioning/create-epics-and-stories/bmad-skill-manifest.yaml +0 -3
  251. package/src/bmm/workflows/4-implementation/code-review/bmad-skill-manifest.yaml +0 -3
  252. package/src/bmm/workflows/4-implementation/code-review/checklist.md +0 -23
  253. package/src/bmm/workflows/4-implementation/code-review/discover-inputs.md +0 -88
  254. package/src/bmm/workflows/4-implementation/code-review/workflow.md +0 -268
  255. package/src/bmm/workflows/4-implementation/correct-course/bmad-skill-manifest.yaml +0 -3
  256. package/src/bmm/workflows/4-implementation/retrospective/bmad-skill-manifest.yaml +0 -3
  257. package/src/bmm/workflows/4-implementation/sprint-planning/bmad-skill-manifest.yaml +0 -3
  258. package/src/bmm/workflows/4-implementation/sprint-status/bmad-skill-manifest.yaml +0 -3
  259. package/src/bmm/workflows/bmad-quick-flow/quick-spec/bmad-skill-manifest.yaml +0 -3
  260. package/src/bmm/workflows/document-project/bmad-skill-manifest.yaml +0 -3
  261. package/src/bmm/workflows/document-project/workflow.md +0 -39
  262. package/src/bmm/workflows/generate-project-context/bmad-skill-manifest.yaml +0 -3
  263. package/src/bmm/workflows/qa-generate-e2e-tests/bmad-skill-manifest.yaml +0 -3
  264. package/src/core/agents/bmad-master.agent.yaml +0 -30
  265. package/src/core/agents/bmad-skill-manifest.yaml +0 -3
  266. package/src/core/tasks/bmad-advanced-elicitation/SKILL.md +0 -6
  267. package/src/core/tasks/bmad-help/SKILL.md +0 -6
  268. /package/src/{core/tasks/bmad-advanced-elicitation → bmm/workflows/1-analysis/bmad-product-brief-preview}/bmad-skill-manifest.yaml +0 -0
  269. /package/src/{core/tasks/bmad-editorial-review-prose → bmm/workflows/1-analysis/research/bmad-market-research}/bmad-skill-manifest.yaml +0 -0
  270. /package/src/{core/tasks/bmad-editorial-review-structure → bmm/workflows/1-analysis/research/bmad-technical-research}/bmad-skill-manifest.yaml +0 -0
  271. /package/src/bmm/workflows/1-analysis/research/{technical-steps → bmad-technical-research/technical-steps}/step-06-research-synthesis.md +0 -0
  272. /package/src/{core/tasks/bmad-help → bmm/workflows/2-plan-workflows/bmad-edit-prd}/bmad-skill-manifest.yaml +0 -0
  273. /package/src/{core/tasks/bmad-index-docs → bmm/workflows/2-plan-workflows/bmad-validate-prd}/bmad-skill-manifest.yaml +0 -0
  274. /package/src/{core/tasks/bmad-review-adversarial-general → bmm/workflows/3-solutioning/bmad-check-implementation-readiness}/bmad-skill-manifest.yaml +0 -0
  275. /package/src/bmm/workflows/3-solutioning/{check-implementation-readiness → bmad-check-implementation-readiness}/templates/readiness-report-template.md +0 -0
  276. /package/src/{core/tasks/bmad-review-edge-case-hunter → bmm/workflows/3-solutioning/bmad-create-epics-and-stories}/bmad-skill-manifest.yaml +0 -0
  277. /package/src/bmm/workflows/3-solutioning/{create-epics-and-stories → bmad-create-epics-and-stories}/templates/epics-template.md +0 -0
  278. /package/src/{core/tasks/bmad-shard-doc → bmm/workflows/4-implementation/bmad-code-review}/bmad-skill-manifest.yaml +0 -0
  279. /package/src/{core/workflows/bmad-brainstorming → bmm/workflows/4-implementation/bmad-correct-course}/bmad-skill-manifest.yaml +0 -0
  280. /package/src/{core/workflows/bmad-party-mode → bmm/workflows/4-implementation/bmad-retrospective}/bmad-skill-manifest.yaml +0 -0
  281. /package/src/bmm/workflows/4-implementation/{sprint-planning → bmad-sprint-planning}/checklist.md +0 -0
  282. /package/src/bmm/workflows/4-implementation/{sprint-planning → bmad-sprint-planning}/sprint-status-template.yaml +0 -0
  283. /package/src/bmm/workflows/{document-project → bmad-document-project}/checklist.md +0 -0
  284. /package/src/bmm/workflows/{document-project → bmad-document-project}/documentation-requirements.csv +0 -0
  285. /package/src/bmm/workflows/{document-project → bmad-document-project}/templates/deep-dive-template.md +0 -0
  286. /package/src/bmm/workflows/{document-project → bmad-document-project}/templates/index-template.md +0 -0
  287. /package/src/bmm/workflows/{document-project → bmad-document-project}/templates/project-overview-template.md +0 -0
  288. /package/src/bmm/workflows/{document-project → bmad-document-project}/templates/project-scan-report-schema.json +0 -0
  289. /package/src/bmm/workflows/{document-project → bmad-document-project}/templates/source-tree-template.md +0 -0
  290. /package/src/bmm/workflows/{generate-project-context → bmad-generate-project-context}/project-context-template.md +0 -0
  291. /package/src/bmm/workflows/{generate-project-context → bmad-generate-project-context}/steps/step-03-complete.md +0 -0
  292. /package/src/bmm/workflows/{qa-generate-e2e-tests → bmad-qa-generate-e2e-tests}/checklist.md +0 -0
  293. /package/src/bmm/workflows/bmad-quick-flow/{quick-spec → bmad-quick-spec}/tech-spec-template.md +0 -0
  294. /package/src/core/{tasks → skills}/bmad-advanced-elicitation/methods.csv +0 -0
  295. /package/src/core/{workflows → skills}/bmad-brainstorming/brain-methods.csv +0 -0
  296. /package/src/core/{workflows → skills}/bmad-brainstorming/template.md +0 -0
  297. /package/src/core/{tasks → skills}/bmad-editorial-review-prose/workflow.md +0 -0
  298. /package/src/core/{tasks → skills}/bmad-editorial-review-structure/workflow.md +0 -0
  299. /package/src/core/{tasks → skills}/bmad-help/workflow.md +0 -0
  300. /package/src/core/{tasks → skills}/bmad-index-docs/workflow.md +0 -0
  301. /package/src/core/{workflows → skills}/bmad-party-mode/steps/step-01-agent-loading.md +0 -0
  302. /package/src/core/{workflows → skills}/bmad-party-mode/steps/step-02-discussion-orchestration.md +0 -0
  303. /package/src/core/{workflows → skills}/bmad-party-mode/steps/step-03-graceful-exit.md +0 -0
  304. /package/src/core/{workflows → skills}/bmad-party-mode/workflow.md +0 -0
  305. /package/src/core/{tasks → skills}/bmad-review-adversarial-general/workflow.md +0 -0
  306. /package/src/core/{tasks → skills}/bmad-review-edge-case-hunter/workflow.md +0 -0
  307. /package/src/core/{tasks → skills}/bmad-shard-doc/workflow.md +0 -0
  308. /package/src/{bmm/workflows/2-plan-workflows/create-prd → core/tasks/bmad-create-prd}/templates/prd-template.md +0 -0
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-correct-course
3
+ description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -1,6 +1,6 @@
1
1
  # Change Navigation Checklist
2
2
 
3
- <critical>This checklist is executed as part of: {project-root}/_bmad/bmm/workflows/4-implementation/correct-course/workflow.md</critical>
3
+ <critical>This checklist is executed as part of: ./workflow.md</critical>
4
4
  <critical>Work through each section systematically with the user, recording findings and impacts</critical>
5
5
 
6
6
  <checklist>
@@ -1,8 +1,3 @@
1
- ---
2
- name: correct-course
3
- description: 'Manage significant changes during sprint execution. Use when the user says "correct course" or "propose sprint change"'
4
- ---
5
-
6
1
  # Correct Course - Sprint Change Management Workflow
7
2
 
8
3
  **Goal:** Manage significant changes during sprint execution by analyzing impact across all project artifacts and producing a structured Sprint Change Proposal.
@@ -31,8 +26,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
31
26
 
32
27
  ### Paths
33
28
 
34
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/4-implementation/correct-course`
35
- - `checklist` = `{installed_path}/checklist.md`
36
29
  - `default_output_file` = `{planning_artifacts}/sprint-change-proposal-{date}.md`
37
30
 
38
31
  ### Input Files
@@ -48,7 +41,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
48
41
 
49
42
  ### Context
50
43
 
51
- - `project_context` = `**/project-context.md` (load if exists)
44
+ - Load `**/project-context.md` if it exists
52
45
 
53
46
  ---
54
47
 
@@ -82,7 +75,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
82
75
  <workflow>
83
76
 
84
77
  <step n="1" goal="Initialize Change Navigation">
85
- <action>Load {project_context} for coding standards and project-wide patterns (if exists)</action>
78
+ <action>Load **/project-context.md for coding standards and project-wide patterns (if exists)</action>
86
79
  <action>Confirm change trigger and gather user description of the issue</action>
87
80
  <action>Ask: "What specific issue or change has been identified that requires navigation?"</action>
88
81
  <action>Verify access to required project documents:</action>
@@ -101,7 +94,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
101
94
  </step>
102
95
 
103
96
  <step n="2" goal="Execute Change Analysis Checklist">
104
- <action>Read fully and follow the systematic analysis from: {checklist}</action>
97
+ <action>Read fully and follow the systematic analysis from: checklist.md</action>
105
98
  <action>Work through each checklist section interactively with the user</action>
106
99
  <action>Record status for each checklist item:</action>
107
100
  - [x] Done - Item completed successfully
@@ -3,4 +3,4 @@ name: bmad-create-story
3
3
  description: 'Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -36,7 +36,7 @@ This is a COMPETITION to create the **ULTIMATE story context** that makes LLM de
36
36
  - The workflow framework will automatically:
37
37
  - Load this checklist file
38
38
  - Load the newly created story file (`{story_file_path}`)
39
- - Load workflow variables from `{installed_path}/workflow.md`
39
+ - Load workflow variables from `./workflow.md`
40
40
  - Execute the validation process
41
41
 
42
42
  ### **When Running in Fresh Context:**
@@ -61,7 +61,7 @@ You will systematically re-do the entire story creation process, but with a crit
61
61
 
62
62
  ### **Step 1: Load and Understand the Target**
63
63
 
64
- 1. **Load the workflow configuration**: `{installed_path}/workflow.md` for variable inclusion
64
+ 1. **Load the workflow configuration**: `./workflow.md` for variable inclusion
65
65
  2. **Load the story file**: `{story_file_path}` (provided by user or discovered)
66
66
  3. **Extract metadata**: epic_num, story_num, story_key, story_title from story file
67
67
  4. **Resolve all workflow variables**: implementation_artifacts, epics_file, architecture_file, etc.
@@ -1,8 +1,3 @@
1
- ---
2
- name: bmad-create-story
3
- description: 'Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"'
4
- ---
5
-
6
1
  # Create Story Workflow
7
2
 
8
3
  **Goal:** Create a comprehensive story file that gives the dev agent everything needed for flawless implementation.
@@ -32,9 +27,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
32
27
 
33
28
  ### Paths
34
29
 
35
- - `installed_path` = `.`
36
- - `template` = `./template.md`
37
- - `validation` = `./checklist.md`
38
30
  - `sprint_status` = `{implementation_artifacts}/sprint-status.yaml`
39
31
  - `epics_file` = `{planning_artifacts}/epics.md`
40
32
  - `prd_file` = `{planning_artifacts}/prd.md`
@@ -217,10 +209,10 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
217
209
  </step>
218
210
 
219
211
  <step n="2" goal="Load and analyze core artifacts">
220
- <critical>🔬 EXHAUSTIVE ARTIFACT ANALYSIS - This is where you prevent future developer fuckups!</critical>
212
+ <critical>🔬 EXHAUSTIVE ARTIFACT ANALYSIS - This is where you prevent future developer mistakes!</critical>
221
213
 
222
214
  <!-- Load all available content through discovery protocol -->
223
- <action>Read fully and follow `{installed_path}/discover-inputs.md` to load all input files</action>
215
+ <action>Read fully and follow `./discover-inputs.md` to load all input files</action>
224
216
  <note>Available content: {epics_content}, {prd_content}, {architecture_content}, {ux_content},
225
217
  {project_context}</note>
226
218
 
@@ -352,7 +344,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
352
344
  </step>
353
345
 
354
346
  <step n="6" goal="Update sprint status and finalize">
355
- <action>Validate the newly created story file {story_file} against {installed_path}/checklist.md and apply any required fixes before finalizing</action>
347
+ <action>Validate the newly created story file {default_output_file} against `./checklist.md` and apply any required fixes before finalizing</action>
356
348
  <action>Save story document unconditionally</action>
357
349
 
358
350
  <!-- Update sprint status -->
@@ -3,4 +3,4 @@ name: bmad-dev-story
3
3
  description: 'Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -27,7 +27,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
27
27
 
28
28
  ### Paths
29
29
 
30
- - `validation` = `./checklist.md`
31
30
  - `story_file` = `` (explicit story path; auto-discovered if empty)
32
31
  - `sprint_status` = `{implementation_artifacts}/sprint-status.yaml`
33
32
 
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-retrospective
3
+ description: 'Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -1,8 +1,3 @@
1
- ---
2
- name: retrospective
3
- description: 'Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"'
4
- ---
5
-
6
1
  # Retrospective Workflow
7
2
 
8
3
  **Goal:** Post-epic review to extract lessons and assess success.
@@ -42,7 +37,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
42
37
 
43
38
  ### Paths
44
39
 
45
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/4-implementation/retrospective`
46
40
  - `sprint_status_file` = `{implementation_artifacts}/sprint-status.yaml`
47
41
 
48
42
  ### Input Files
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-sprint-planning
3
+ description: 'Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -1,8 +1,3 @@
1
- ---
2
- name: sprint-planning
3
- description: 'Generate sprint status tracking from epics. Use when the user says "run sprint planning" or "generate sprint plan"'
4
- ---
5
-
6
1
  # Sprint Planning Workflow
7
2
 
8
3
  **Goal:** Generate sprint status tracking from epics, detecting current story statuses and building a complete sprint-status.yaml file.
@@ -26,9 +21,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
26
21
 
27
22
  ### Paths
28
23
 
29
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning`
30
- - `template` = `{installed_path}/sprint-status-template.yaml`
31
- - `checklist` = `{installed_path}/checklist.md`
32
24
  - `tracking_system` = `file-system`
33
25
  - `project_key` = `NOKEY`
34
26
  - `story_location` = `{implementation_artifacts}`
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-sprint-status
3
+ description: 'Summarize sprint status and surface risks. Use when the user says "check sprint status" or "show sprint status"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -1,8 +1,3 @@
1
- ---
2
- name: sprint-status
3
- description: 'Summarize sprint status and surface risks. Use when the user says "check sprint status" or "show sprint status"'
4
- ---
5
-
6
1
  # Sprint Status Workflow
7
2
 
8
3
  **Goal:** Summarize sprint status, surface risks, and recommend the next workflow action.
@@ -25,7 +20,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
25
20
 
26
21
  ### Paths
27
22
 
28
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/4-implementation/sprint-status`
29
23
  - `sprint_status_file` = `{implementation_artifacts}/sprint-status.yaml`
30
24
 
31
25
  ### Input Files
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-document-project
3
+ description: 'Document brownfield projects for AI context. Use when the user says "document this project" or "generate project docs"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -40,18 +40,18 @@
40
40
  <action>Load cached project_type_id(s) from state file</action>
41
41
 
42
42
  <critical>CONDITIONAL CSV LOADING FOR RESUME:</critical>
43
- <action>For each cached project_type_id, load ONLY the corresponding row from: {documentation_requirements_csv}</action>
43
+ <action>For each cached project_type_id, load ONLY the corresponding row from: ./documentation-requirements.csv</action>
44
44
  <action>Skip loading project-types.csv and architecture_registry.csv (not needed on resume)</action>
45
45
  <action>Store loaded doc requirements for use in remaining steps</action>
46
46
 
47
47
  <action>Display: "Resuming {{workflow_mode}} from {{current_step}} with cached project type(s): {{cached_project_types}}"</action>
48
48
 
49
49
  <check if="workflow_mode == deep_dive">
50
- <action>Read fully and follow: {installed_path}/workflows/deep-dive-workflow.md with resume context</action>
50
+ <action>Read fully and follow: ./workflows/deep-dive-workflow.md with resume context</action>
51
51
  </check>
52
52
 
53
53
  <check if="workflow_mode == initial_scan OR workflow_mode == full_rescan">
54
- <action>Read fully and follow: {installed_path}/workflows/full-scan-workflow.md with resume context</action>
54
+ <action>Read fully and follow: ./workflows/full-scan-workflow.md with resume context</action>
55
55
  </check>
56
56
 
57
57
  </check>
@@ -98,7 +98,7 @@ Your choice [1/2/3]:
98
98
  <check if="user selects 1">
99
99
  <action>Set workflow_mode = "full_rescan"</action>
100
100
  <action>Display: "Starting full project rescan..."</action>
101
- <action>Read fully and follow: {installed_path}/workflows/full-scan-workflow.md</action>
101
+ <action>Read fully and follow: ./workflows/full-scan-workflow.md</action>
102
102
  <action>After sub-workflow completes, continue to Step 4</action>
103
103
  </check>
104
104
 
@@ -106,7 +106,7 @@ Your choice [1/2/3]:
106
106
  <action>Set workflow_mode = "deep_dive"</action>
107
107
  <action>Set scan_level = "exhaustive"</action>
108
108
  <action>Display: "Starting deep-dive documentation mode..."</action>
109
- <action>Read fully and follow: {installed_path}/workflows/deep-dive-workflow.md</action>
109
+ <action>Read fully and follow: ./workflows/deep-dive-workflow.md</action>
110
110
  <action>After sub-workflow completes, continue to Step 4</action>
111
111
  </check>
112
112
 
@@ -119,7 +119,7 @@ Your choice [1/2/3]:
119
119
  <check if="index.md does not exist">
120
120
  <action>Set workflow_mode = "initial_scan"</action>
121
121
  <action>Display: "No existing documentation found. Starting initial project scan..."</action>
122
- <action>Read fully and follow: {installed_path}/workflows/full-scan-workflow.md</action>
122
+ <action>Read fully and follow: ./workflows/full-scan-workflow.md</action>
123
123
  <action>After sub-workflow completes, continue to Step 4</action>
124
124
  </check>
125
125
 
@@ -0,0 +1,27 @@
1
+ # Document Project Workflow
2
+
3
+ **Goal:** Document brownfield projects for AI context.
4
+
5
+ **Your Role:** Project documentation specialist.
6
+ - Communicate all responses in {communication_language}
7
+
8
+ ---
9
+
10
+ ## INITIALIZATION
11
+
12
+ ### Configuration Loading
13
+
14
+ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
15
+
16
+ - `project_knowledge`
17
+ - `user_name`
18
+ - `communication_language`
19
+ - `document_output_language`
20
+ - `user_skill_level`
21
+ - `date` as system-generated current datetime
22
+
23
+ ---
24
+
25
+ ## EXECUTION
26
+
27
+ Read fully and follow: `./instructions.md`
@@ -4,6 +4,8 @@
4
4
 
5
5
  <critical>This workflow performs exhaustive deep-dive documentation of specific areas</critical>
6
6
  <critical>Handles: deep_dive mode only</critical>
7
+ <critical>YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`</critical>
8
+ <critical>YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`</critical>
7
9
 
8
10
  <step n="13" goal="Deep-dive documentation of specific area" if="workflow_mode == deep_dive">
9
11
  <critical>Deep-dive mode requires literal full-file review. Sampling, guessing, or relying solely on tooling output is FORBIDDEN.</critical>
@@ -191,7 +193,7 @@ This will read EVERY file in this area. Proceed? [y/n]
191
193
  - Combine recommended test commands into {{suggested_tests}}
192
194
  </action>
193
195
 
194
- <action>Load complete deep-dive template from: {installed_path}/templates/deep-dive-template.md</action>
196
+ <action>Load complete deep-dive template from: ../templates/deep-dive-template.md</action>
195
197
  <action>Fill template with all collected data from steps 13b-13d</action>
196
198
  <action>Write filled template to: {project_knowledge}/deep-dive-{{sanitized_target_name}}.md</action>
197
199
  <action>Validate deep-dive document completeness</action>
@@ -1,8 +1,3 @@
1
- ---
2
- name: document-project-deep-dive
3
- description: 'Exhaustive deep-dive documentation of specific project areas'
4
- ---
5
-
6
1
  # Deep-Dive Documentation Sub-Workflow
7
2
 
8
3
  **Goal:** Exhaustive deep-dive documentation of specific project areas.
@@ -20,14 +15,11 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
20
15
 
21
16
  - `project_knowledge`
22
17
  - `user_name`
18
+ - `communication_language`, `document_output_language`
23
19
  - `date` as system-generated current datetime
24
20
 
25
- ### Paths
26
-
27
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/document-project/workflows`
28
- - `instructions` = `{installed_path}/deep-dive-instructions.md`
29
- - `validation` = `{project-root}/_bmad/bmm/workflows/document-project/checklist.md`
30
- - `deep_dive_template` = `{project-root}/_bmad/bmm/workflows/document-project/templates/deep-dive-template.md`
21
+ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
22
+ ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`.
31
23
 
32
24
  ### Runtime Inputs
33
25
 
@@ -39,4 +31,4 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
39
31
 
40
32
  ## EXECUTION
41
33
 
42
- Read fully and follow: `{installed_path}/deep-dive-instructions.md`
34
+ Read fully and follow: `./deep-dive-instructions.md`
@@ -4,6 +4,8 @@
4
4
 
5
5
  <critical>This workflow performs complete project documentation (Steps 1-12)</critical>
6
6
  <critical>Handles: initial_scan and full_rescan modes</critical>
7
+ <critical>YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`</critical>
8
+ <critical>YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`</critical>
7
9
 
8
10
  <step n="0.5" goal="Load documentation requirements data for fresh starts (not needed for resume)" if="resume_mode == false">
9
11
  <critical>DATA LOADING STRATEGY - Understanding the Documentation Requirements System:</critical>
@@ -14,7 +16,7 @@
14
16
 
15
17
  This workflow uses a single comprehensive CSV file to intelligently document your project:
16
18
 
17
- **documentation-requirements.csv** ({documentation_requirements_csv})
19
+ **documentation-requirements.csv** (../documentation-requirements.csv)
18
20
 
19
21
  - Contains 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded)
20
22
  - 24-column schema combining project type detection AND documentation requirements
@@ -34,7 +36,7 @@ This workflow uses a single comprehensive CSV file to intelligently document you
34
36
 
35
37
  <action>Now loading documentation requirements data for fresh start...</action>
36
38
 
37
- <action>Load documentation-requirements.csv from: {documentation_requirements_csv}</action>
39
+ <action>Load documentation-requirements.csv from: ../documentation-requirements.csv</action>
38
40
  <action>Store all 12 rows indexed by project_type_id for project detection and requirements lookup</action>
39
41
  <action>Display: "Loaded documentation requirements for 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded)"</action>
40
42
 
@@ -808,7 +810,7 @@ Generated in {{project_knowledge}}/:
808
810
  {{file_list_with_sizes}}
809
811
  </action>
810
812
 
811
- <action>Run validation checklist from {validation}</action>
813
+ <action>Run validation checklist from ../checklist.md</action>
812
814
 
813
815
  <critical>INCOMPLETE DOCUMENTATION DETECTION:
814
816
 
@@ -1,8 +1,3 @@
1
- ---
2
- name: document-project-full-scan
3
- description: 'Complete project documentation workflow (initial scan or full rescan)'
4
- ---
5
-
6
1
  # Full Project Scan Sub-Workflow
7
2
 
8
3
  **Goal:** Complete project documentation (initial scan or full rescan).
@@ -19,14 +14,11 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
19
14
 
20
15
  - `project_knowledge`
21
16
  - `user_name`
17
+ - `communication_language`, `document_output_language`
22
18
  - `date` as system-generated current datetime
23
19
 
24
- ### Paths
25
-
26
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/document-project/workflows`
27
- - `instructions` = `{installed_path}/full-scan-instructions.md`
28
- - `validation` = `{project-root}/_bmad/bmm/workflows/document-project/checklist.md`
29
- - `documentation_requirements_csv` = `{project-root}/_bmad/bmm/workflows/document-project/documentation-requirements.csv`
20
+ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the configured `{communication_language}`.
21
+ ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`.
30
22
 
31
23
  ### Runtime Inputs
32
24
 
@@ -39,4 +31,4 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
39
31
 
40
32
  ## EXECUTION
41
33
 
42
- Read fully and follow: `{installed_path}/full-scan-instructions.md`
34
+ Read fully and follow: `./full-scan-instructions.md`
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-generate-project-context
3
+ description: 'Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -123,7 +123,7 @@ Based on discovery, create or update the context document:
123
123
 
124
124
  #### A. Fresh Document Setup (if no existing context)
125
125
 
126
- Copy template from `{installed_path}/project-context-template.md` to `{output_folder}/project-context.md`
126
+ Copy template from `../project-context-template.md` to `{output_folder}/project-context.md`
127
127
  Initialize frontmatter fields.
128
128
 
129
129
  #### B. Existing Document Update
@@ -160,6 +160,8 @@ Ready to create/update your project context. This will help AI agents implement
160
160
 
161
161
  [C] Continue to context generation"
162
162
 
163
+ **HALT — wait for user selection before proceeding.**
164
+
163
165
  ## SUCCESS METRICS:
164
166
 
165
167
  ✅ Existing project context properly detected and handled
@@ -179,6 +181,6 @@ Ready to create/update your project context. This will help AI agents implement
179
181
 
180
182
  ## NEXT STEP:
181
183
 
182
- After user selects [C] to continue, load `{project-root}/_bmad/bmm/workflows/generate-project-context/steps/step-02-generate.md` to collaboratively generate the specific project context rules.
184
+ After user selects [C] to continue, load `./step-02-generate.md` to collaboratively generate the specific project context rules.
183
185
 
184
186
  Remember: Do NOT proceed to step-02 until user explicitly selects [C] from the menu and discovery is confirmed and the initial file has been written as directed in this discovery step!
@@ -9,6 +9,7 @@
9
9
  - 🎯 KEEP CONTENT LEAN - optimize for LLM context efficiency
10
10
  - ⚠️ ABSOLUTELY NO TIME ESTIMATES - AI development speed has fundamentally changed
11
11
  - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
12
+ - ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`
12
13
 
13
14
  ## EXECUTION PROTOCOLS:
14
15
 
@@ -29,8 +30,8 @@ This step will generate content and present choices for each rule category:
29
30
 
30
31
  ## PROTOCOL INTEGRATION:
31
32
 
32
- - When 'A' selected: Execute skill:bmad-advanced-elicitation
33
- - When 'P' selected: Execute {project-root}/_bmad/core/workflows/bmad-party-mode/workflow.md
33
+ - When 'A' selected: Invoke the `bmad-advanced-elicitation` skill
34
+ - When 'P' selected: Invoke the `bmad-party-mode` skill
34
35
  - PROTOCOLS always return to display this step's A/P/C menu after the A or P have completed
35
36
  - User accepts/rejects protocol changes before proceeding
36
37
 
@@ -263,11 +264,13 @@ After each category, show the generated rules and present choices:
263
264
  [P] Party Mode - Review from different implementation perspectives
264
265
  [C] Continue - Save these rules and move to next category"
265
266
 
267
+ **HALT — wait for user selection before proceeding.**
268
+
266
269
  ### 10. Handle Menu Selection
267
270
 
268
271
  #### If 'A' (Advanced Elicitation):
269
272
 
270
- - Execute skill:bmad-advanced-elicitation with current category rules
273
+ - Invoke the `bmad-advanced-elicitation` skill with current category rules
271
274
  - Process enhanced rules that come back
272
275
  - Ask user: "Accept these enhanced rules for {{category}}? (y/n)"
273
276
  - If yes: Update content, then return to A/P/C menu
@@ -275,7 +278,7 @@ After each category, show the generated rules and present choices:
275
278
 
276
279
  #### If 'P' (Party Mode):
277
280
 
278
- - Execute party-mode workflow with category rules context
281
+ - Invoke the `bmad-party-mode` skill with category rules context
279
282
  - Process collaborative insights on implementation patterns
280
283
  - Ask user: "Accept these changes to {{category}} rules? (y/n)"
281
284
  - If yes: Update content, then return to A/P/C menu
@@ -313,6 +316,6 @@ When user selects 'C' for a category, append the content directly to `{output_fo
313
316
 
314
317
  ## NEXT STEP:
315
318
 
316
- After completing all rule categories and user selects 'C' for the final category, load `{project-root}/_bmad/bmm/workflows/generate-project-context/steps/step-03-complete.md` to finalize the project context file.
319
+ After completing all rule categories and user selects 'C' for the final category, load `./step-03-complete.md` to finalize the project context file.
317
320
 
318
321
  Remember: Do NOT proceed to step-03 until all categories are complete and user explicitly selects 'C' for each!
@@ -1,8 +1,3 @@
1
- ---
2
- name: generate-project-context
3
- description: 'Create project-context.md with AI rules. Use when the user says "generate project context" or "create project context"'
4
- ---
5
-
6
1
  # Generate Project Context Workflow
7
2
 
8
3
  **Goal:** Create a concise, optimized `project-context.md` file containing critical rules, patterns, and guidelines that AI agents must follow when implementing code. This file focuses on unobvious details that LLMs need to be reminded of.
@@ -33,17 +28,16 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
33
28
  - `communication_language`, `document_output_language`, `user_skill_level`
34
29
  - `date` as system-generated current datetime
35
30
  - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
31
+ - ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`
36
32
 
37
33
  ### Paths
38
34
 
39
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/generate-project-context`
40
- - `template_path` = `{installed_path}/project-context-template.md`
41
35
  - `output_file` = `{output_folder}/project-context.md`
42
36
 
43
37
  ---
44
38
 
45
39
  ## EXECUTION
46
40
 
47
- Load and execute `{project-root}/_bmad/bmm/workflows/generate-project-context/steps/step-01-discover.md` to begin the workflow.
41
+ Load and execute `./steps/step-01-discover.md` to begin the workflow.
48
42
 
49
43
  **Note:** Input document discovery and initialization protocols are handled in step-01-discover.md.
@@ -0,0 +1,6 @@
1
+ ---
2
+ name: bmad-qa-generate-e2e-tests
3
+ description: 'Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"'
4
+ ---
5
+
6
+ Follow the instructions in ./workflow.md.
@@ -1,13 +1,8 @@
1
- ---
2
- name: qa-generate-e2e-tests
3
- description: 'Generate end to end automated tests for existing features. Use when the user says "create qa automated tests for [feature]"'
4
- ---
5
-
6
1
  # QA Generate E2E Tests Workflow
7
2
 
8
3
  **Goal:** Generate automated API and E2E tests for implemented code.
9
4
 
10
- **Your Role:** You are a QA automation engineer. You generate tests ONLY — no code review or story validation (use Code Review `CR` for that).
5
+ **Your Role:** You are a QA automation engineer. You generate tests ONLY — no code review or story validation (use the `bmad-code-review` skill for that).
11
6
 
12
7
  ---
13
8
 
@@ -25,8 +20,6 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
25
20
 
26
21
  ### Paths
27
22
 
28
- - `installed_path` = `{project-root}/_bmad/bmm/workflows/qa-generate-e2e-tests`
29
- - `checklist` = `{installed_path}/checklist.md`
30
23
  - `test_dir` = `{project-root}/tests`
31
24
  - `source_dir` = `{project-root}`
32
25
  - `default_output_file` = `{implementation_artifacts}/tests/test-summary.md`
@@ -140,4 +133,4 @@ If the project needs:
140
133
 
141
134
  Save summary to: `{default_output_file}`
142
135
 
143
- **Done!** Tests generated and verified. Validate against `{checklist}`.
136
+ **Done!** Tests generated and verified. Validate against `./checklist.md`.
@@ -3,4 +3,4 @@ name: bmad-quick-dev
3
3
  description: 'Implement a Quick Tech Spec for small changes or features. Use when the user provides a quick tech spec and says "implement this quick spec" or "proceed with implementation of [quick tech spec]"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.