You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: address CodeRabbit review feedback for PRD scoping step
step-08-scoping.md:
- Neutral title replacing hard-coded "MVP & Future Features"
- Task statement no longer mandates phase-based prioritization
- Confirmation gate now covers artifact creation, not just de-scoping
- Phased delivery uses user-defined phase labels/count instead of fixed 3
- "wants phased" phrasing replaced with "requests/chooses"
- Development sequence question branches by release mode
- Menu text conditional on delivery mode (no "phased roadmap" for single-release)
- Handoff to step-09 now persists releaseMode in frontmatter
- New failure mode for unapproved phase artifact creation
step-11-polish.md:
- Preservation rule now includes consent-critical evidence from step 8
**Progress: Step 8 of 11** - Next: Functional Requirements
4
4
@@ -36,7 +36,7 @@
36
36
37
37
## YOUR TASK:
38
38
39
-
Conduct comprehensive scoping exercise to define MVP boundaries and prioritize features across development phases.
39
+
Conduct comprehensive scoping exercise to define release boundaries and prioritize features based on the user's chosen delivery mode (phased or single-release).
40
40
41
41
## SCOPING SEQUENCE:
42
42
@@ -81,6 +81,7 @@ Use structured decision-making for scope:
81
81
- If you believe any user-specified requirement should be deferred or de-scoped, you MUST present this to the user and get explicit confirmation BEFORE removing it from scope
82
82
- Frame it as a recommendation, not a decision: "I'd recommend deferring X because [reason]. Do you agree, or should it stay in scope?"
83
83
- NEVER silently move user requirements to a later phase or exclude them from MVP
84
+
- Before creating any consequential phase-based artifacts (e.g., phase tags, labels, or follow-on prompts), present artifact creation as a recommendation and proceed only after explicit user approval
84
85
85
86
### 4. Progressive Feature Roadmap
86
87
@@ -92,34 +93,25 @@ Before proposing any phased approach, review the user's input documents:
92
93
-**If the input documents explicitly request phased delivery:** Guide mapping of features across the phases the user defined.
93
94
-**If scope is unclear:** ASK the user whether they want phased delivery or a single release before proceeding.
94
95
95
-
**When the user wants phased delivery**, guide mapping of features across development phases:
96
+
**When the user requests phased delivery**, guide mapping of features across the phases the user defines:
Present the scoping decisions for review, then display menu:
217
209
- Show strategic scoping plan (using structure from step 6)
218
-
- Highlight MVP boundaries and phased roadmap
210
+
- Highlight release boundaries and prioritization (phased roadmap only if phased delivery was selected)
219
211
- Ask if they'd like to refine further, get other perspectives, or proceed
220
212
- Present menu options naturally as part of conversation
221
213
@@ -224,7 +216,7 @@ Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Fu
224
216
#### Menu Handling Logic:
225
217
- IF A: Invoke the `bmad-advanced-elicitation` skill with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
226
218
- IF P: Invoke the `bmad-party-mode` skill with the scoping context, process the collaborative insights on MVP and roadmap decisions, ask user if they accept the changes, if yes update content then redisplay menu, if no keep original content then redisplay menu
227
-
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array, then read fully and follow: ./step-09-functional.md
219
+
- IF C: Append the final content to {outputFile}, update frontmatter by adding this step name to the end of the stepsCompleted array (also add `releaseMode: phased` or `releaseMode: single-release` to frontmatter based on user's choice), then read fully and follow: ./step-09-functional.md
228
220
- IF Any other: help user respond, then redisplay menu
229
221
230
222
#### EXECUTION RULES:
@@ -258,6 +250,7 @@ When user selects 'C', append the content directly to the document using the str
258
250
❌ **CRITICAL**: Silently de-scoping or deferring requirements that the user explicitly included in their input documents
259
251
❌ **CRITICAL**: Inventing phasing (MVP/Growth/Vision) when the user did not request phased delivery
260
252
❌ **CRITICAL**: Making consequential scoping decisions (what is in/out of scope) without explicit user confirmation
253
+
❌ **CRITICAL**: Creating phase-based artifacts (tags, labels, follow-on prompts) without explicit user approval
261
254
262
255
❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
263
256
❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
Copy file name to clipboardExpand all lines: src/bmm-skills/2-plan-workflows/bmad-create-prd/steps-c/step-11-polish.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -138,7 +138,7 @@ Make targeted improvements:
138
138
- All user success criteria
139
139
- All functional requirements (capability contract)
140
140
- All user journey narratives
141
-
- All scope decisions (whether phased or single-release)
141
+
- All scope decisions (whether phased or single-release), including consent-critical evidence (explicit user confirmations and rationales for any scope changes from step 8)
0 commit comments