bmad-method 6.1.1-next.40 → 6.1.1-next.42

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 (89) hide show
  1. package/package.json +1 -1
  2. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/SKILL.md +1 -1
  3. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-02-vision.md +2 -5
  4. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-03-users.md +2 -5
  5. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-04-metrics.md +2 -5
  6. package/src/bmm/workflows/1-analysis/bmad-create-product-brief/steps/step-05-scope.md +2 -5
  7. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/contextual-discovery.md +7 -7
  8. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/draft-and-review.md +5 -5
  9. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/finalize.md +1 -1
  10. package/src/bmm/workflows/1-analysis/bmad-product-brief-preview/prompts/guided-elicitation.md +2 -2
  11. package/src/bmm/workflows/1-analysis/research/bmad-domain-research/SKILL.md +1 -1
  12. package/src/bmm/workflows/1-analysis/research/bmad-market-research/SKILL.md +1 -1
  13. package/src/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md +1 -1
  14. package/src/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md +1 -1
  15. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/SKILL.md +1 -1
  16. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01-discovery.md +2 -8
  17. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-01b-legacy-conversion.md +1 -5
  18. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-02-review.md +4 -9
  19. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-03-edit.md +2 -6
  20. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/steps-e/step-e-04-complete.md +1 -4
  21. package/src/bmm/workflows/2-plan-workflows/bmad-edit-prd/workflow.md +1 -2
  22. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/SKILL.md +1 -1
  23. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-01-discovery.md +2 -7
  24. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02-format-detection.md +0 -3
  25. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-02b-parity-check.md +0 -3
  26. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-03-density-validation.md +0 -3
  27. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-04-brief-coverage-validation.md +0 -3
  28. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-05-measurability-validation.md +0 -3
  29. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-06-traceability-validation.md +0 -3
  30. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-07-implementation-leakage-validation.md +0 -3
  31. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-08-domain-compliance-validation.md +0 -3
  32. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-09-project-type-validation.md +0 -3
  33. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-10-smart-validation.md +0 -3
  34. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-11-holistic-quality-validation.md +2 -6
  35. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-12-completeness-validation.md +0 -3
  36. package/src/bmm/workflows/2-plan-workflows/bmad-validate-prd/steps-v/step-v-13-report-complete.md +2 -5
  37. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md +2 -4
  38. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-11-holistic-quality-validation.md +2 -3
  39. package/src/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-13-report-complete.md +1 -1
  40. package/src/bmm/workflows/3-solutioning/bmad-check-implementation-readiness/SKILL.md +1 -1
  41. package/src/bmm/workflows/3-solutioning/bmad-create-architecture/SKILL.md +1 -1
  42. package/src/bmm/workflows/3-solutioning/bmad-create-epics-and-stories/SKILL.md +1 -1
  43. package/src/bmm/workflows/4-implementation/bmad-code-review/SKILL.md +1 -1
  44. package/src/bmm/workflows/4-implementation/bmad-correct-course/SKILL.md +1 -1
  45. package/src/bmm/workflows/4-implementation/bmad-create-story/SKILL.md +1 -1
  46. package/src/bmm/workflows/4-implementation/bmad-create-story/workflow.md +1 -1
  47. package/src/bmm/workflows/4-implementation/bmad-dev-story/SKILL.md +1 -1
  48. package/src/bmm/workflows/4-implementation/bmad-retrospective/SKILL.md +1 -1
  49. package/src/bmm/workflows/4-implementation/bmad-sprint-planning/SKILL.md +1 -1
  50. package/src/bmm/workflows/4-implementation/bmad-sprint-status/SKILL.md +1 -1
  51. package/src/bmm/workflows/bmad-document-project/SKILL.md +1 -1
  52. package/src/bmm/workflows/bmad-generate-project-context/SKILL.md +1 -1
  53. package/src/bmm/workflows/bmad-generate-project-context/steps/step-01-discover.md +3 -1
  54. package/src/bmm/workflows/bmad-generate-project-context/steps/step-02-generate.md +6 -4
  55. package/src/bmm/workflows/bmad-qa-generate-e2e-tests/SKILL.md +1 -1
  56. package/src/bmm/workflows/bmad-qa-generate-e2e-tests/workflow.md +1 -1
  57. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/SKILL.md +1 -1
  58. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/steps/step-01-mode-detection.md +3 -3
  59. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev/workflow.md +0 -6
  60. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-dev-new-preview/SKILL.md +1 -1
  61. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/SKILL.md +1 -1
  62. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-01-understand.md +2 -2
  63. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-02-investigate.md +2 -2
  64. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/steps/step-04-review.md +4 -4
  65. package/src/bmm/workflows/bmad-quick-flow/bmad-quick-spec/workflow.md +0 -3
  66. package/src/core/skills/bmad-advanced-elicitation/SKILL.md +2 -2
  67. package/src/core/skills/bmad-advanced-elicitation/workflow.md +2 -2
  68. package/src/core/skills/bmad-brainstorming/SKILL.md +1 -1
  69. package/src/core/skills/bmad-brainstorming/steps/step-01-session-setup.md +4 -0
  70. package/src/core/skills/bmad-brainstorming/steps/step-01b-continue.md +3 -1
  71. package/src/core/skills/bmad-brainstorming/steps/step-02a-user-selected.md +5 -1
  72. package/src/core/skills/bmad-brainstorming/steps/step-02b-ai-recommended.md +3 -1
  73. package/src/core/skills/bmad-brainstorming/steps/step-02c-random-selection.md +3 -1
  74. package/src/core/skills/bmad-brainstorming/steps/step-02d-progressive-flow.md +3 -1
  75. package/src/core/skills/bmad-brainstorming/steps/step-03-technique-execution.md +4 -2
  76. package/src/core/skills/bmad-brainstorming/steps/step-04-idea-organization.md +2 -0
  77. package/src/core/skills/bmad-brainstorming/workflow.md +1 -3
  78. package/src/core/skills/bmad-distillator/agents/distillate-compressor.md +4 -4
  79. package/src/core/skills/bmad-editorial-review-prose/SKILL.md +1 -1
  80. package/src/core/skills/bmad-editorial-review-structure/SKILL.md +1 -1
  81. package/src/core/skills/bmad-help/SKILL.md +1 -1
  82. package/src/core/skills/bmad-index-docs/SKILL.md +1 -1
  83. package/src/core/skills/bmad-party-mode/SKILL.md +1 -1
  84. package/src/core/skills/bmad-review-adversarial-general/SKILL.md +1 -1
  85. package/src/core/skills/bmad-review-edge-case-hunter/SKILL.md +2 -2
  86. package/src/core/skills/bmad-shard-doc/SKILL.md +1 -1
  87. package/src/core/tasks/bmad-create-prd/SKILL.md +1 -1
  88. package/src/core/tasks/bmad-create-prd/steps-c/step-05-domain.md +1 -1
  89. package/tools/skill-validator.md +9 -1
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "bmad-method",
4
- "version": "6.1.1-next.40",
4
+ "version": "6.1.1-next.42",
5
5
  "description": "Breakthrough Method of Agile AI-driven Development",
