Skip to content

Commit 4655bb1

Browse files
committed
fix(prd): require explicit user confirmation before de-scoping requirements or inventing phases
1 parent 1040c3c commit 4655bb1

File tree

2 files changed

+60
-6
lines changed

2 files changed

+60
-6
lines changed

src/bmm-skills/2-plan-workflows/bmad-create-prd/steps-c/step-08-scoping.md

Lines changed: 59 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@
1212
- 📋 YOU ARE A FACILITATOR, not a content generator
1313
- 💬 FOCUS on strategic scope decisions that keep projects viable
1414
- 🎯 EMPHASIZE lean MVP thinking while preserving long-term vision
15+
- ⚠️ NEVER de-scope, defer, or phase out requirements that the user explicitly included in their input documents without asking first
16+
- ⚠️ NEVER invent phasing (MVP/Growth/Vision) unless the user requests phased delivery — if input documents define all components as core requirements, they are ALL in scope
1517
- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
1618
- ✅ YOU MUST ALWAYS WRITE all artifact and document content in `{document_output_language}`
1719

@@ -75,10 +77,23 @@ Use structured decision-making for scope:
7577
- Advanced functionality that builds on MVP
7678
- Ask what features could be added in versions 2, 3, etc.
7779

80+
**⚠️ SCOPE CHANGE CONFIRMATION GATE:**
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+
- 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+
- NEVER silently move user requirements to a later phase or exclude them from MVP
84+
7885
### 4. Progressive Feature Roadmap
7986

80-
Create phased development approach:
81-
- Guide mapping of features across development phases
87+
**CRITICAL: Phasing is NOT automatic. Check the user's input first.**
88+
89+
Before proposing any phased approach, review the user's input documents:
90+
91+
- **If the input documents define all components as core requirements with no mention of phases:** Present all requirements as a single release scope. Do NOT invent phases or move requirements to fabricated future phases.
92+
- **If the input documents explicitly request phased delivery:** Guide mapping of features across the phases the user defined.
93+
- **If scope is unclear:** ASK the user whether they want phased delivery or a single release before proceeding.
94+
95+
**When the user wants phased delivery**, guide mapping of features across development phases:
96+
8297
- Structure as Phase 1 (MVP), Phase 2 (Growth), Phase 3 (Vision)
8398
- Ensure clear progression and dependencies
8499

@@ -98,6 +113,12 @@ Create phased development approach:
98113
- Platform features
99114
- New markets or use cases
100115

116+
**When the user wants a single release**, define the complete scope:
117+
118+
- All user-specified requirements are in scope
119+
- Focus must-have vs nice-to-have analysis on what ships in this release
120+
- Do NOT create phases — use must-have/nice-to-have priority within the single release
121+
101122
**Where does your current vision fit in this development sequence?**"
102123

103124
### 5. Risk-Based Scoping
@@ -129,6 +150,8 @@ Prepare comprehensive scoping section:
129150

130151
#### Content Structure:
131152

153+
**If user chose phased delivery:**
154+
132155
```markdown
133156
## Project Scoping & Phased Development
134157

@@ -160,6 +183,34 @@ Prepare comprehensive scoping section:
160183
**Resource Risks:** {{contingency_approach}}
161184
```
162185

186+
**If user chose single release (no phasing):**
187+
188+
```markdown
189+
## Project Scoping
190+
191+
### Strategy & Philosophy
192+
193+
**Approach:** {{chosen_approach}}
194+
**Resource Requirements:** {{team_size_and_skills}}
195+
196+
### Complete Feature Set
197+
198+
**Core User Journeys Supported:**
199+
{{all_journeys}}
200+
201+
**Must-Have Capabilities:**
202+
{{list_of_must_have_features}}
203+
204+
**Nice-to-Have Capabilities:**
205+
{{list_of_nice_to_have_features}}
206+
207+
### Risk Mitigation Strategy
208+
209+
**Technical Risks:** {{mitigation_approach}}
210+
**Market Risks:** {{validation_approach}}
211+
**Resource Risks:** {{contingency_approach}}
212+
```
213+
163214
### 7. Present MENU OPTIONS
164215

165216
Present the scoping decisions for review, then display menu:
@@ -189,8 +240,9 @@ When user selects 'C', append the content directly to the document using the str
189240

190241
✅ Complete PRD document analyzed for scope implications
191242
✅ Strategic MVP approach defined and justified
192-
✅ Clear MVP feature boundaries established
193-
✅ Phased development roadmap created
243+
✅ Clear feature boundaries established (phased or single-release, per user preference)
244+
✅ All user-specified requirements accounted for — none silently removed or deferred
245+
✅ Any scope reduction recommendations presented to user with rationale and explicit confirmation obtained
194246
✅ Key risks identified and mitigation strategies defined
195247
✅ User explicitly agrees to scope decisions
196248
✅ A/P/C menu presented and handled correctly
@@ -202,8 +254,10 @@ When user selects 'C', append the content directly to the document using the str
202254
❌ Making scope decisions without strategic rationale
203255
❌ Not getting explicit user agreement on MVP boundaries
204256
❌ Missing critical risk analysis
205-
❌ Not creating clear phased development approach
206257
❌ Not presenting A/P/C menu after content generation
258+
**CRITICAL**: Silently de-scoping or deferring requirements that the user explicitly included in their input documents
259+
**CRITICAL**: Inventing phasing (MVP/Growth/Vision) when the user did not request phased delivery
260+
**CRITICAL**: Making consequential scoping decisions (what is in/out of scope) without explicit user confirmation
207261

208262
**CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
209263
**CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file

src/bmm-skills/2-plan-workflows/bmad-create-prd/steps-c/step-11-polish.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ Make targeted improvements:
138138
- All user success criteria
139139
- All functional requirements (capability contract)
140140
- All user journey narratives
141-
- All scope decisions (MVP, Growth, Vision)
141+
- All scope decisions (whether phased or single-release)
142142
- All non-functional requirements
143143
- Product differentiator and vision
144144
- Domain-specific requirements

0 commit comments

Comments
 (0)