6
6
  "keywords": [
7
7
  "agile",
@@ -3,4 +3,4 @@ name: bmad-create-product-brief
3
3
  description: 'Create product brief through collaborative discovery. Use when the user says "lets create a product brief" or "help me create a project brief"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 2: Product Vision Discovery
@@ -153,8 +150,8 @@ Prepare the following structure for document append:
153
150
 
154
151
  #### Menu Handling Logic:
155
152
 
156
- - IF A: Read fully and follow: {advancedElicitationTask} with current vision content to dive deeper and refine
157
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to positioning and differentiation
153
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current vision content to dive deeper and refine
154
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to positioning and differentiation
158
155
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2], then read fully and follow: ./step-03-users.md
159
156
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
160
157
 
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 3: Target Users Discovery
@@ -156,8 +153,8 @@ Prepare the following structure for document append:
156
153
 
157
154
  #### Menu Handling Logic:
158
155
 
159
- - IF A: Read fully and follow: {advancedElicitationTask} with current user content to dive deeper into personas and journeys
160
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to validate user understanding
156
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current user content to dive deeper into personas and journeys
157
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to validate user understanding
161
158
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2, 3], then read fully and follow: ./step-04-metrics.md
162
159
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)
163
160
 
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 4: Success Metrics Definition
@@ -159,8 +156,8 @@ Prepare the following structure for document append:
159
156
 
160
157
  #### Menu Handling Logic:
161
158
 
162
- - IF A: Read fully and follow: {advancedElicitationTask} with current metrics content to dive deeper into success metric insights
163
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to validate comprehensive metrics
159
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current metrics content to dive deeper into success metric insights
160
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to validate comprehensive metrics
164
161
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2, 3, 4], then read fully and follow: ./step-05-scope.md
165
162
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
166
163
 
@@ -2,9 +2,6 @@
2
2
  # File References
3
3
  outputFile: '{planning_artifacts}/product-brief-{{project_name}}-{{date}}.md'
4
4
 
5
- # Task References
6
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
7
- partyModeWorkflow: 'skill:bmad-party-mode'
8
5
  ---
9
6
 
10
7
  # Step 5: MVP Scope Definition
@@ -173,8 +170,8 @@ Prepare the following structure for document append:
173
170
 
174
171
  #### Menu Handling Logic:
175
172
 
176
- - IF A: Read fully and follow: {advancedElicitationTask} with current scope content to optimize scope definition
177
- - IF P: Read fully and follow: {partyModeWorkflow} to bring different perspectives to validate MVP scope
173
+ - IF A: Invoke the `bmad-advanced-elicitation` skill with current scope content to optimize scope definition
174
+ - IF P: Invoke the `bmad-party-mode` skill to bring different perspectives to validate MVP scope
178
175
  - IF C: Save content to {outputFile}, update frontmatter with stepsCompleted: [1, 2, 3, 4, 5], then read fully and follow: ./step-06-complete.md
179
176
  - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#7-present-menu-options)
180
177
 
@@ -12,9 +12,9 @@ Now that you know what the brief is about, fan out subagents in parallel to gath
12
12
 
13
13
  **Launch in parallel:**
14
14
 
15
- 1. **Artifact Analyzer** (`agents/artifact-analyzer.md`) — Scans `{planning_artifacts}` and `{project_knowledge}` for relevant documents. Also scans any specific paths the user provided. Returns structured synthesis of what it found.
15
+ 1. **Artifact Analyzer** (`../agents/artifact-analyzer.md`) — Scans `{planning_artifacts}` and `{project_knowledge}` for relevant documents. Also scans any specific paths the user provided. Returns structured synthesis of what it found.
16
16
 
17
- 2. **Web Researcher** (`agents/web-researcher.md`) — Searches for competitive landscape, market context, trends, and relevant industry data. Returns structured findings scoped to the product domain.
17
+ 2. **Web Researcher** (`../agents/web-researcher.md`) — Searches for competitive landscape, market context, trends, and relevant industry data. Returns structured findings scoped to the product domain.
18
18
 
19
19
  ### Graceful Degradation
20
20
 
@@ -38,20 +38,20 @@ Once subagent results return (or inline scanning completes):
38
38
  - Highlight anything surprising or worth discussing
39
39
  - Share the gaps you've identified
40
40
  - Ask: "Anything else you'd like to add, or shall we move on to filling in the details?"
41
- - Route to `prompts/guided-elicitation.md`
41
+ - Route to `guided-elicitation.md`
42
42
 
43
43
  **Yolo mode:**
44
44
  - Absorb all findings silently
45
- - Skip directly to `prompts/draft-and-review.md` — you have enough to draft
45
+ - Skip directly to `draft-and-review.md` — you have enough to draft
46
46
  - The user will refine later
47
47
 
48
48
  **Headless mode:**
49
49
  - Absorb all findings
50
- - Skip directly to `prompts/draft-and-review.md`
50
+ - Skip directly to `draft-and-review.md`
51
51
  - No interaction
52
52
 
53
53
  ## Stage Complete
54
54
 
55
55
  This stage is complete when subagent results (or inline scanning fallback) have returned and findings are merged with user context. Route per mode:
56
- - **Guided** → `prompts/guided-elicitation.md`
57
- - **Yolo / Headless** → `prompts/draft-and-review.md`
56
+ - **Guided** → `guided-elicitation.md`
57
+ - **Yolo / Headless** → `draft-and-review.md`
@@ -8,7 +8,7 @@
8
8
 
9
9
  ## Step 1: Draft the Executive Brief
10
10
 
11
- Use `resources/brief-template.md` as a guide — adapt structure to fit the product's story.
11
+ Use `../resources/brief-template.md` as a guide — adapt structure to fit the product's story.
12
12
 
13
13
  **Writing principles:**
14
14
  - **Executive audience** — persuasive, clear, concise. 1-2 pages.
@@ -36,9 +36,9 @@ Before showing the draft to the user, run it through multiple review lenses in p
36
36
 
37
37
  **Launch in parallel:**
38
38
 
39
- 1. **Skeptic Reviewer** (`agents/skeptic-reviewer.md`) — "What's missing? What assumptions are untested? What could go wrong? Where is the brief vague or hand-wavy?"
39
+ 1. **Skeptic Reviewer** (`../agents/skeptic-reviewer.md`) — "What's missing? What assumptions are untested? What could go wrong? Where is the brief vague or hand-wavy?"
40
40
 
41
- 2. **Opportunity Reviewer** (`agents/opportunity-reviewer.md`) — "What adjacent value propositions are being missed? What market angles or partnerships could strengthen this? What's underemphasized?"
41
+ 2. **Opportunity Reviewer** (`../agents/opportunity-reviewer.md`) — "What adjacent value propositions are being missed? What market angles or partnerships could strengthen this? What's underemphasized?"
42
42
 
43
43
  3. **Contextual Reviewer** — You (the main agent) pick the most useful third lens based on THIS specific product. Choose the lens that addresses the SINGLE BIGGEST RISK that the skeptic and opportunity reviewers won't naturally catch. Examples:
44
44
  - For healthtech: "Regulatory and compliance risk reviewer"
@@ -65,7 +65,7 @@ After all reviews complete:
65
65
 
66
66
  ## Step 4: Present to User
67
67
 
68
- **Headless mode:** Skip to `prompts/finalize.md` — no user interaction. Save the improved draft directly.
68
+ **Headless mode:** Skip to `finalize.md` — no user interaction. Save the improved draft directly.
69
69
 
70
70
  **Yolo and Guided modes:**
71
71
 
@@ -83,4 +83,4 @@ Present reviewer findings with brief rationale, then offer: "Want me to dig into
83
83
 
84
84
  ## Stage Complete
85
85
 
86
- This stage is complete when: (a) the draft has been reviewed by all three lenses and improvements integrated, AND either (autonomous) save and route directly, or (guided/yolo) the user is satisfied. Route to `prompts/finalize.md`.
86
+ This stage is complete when: (a) the draft has been reviewed by all three lenses and improvements integrated, AND either (autonomous) save and route directly, or (guided/yolo) the user is satisfied. Route to `finalize.md`.
@@ -72,4 +72,4 @@ purpose: "Token-efficient context for downstream PRD creation"
72
72
 
73
73
  ## Stage Complete
74
74
 
75
- This is the terminal stage. After delivering the completion message and file paths, the workflow is done. If the user requests further revisions, loop back to `prompts/draft-and-review.md`. Otherwise, exit.
75
+ This is the terminal stage. After delivering the completion message and file paths, the workflow is done. If the user requests further revisions, loop back to `draft-and-review.md`. Otherwise, exit.
@@ -5,7 +5,7 @@
5
5
 
6
6
  **Goal:** Fill the gaps in what you know. By now you have the user's brain dump, artifact analysis, and web research. This stage is about smart, targeted questioning — not rote section-by-section interrogation.
7
7
 
8
- **Skip this stage entirely in Yolo and Autonomous modes** — go directly to `prompts/draft-and-review.md`.
8
+ **Skip this stage entirely in Yolo and Autonomous modes** — go directly to `draft-and-review.md`.
9
9
 
10
10
  ## Approach
11
11
 
@@ -67,4 +67,4 @@ If the user is providing complete, confident answers and you have solid coverage
67
67
 
68
68
  ## Stage Complete
69
69
 
70
- This stage is complete when sufficient substance exists to draft a compelling brief and the user confirms readiness. Route to `prompts/draft-and-review.md`.
70
+ This stage is complete when sufficient substance exists to draft a compelling brief and the user confirms readiness. Route to `draft-and-review.md`.
@@ -3,4 +3,4 @@ name: bmad-domain-research
3
3
  description: 'Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -3,4 +3,4 @@ name: bmad-market-research
3
3
  description: 'Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -3,4 +3,4 @@ name: bmad-technical-research
3
3
  description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -3,4 +3,4 @@ name: bmad-create-ux-design
3
3
  description: 'Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -3,4 +3,4 @@ name: bmad-edit-prd
3
3
  description: 'Edit an existing PRD. Use when the user says "edit this PRD".'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -1,12 +1,6 @@
1
1
  ---
2
- name: 'step-e-01-discovery'
3
- description: 'Discovery & Understanding - Understand what user wants to edit and detect PRD format'
4
-
5
2
  # File references (ONLY variables used in this step)
6
- altStepFile: './step-e-01b-legacy-conversion.md'
7
3
  prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
8
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
9
- partyModeWorkflow: 'skill:bmad-party-mode'
10
4
  ---
11
5
 
12
6
  # Step E-1: Discovery & Understanding
@@ -190,7 +184,7 @@ Display: "**Edit Requirements Understood**
190
184
 
191
185
  **Proceeding to deep review and analysis...**"
192
186
 
193
- Read fully and follow: next step (step-e-02-review.md)
187
+ Read fully and follow: `./step-e-02-review.md`
194
188
 
195
189
  **IF PRD is Legacy (Non-Standard) AND no validation report:**
196
190
 
@@ -217,7 +211,7 @@ Present MENU OPTIONS below for user selection
217
211
 
218
212
  #### Menu Handling Logic:
219
213
 
220
- - IF C (Convert): Read fully and follow: {altStepFile} (step-e-01b-legacy-conversion.md)
214
+ - IF C (Convert): Read fully and follow: `./step-e-01b-legacy-conversion.md`
221
215
  - IF E (Edit As-Is): Display "Proceeding with edits..." then load next step
222
216
  - IF X (Exit): Display summary and exit
223
217
  - IF Any other: help user, then redisplay menu
@@ -1,9 +1,5 @@
1
1
  ---
2
- name: 'step-e-01b-legacy-conversion'
3
- description: 'Legacy PRD Conversion Assessment - Analyze legacy PRD and propose conversion strategy'
4
-
5
2
  # File references (ONLY variables used in this step)
6
- nextStepFile: './step-e-02-review.md'
7
3
  prdFile: '{prd_file_path}'
8
4
  prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
9
5
  ---
@@ -182,7 +178,7 @@ Edit goals: {summary}
182
178
 
183
179
  **Proceeding to deep review...**"
184
180
 
185
- Read fully and follow: {nextStepFile} (step-e-02-review.md)
181
+ Read fully and follow: `./step-e-02-review.md`
186
182
 
187
183
  ---
188
184
 
@@ -1,13 +1,8 @@
1
1
  ---
2
- name: 'step-e-02-review'
3
- description: 'Deep Review & Analysis - Thoroughly review existing PRD and prepare detailed change plan'
4
-
5
2
  # File references (ONLY variables used in this step)
6
- nextStepFile: './step-e-03-edit.md'
7
3
  prdFile: '{prd_file_path}'
8
4
  validationReport: '{validation_report_path}' # If provided
9
5
  prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
10
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
11
6
  ---
12
7
 
13
8
  # Step E-2: Deep Review & Analysis
@@ -205,7 +200,7 @@ Display: "**Change Plan Approved**
205
200
 
206
201
  **Proceeding to edit step...**"
207
202
 
208
- Read fully and follow: {nextStepFile} (step-e-03-edit.md)
203
+ Read fully and follow: `./step-e-03-edit.md`
209
204
 
210
205
  ### 7. Present MENU OPTIONS (If User Wants Discussion)
211
206
 
@@ -220,9 +215,9 @@ Read fully and follow: {nextStepFile} (step-e-03-edit.md)
220
215
 
221
216
  #### Menu Handling Logic:
222
217
 
223
- - IF A: Read fully and follow: {advancedElicitationTask}, then return to discussion
224
- - IF P: Read fully and follow: {partyModeWorkflow}, then return to discussion
225
- - IF C: Document approval, then load {nextStepFile}
218
+ - IF A: Invoke the `bmad-advanced-elicitation` skill, then return to discussion
219
+ - IF P: Invoke the `bmad-party-mode` skill, then return to discussion
220
+ - IF C: Document approval, then load step-e-03-edit.md
226
221
  - IF Any other: discuss, then redisplay menu
227
222
 
228
223
  ---
@@ -1,9 +1,5 @@
1
1
  ---
2
- name: 'step-e-03-edit'
3
- description: 'Edit & Update - Apply changes to PRD following approved change plan'
4
-
5
2
  # File references (ONLY variables used in this step)
6
- nextStepFile: './step-e-04-complete.md'
7
3
  prdFile: '{prd_file_path}'
8
4
  prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
9
5
  ---
@@ -211,7 +207,7 @@ Display:
211
207
 
212
208
  ### 8. Present MENU OPTIONS
213
209
 
214
- **[V] Run Validation** - Execute full validation workflow (steps-v/step-v-01-discovery.md)
210
+ **[V] Run Validation** - Execute full validation workflow (./steps-v/step-v-01-discovery.md)
215
211
  **[S] Summary Only** - End with summary of changes (no validation)
216
212
  **[A] Adjust** - Make additional edits
217
213
  **[X] Exit** - Exit edit workflow
@@ -223,7 +219,7 @@ Display:
223
219
 
224
220
  #### Menu Handling Logic:
225
221
 
226
- - IF V (Validate): Display "Starting validation workflow..." then read fully and follow: steps-v/step-v-01-discovery.md
222
+ - IF V (Validate): Display "Starting validation workflow..." then read fully and follow: `./steps-v/step-v-01-discovery.md`
227
223
  - IF S (Summary): Present edit summary and exit
228
224
  - IF A (Adjust): Accept additional requirements, loop back to editing
229
225
  - IF X (Exit): Display summary and exit
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-e-04-complete'
3
- description: 'Complete & Validate - Present options for next steps including full validation'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  prdFile: '{prd_file_path}'
7
4
  validationWorkflow: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md'
@@ -127,7 +124,7 @@ Display:
127
124
  - Display: "**Additional Edits**"
128
125
  - Ask: "What additional edits would you like to make?"
129
126
  - Accept input, then display: "**Returning to edit step...**"
130
- - Read fully and follow: step-e-03-edit.md again
127
+ - Read fully and follow: `./step-e-03-edit.md` again
131
128
 
132
129
  - **IF S (Summary):**
133
130
  - Display detailed summary including:
@@ -1,6 +1,5 @@
1
1
  ---
2
2
  main_config: '{project-root}/_bmad/bmm/config.yaml'
3
- editWorkflow: './steps-e/step-e-01-discovery.md'
4
3
  ---
5
4
 
6
5
  # PRD Edit Workflow
@@ -61,4 +60,4 @@ Load and read full config from {main_config} and resolve:
61
60
 
62
61
  Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
63
62
 
64
- Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md)
63
+ Then read fully and follow: `./steps-e/step-e-01-discovery.md`
@@ -3,4 +3,4 @@ name: bmad-validate-prd
3
3
  description: 'Validate a PRD against standards. Use when the user says "validate this PRD" or "run PRD validation"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -1,11 +1,6 @@
1
1
  ---
2
- name: 'step-v-01-discovery'
3
- description: 'Document Discovery & Confirmation - Handle fresh context validation, confirm PRD path, discover input documents'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-02-format-detection.md'
7
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
8
- partyModeWorkflow: 'skill:bmad-party-mode'
9
4
  prdPurpose: '../data/prd-purpose.md'
10
5
  ---
11
6
 
@@ -195,8 +190,8 @@ Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Conti
195
190
 
196
191
  #### Menu Handling Logic:
197
192
 
198
- - IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
199
- - IF P: Read fully and follow: {partyModeWorkflow}, and when finished redisplay the menu
193
+ - IF A: Invoke the `bmad-advanced-elicitation` skill, and when finished redisplay the menu
194
+ - IF P: Invoke the `bmad-party-mode` skill, and when finished redisplay the menu
200
195
  - IF C: Read fully and follow: {nextStepFile} to begin format detection
201
196
  - IF user provides additional document: Load it, update report, redisplay summary
202
197
  - IF Any other: help user, then redisplay menu
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-02-format-detection'
3
- description: 'Format Detection & Structure Analysis - Classify PRD format and route appropriately'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-03-density-validation.md'
7
4
  altStepFile: './step-v-02b-parity-check.md'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-02b-parity-check'
3
- description: 'Document Parity Check - Analyze non-standard PRD and identify gaps to achieve BMAD PRD parity'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-03-density-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-03-density-validation'
3
- description: 'Information Density Check - Scan for anti-patterns that violate information density principles'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-04-brief-coverage-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-04-brief-coverage-validation'
3
- description: 'Product Brief Coverage Check - Validate PRD covers all content from Product Brief (if used as input)'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-05-measurability-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-05-measurability-validation'
3
- description: 'Measurability Validation - Validate that all requirements (FRs and NFRs) are measurable and testable'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-06-traceability-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-06-traceability-validation'
3
- description: 'Traceability Validation - Validate the traceability chain from vision → success → journeys → FRs is intact'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-07-implementation-leakage-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-07-implementation-leakage-validation'
3
- description: 'Implementation Leakage Check - Ensure FRs and NFRs don\'t include implementation details'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-08-domain-compliance-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-08-domain-compliance-validation'
3
- description: 'Domain Compliance Validation - Validate domain-specific requirements are present for high-complexity domains'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-09-project-type-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-09-project-type-validation'
3
- description: 'Project-Type Compliance Validation - Validate project-type specific requirements are properly documented'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-10-smart-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-10-smart-validation'
3
- description: 'SMART Requirements Validation - Validate Functional Requirements meet SMART quality criteria'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-11-holistic-quality-validation.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,12 +1,8 @@
1
1
  ---
2
- name: 'step-v-11-holistic-quality-validation'
3
- description: 'Holistic Quality Assessment - Assess PRD as cohesive, compelling document - is it a good PRD?'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-12-completeness-validation.md'
7
4
  prdFile: '{prd_file_path}'
8
5
  validationReportPath: '{validation_report_path}'
9
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
10
6
  ---
11
7
 
12
8
  # Step 11: Holistic Quality Assessment
@@ -67,8 +63,8 @@ Assess the PRD as a cohesive, compelling document - evaluating document flow, du
67
63
 
68
64
  "Perform holistic quality assessment on this PRD using multi-perspective evaluation:
69
65
 
70
- **Read fully and follow the Advanced Elicitation workflow:**
71
- {advancedElicitationTask}
66
+ **Advanced Elicitation workflow:**
67
+ Invoke the `bmad-advanced-elicitation` skill
72
68
 
73
69
  **Evaluate the PRD from these perspectives:**
74
70
 
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-12-completeness-validation'
3
- description: 'Completeness Check - Final comprehensive completeness check before report generation'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  nextStepFile: './step-v-13-report-complete.md'
7
4
  prdFile: '{prd_file_path}'
@@ -1,7 +1,4 @@
1
1
  ---
2
- name: 'step-v-13-report-complete'
3
- description: 'Validation Report Complete - Finalize report, summarize findings, present to user, offer next steps'
4
-
5
2
  # File references (ONLY variables used in this step)
6
3
  validationReportPath: '{validation_report_path}'
7
4
  prdFile: '{prd_file_path}'
@@ -180,9 +177,9 @@ Display:
180
177
  - After review, return to menu
181
178
 
182
179
  - **IF E (Use Edit Workflow):**
183
- - Explain: "The Edit workflow (steps-e/) can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements."
180
+ - Explain: "The Edit workflow can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements."
184
181
  - Offer: "Would you like to launch Edit mode now? It will help you fix validation findings systematically."
185
- - If yes: Read fully and follow: steps-e/step-e-01-discovery.md
182
+ - If yes: Invoke the `bmad-edit-prd` skill, passing the validation report path as context
186
183
  - If no: Return to menu
187
184
 
188
185
  - **IF F (Fix Simpler Items):**
@@ -4,8 +4,6 @@ description: 'Document Discovery & Confirmation - Handle fresh context validatio
4
4
 
5
5
  # File references (ONLY variables used in this step)
6
6
  nextStepFile: './step-v-02-format-detection.md'
7
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
8
- partyModeWorkflow: 'skill:bmad-party-mode'
9
7
  prdPurpose: '../data/prd-purpose.md'
10
8
  ---
11
9
 
@@ -195,8 +193,8 @@ Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Conti
195
193
 
196
194
  #### Menu Handling Logic:
197
195
 
198
- - IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
199
- - IF P: Read fully and follow: {partyModeWorkflow}, and when finished redisplay the menu
196
+ - IF A: Invoke the `bmad-advanced-elicitation` skill, and when finished redisplay the menu
197
+ - IF P: Invoke the `bmad-party-mode` skill, and when finished redisplay the menu
200
198
  - IF C: Read fully and follow: {nextStepFile} to begin format detection
201
199
  - IF user provides additional document: Load it, update report, redisplay summary
202
200
  - IF Any other: help user, then redisplay menu
@@ -6,7 +6,6 @@ description: 'Holistic Quality Assessment - Assess PRD as cohesive, compelling d
6
6
  nextStepFile: './step-v-12-completeness-validation.md'
7
7
  prdFile: '{prd_file_path}'
8
8
  validationReportPath: '{validation_report_path}'
9
- advancedElicitationTask: 'skill:bmad-advanced-elicitation'
10
9
  ---
11
10
 
12
11
  # Step 11: Holistic Quality Assessment
@@ -67,8 +66,8 @@ Assess the PRD as a cohesive, compelling document - evaluating document flow, du
67
66
 
68
67
  "Perform holistic quality assessment on this PRD using multi-perspective evaluation:
69
68
 
70
- **Read fully and follow the Advanced Elicitation workflow:**
71
- {advancedElicitationTask}
69
+ **Advanced Elicitation workflow:**
70
+ Invoke the `bmad-advanced-elicitation` skill
72
71
 
73
72
  **Evaluate the PRD from these perspectives:**
74
73
 
@@ -182,7 +182,7 @@ Display:
182
182
  - **IF E (Use Edit Workflow):**
183
183
  - Explain: "The Edit workflow (steps-e/) can use this validation report to systematically address issues. Edit mode will guide you through discovering what to edit, reviewing the PRD, and applying targeted improvements."
184
184
  - Offer: "Would you like to launch Edit mode now? It will help you fix validation findings systematically."
185
- - If yes: Read fully and follow: steps-e/step-e-01-discovery.md
185
+ - If yes: Read fully and follow: `./steps-e/step-e-01-discovery.md`
186
186
  - If no: Return to menu
187
187
 
188
188
  - **IF F (Fix Simpler Items):**
@@ -3,4 +3,4 @@ name: bmad-check-implementation-readiness
3
3
  description: 'Validate PRD, UX, Architecture and Epics specs are complete. Use when the user says "check implementation readiness".'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.
@@ -3,4 +3,4 @@ name: bmad-create-architecture
3
3
  description: 'Create architecture solution design decisions for AI agent consistency. Use when the user says "lets create architecture" or "create technical architecture" or "create a solution design"'
4
4
  ---
5
5
 
6
- Follow the instructions in [workflow.md](workflow.md).
6
+ Follow the instructions in ./workflow.md.