bmad-method 4.42.1 → 4.43.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CONTRIBUTING.md +2 -9
- package/README.md +0 -98
- package/bmad-core/agents/bmad-master.md +6 -6
- package/bmad-core/data/bmad-kb.md +1 -0
- package/bmad-core/tasks/validate-next-story.md +1 -1
- package/bmad-core/templates/brownfield-architecture-tmpl.yaml +5 -5
- package/dist/agents/analyst.txt +1 -0
- package/dist/agents/architect.txt +5 -5
- package/dist/agents/bmad-master.txt +12 -11
- package/dist/agents/bmad-orchestrator.txt +1 -0
- package/dist/agents/dev.txt +1 -1
- package/dist/agents/po.txt +1 -1
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1 -1
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +1 -1
- package/dist/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.txt +1513 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-analyst.txt +3190 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-architect.txt +4499 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-designer.txt +3925 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-developer.txt +666 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-pm.txt +2381 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-po.txt +1612 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-qa.txt +1745 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-sm.txt +1208 -0
- package/dist/expansion-packs/bmad-godot-game-dev/agents/game-ux-expert.txt +958 -0
- package/dist/expansion-packs/bmad-godot-game-dev/teams/godot-game-team.txt +27721 -0
- package/dist/teams/team-all.txt +7 -6
- package/dist/teams/team-fullstack.txt +7 -6
- package/dist/teams/team-ide-minimal.txt +2 -1
- package/dist/teams/team-no-ui.txt +7 -6
- package/docs/GUIDING-PRINCIPLES.md +3 -3
- package/docs/expansion-packs.md +3 -83
- package/docs/flattener.md +91 -0
- package/docs/versions.md +1 -1
- package/docs/working-in-the-brownfield.md +15 -6
- package/expansion-packs/bmad-godot-game-dev/README.md +244 -0
- package/expansion-packs/bmad-godot-game-dev/agent-teams/godot-game-team.yaml +18 -0
- package/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.md +147 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-analyst.md +84 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-architect.md +146 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-designer.md +78 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-developer.md +124 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-pm.md +82 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-po.md +115 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-qa.md +160 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-sm.md +66 -0
- package/expansion-packs/bmad-godot-game-dev/agents/game-ux-expert.md +75 -0
- package/expansion-packs/bmad-godot-game-dev/checklists/game-architect-checklist.md +377 -0
- package/expansion-packs/bmad-godot-game-dev/checklists/game-change-checklist.md +250 -0
- package/expansion-packs/bmad-godot-game-dev/checklists/game-design-checklist.md +225 -0
- package/expansion-packs/bmad-godot-game-dev/checklists/game-po-checklist.md +448 -0
- package/expansion-packs/bmad-godot-game-dev/checklists/game-story-dod-checklist.md +202 -0
- package/expansion-packs/bmad-godot-game-dev/config.yaml +30 -0
- package/expansion-packs/bmad-godot-game-dev/data/bmad-kb.md +811 -0
- package/expansion-packs/bmad-godot-game-dev/data/brainstorming-techniques.md +36 -0
- package/expansion-packs/bmad-godot-game-dev/data/development-guidelines.md +893 -0
- package/expansion-packs/bmad-godot-game-dev/data/elicitation-methods.md +156 -0
- package/expansion-packs/bmad-godot-game-dev/data/technical-preferences.md +3 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/advanced-elicitation.md +110 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/apply-qa-fixes.md +224 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/brownfield-create-epic.md +162 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/brownfield-create-story.md +149 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/correct-course-game.md +159 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/create-deep-research-prompt.md +278 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/create-doc.md +103 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/create-game-story.md +202 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/document-project.md +343 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/execute-checklist.md +88 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/facilitate-brainstorming-session.md +136 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-epic.md +160 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-story.md +147 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/game-design-brainstorming.md +290 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/game-risk-profile.md +368 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/game-test-design.md +219 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/generate-ai-frontend-prompt.md +51 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/kb-mode-interaction.md +77 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/review-game-story.md +364 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/shard-doc.md +187 -0
- package/expansion-packs/bmad-godot-game-dev/tasks/validate-game-story.md +208 -0
- package/expansion-packs/bmad-godot-game-dev/templates/brainstorming-output-tmpl.yaml +156 -0
- package/expansion-packs/bmad-godot-game-dev/templates/brownfield-prd-tmpl.yaml +281 -0
- package/expansion-packs/bmad-godot-game-dev/templates/competitor-analysis-tmpl.yaml +306 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-architecture-tmpl.yaml +1111 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-brief-tmpl.yaml +356 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-design-doc-tmpl.yaml +724 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-prd-tmpl.yaml +209 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-qa-gate-tmpl.yaml +186 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-story-tmpl.yaml +406 -0
- package/expansion-packs/bmad-godot-game-dev/templates/game-ui-spec-tmpl.yaml +601 -0
- package/expansion-packs/bmad-godot-game-dev/templates/level-design-doc-tmpl.yaml +620 -0
- package/expansion-packs/bmad-godot-game-dev/templates/market-research-tmpl.yaml +418 -0
- package/expansion-packs/bmad-godot-game-dev/utils/bmad-doc-template.md +327 -0
- package/expansion-packs/bmad-godot-game-dev/utils/workflow-management.md +71 -0
- package/expansion-packs/bmad-godot-game-dev/workflows/game-dev-greenfield.yaml +245 -0
- package/expansion-packs/bmad-godot-game-dev/workflows/game-prototype.yaml +213 -0
- package/package.json +1 -1
- package/release_notes.md +19 -2
- package/tools/flattener/ignoreRules.js +2 -0
- package/tools/installer/bin/bmad.js +37 -1
- package/tools/installer/config/install.config.yaml +35 -7
- package/tools/installer/lib/ide-setup.js +285 -80
- package/tools/installer/lib/installer.js +6 -1
- package/tools/installer/package.json +1 -1
- package/tools/upgraders/v3-to-v4-upgrader.js +1 -0
- package/test.md +0 -1
- /package/{implement-fork-friendly-ci.sh → tools/implement-fork-friendly-ci.sh} +0 -0
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
---
|
|
2
|
+
docOutputLocation: docs/brainstorming-session-results.md
|
|
3
|
+
template: '.bmad-godot-game-dev/templates/brainstorming-output-tmpl.yaml'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Facilitate Brainstorming Session Task
|
|
7
|
+
|
|
8
|
+
Facilitate interactive brainstorming sessions with users. Be creative and adaptive in applying techniques.
|
|
9
|
+
|
|
10
|
+
## Process
|
|
11
|
+
|
|
12
|
+
### Step 1: Session Setup
|
|
13
|
+
|
|
14
|
+
Ask 4 context questions (don't preview what happens next):
|
|
15
|
+
|
|
16
|
+
1. What are we brainstorming about?
|
|
17
|
+
2. Any constraints or parameters?
|
|
18
|
+
3. Goal: broad exploration or focused ideation?
|
|
19
|
+
4. Do you want a structured document output to reference later? (Default Yes)
|
|
20
|
+
|
|
21
|
+
### Step 2: Present Approach Options
|
|
22
|
+
|
|
23
|
+
After getting answers to Step 1, present 4 approach options (numbered):
|
|
24
|
+
|
|
25
|
+
1. User selects specific techniques
|
|
26
|
+
2. Analyst recommends techniques based on context
|
|
27
|
+
3. Random technique selection for creative variety
|
|
28
|
+
4. Progressive technique flow (start broad, narrow down)
|
|
29
|
+
|
|
30
|
+
### Step 3: Execute Techniques Interactively
|
|
31
|
+
|
|
32
|
+
**KEY PRINCIPLES:**
|
|
33
|
+
|
|
34
|
+
- **FACILITATOR ROLE**: Guide user to generate their own ideas through questions, prompts, and examples
|
|
35
|
+
- **CONTINUOUS ENGAGEMENT**: Keep user engaged with chosen technique until they want to switch or are satisfied
|
|
36
|
+
- **CAPTURE OUTPUT**: If (default) document output requested, capture all ideas generated in each technique section to the document from the beginning.
|
|
37
|
+
|
|
38
|
+
**Technique Selection:**
|
|
39
|
+
If user selects Option 1, present numbered list of techniques from the brainstorming-techniques data file. User can select by number..
|
|
40
|
+
|
|
41
|
+
**Technique Execution:**
|
|
42
|
+
|
|
43
|
+
1. Apply selected technique according to data file description
|
|
44
|
+
2. Keep engaging with technique until user indicates they want to:
|
|
45
|
+
- Choose a different technique
|
|
46
|
+
- Apply current ideas to a new technique
|
|
47
|
+
- Move to convergent phase
|
|
48
|
+
- End session
|
|
49
|
+
|
|
50
|
+
**Output Capture (if requested):**
|
|
51
|
+
For each technique used, capture:
|
|
52
|
+
|
|
53
|
+
- Technique name and duration
|
|
54
|
+
- Key ideas generated by user
|
|
55
|
+
- Insights and patterns identified
|
|
56
|
+
- User's reflections on the process
|
|
57
|
+
|
|
58
|
+
### Step 4: Session Flow
|
|
59
|
+
|
|
60
|
+
1. **Warm-up** (5-10 min) - Build creative confidence
|
|
61
|
+
2. **Divergent** (20-30 min) - Generate quantity over quality
|
|
62
|
+
3. **Convergent** (15-20 min) - Group and categorize ideas
|
|
63
|
+
4. **Synthesis** (10-15 min) - Refine and develop concepts
|
|
64
|
+
|
|
65
|
+
### Step 5: Document Output (if requested)
|
|
66
|
+
|
|
67
|
+
Generate structured document with these sections:
|
|
68
|
+
|
|
69
|
+
**Executive Summary**
|
|
70
|
+
|
|
71
|
+
- Session topic and goals
|
|
72
|
+
- Techniques used and duration
|
|
73
|
+
- Total ideas generated
|
|
74
|
+
- Key themes and patterns identified
|
|
75
|
+
|
|
76
|
+
**Technique Sections** (for each technique used)
|
|
77
|
+
|
|
78
|
+
- Technique name and description
|
|
79
|
+
- Ideas generated (user's own words)
|
|
80
|
+
- Insights discovered
|
|
81
|
+
- Notable connections or patterns
|
|
82
|
+
|
|
83
|
+
**Idea Categorization**
|
|
84
|
+
|
|
85
|
+
- **Immediate Opportunities** - Ready to implement now
|
|
86
|
+
- **Future Innovations** - Requires development/research
|
|
87
|
+
- **Moonshots** - Ambitious, transformative concepts
|
|
88
|
+
- **Insights & Learnings** - Key realizations from session
|
|
89
|
+
|
|
90
|
+
**Action Planning**
|
|
91
|
+
|
|
92
|
+
- Top 3 priority ideas with rationale
|
|
93
|
+
- Next steps for each priority
|
|
94
|
+
- Resources/research needed
|
|
95
|
+
- Timeline considerations
|
|
96
|
+
|
|
97
|
+
**Reflection & Follow-up**
|
|
98
|
+
|
|
99
|
+
- What worked well in this session
|
|
100
|
+
- Areas for further exploration
|
|
101
|
+
- Recommended follow-up techniques
|
|
102
|
+
- Questions that emerged for future sessions
|
|
103
|
+
|
|
104
|
+
## Key Principles
|
|
105
|
+
|
|
106
|
+
- **YOU ARE A FACILITATOR**: Guide the user to brainstorm, don't brainstorm for them (unless they request it persistently)
|
|
107
|
+
- **INTERACTIVE DIALOGUE**: Ask questions, wait for responses, build on their ideas
|
|
108
|
+
- **ONE TECHNIQUE AT A TIME**: Don't mix multiple techniques in one response
|
|
109
|
+
- **CONTINUOUS ENGAGEMENT**: Stay with one technique until user wants to switch
|
|
110
|
+
- **DRAW IDEAS OUT**: Use prompts and examples to help them generate their own ideas
|
|
111
|
+
- **REAL-TIME ADAPTATION**: Monitor engagement and adjust approach as needed
|
|
112
|
+
- Maintain energy and momentum
|
|
113
|
+
- Defer judgment during generation
|
|
114
|
+
- Quantity leads to quality (aim for 100 ideas in 60 minutes)
|
|
115
|
+
- Build on ideas collaboratively
|
|
116
|
+
- Document everything in output document
|
|
117
|
+
|
|
118
|
+
## Advanced Engagement Strategies
|
|
119
|
+
|
|
120
|
+
**Energy Management**
|
|
121
|
+
|
|
122
|
+
- Check engagement levels: "How are you feeling about this direction?"
|
|
123
|
+
- Offer breaks or technique switches if energy flags
|
|
124
|
+
- Use encouraging language and celebrate idea generation
|
|
125
|
+
|
|
126
|
+
**Depth vs. Breadth**
|
|
127
|
+
|
|
128
|
+
- Ask follow-up questions to deepen ideas: "Tell me more about that..."
|
|
129
|
+
- Use "Yes, and..." to build on their ideas
|
|
130
|
+
- Help them make connections: "How does this relate to your earlier idea about...?"
|
|
131
|
+
|
|
132
|
+
**Transition Management**
|
|
133
|
+
|
|
134
|
+
- Always ask before switching techniques: "Ready to try a different approach?"
|
|
135
|
+
- Offer options: "Should we explore this idea deeper or generate more alternatives?"
|
|
136
|
+
- Respect their process and timing
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# Create Brownfield Epic Task
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Create a single epic for smaller brownfield enhancements that don't require the full PRD and Architecture documentation process. This task is for isolated features or modifications that can be completed within a focused scope.
|
|
6
|
+
|
|
7
|
+
## When to Use This Task
|
|
8
|
+
|
|
9
|
+
**Use this task when:**
|
|
10
|
+
|
|
11
|
+
- The enhancement can be completed in 1-3 stories
|
|
12
|
+
- No significant architectural changes are required
|
|
13
|
+
- The enhancement follows existing project patterns
|
|
14
|
+
- Integration complexity is minimal
|
|
15
|
+
- Risk to existing system is low
|
|
16
|
+
|
|
17
|
+
**Use the full brownfield PRD/Architecture process when:**
|
|
18
|
+
|
|
19
|
+
- The enhancement requires multiple coordinated stories
|
|
20
|
+
- Architectural planning is needed
|
|
21
|
+
- Significant integration work is required
|
|
22
|
+
- Risk assessment and mitigation planning is necessary
|
|
23
|
+
|
|
24
|
+
## Instructions
|
|
25
|
+
|
|
26
|
+
### 1. Project Analysis (Required)
|
|
27
|
+
|
|
28
|
+
Before creating the epic, gather essential information about the existing project:
|
|
29
|
+
|
|
30
|
+
**Existing Project Context:**
|
|
31
|
+
|
|
32
|
+
- [ ] Project purpose and current functionality understood
|
|
33
|
+
- [ ] Existing technology stack identified
|
|
34
|
+
- [ ] Current architecture patterns noted
|
|
35
|
+
- [ ] Integration points with existing system identified
|
|
36
|
+
|
|
37
|
+
**Enhancement Scope:**
|
|
38
|
+
|
|
39
|
+
- [ ] Enhancement clearly defined and scoped
|
|
40
|
+
- [ ] Impact on existing functionality assessed
|
|
41
|
+
- [ ] Required integration points identified
|
|
42
|
+
- [ ] Success criteria established
|
|
43
|
+
|
|
44
|
+
### 2. Epic Creation
|
|
45
|
+
|
|
46
|
+
Create a focused epic following this structure:
|
|
47
|
+
|
|
48
|
+
#### Epic Title
|
|
49
|
+
|
|
50
|
+
{{Enhancement Name}} - Brownfield Enhancement
|
|
51
|
+
|
|
52
|
+
#### Epic Goal
|
|
53
|
+
|
|
54
|
+
{{1-2 sentences describing what the epic will accomplish and why it adds value}}
|
|
55
|
+
|
|
56
|
+
#### Epic Description
|
|
57
|
+
|
|
58
|
+
**Existing System Context:**
|
|
59
|
+
|
|
60
|
+
- Current relevant functionality: {{brief description}}
|
|
61
|
+
- Technology stack: {{relevant existing technologies}}
|
|
62
|
+
- Integration points: {{where new work connects to existing system}}
|
|
63
|
+
|
|
64
|
+
**Enhancement Details:**
|
|
65
|
+
|
|
66
|
+
- What's being added/changed: {{clear description}}
|
|
67
|
+
- How it integrates: {{integration approach}}
|
|
68
|
+
- Success criteria: {{measurable outcomes}}
|
|
69
|
+
|
|
70
|
+
#### Stories
|
|
71
|
+
|
|
72
|
+
List 1-3 focused stories that complete the epic:
|
|
73
|
+
|
|
74
|
+
1. **Story 1:** {{Story title and brief description}}
|
|
75
|
+
2. **Story 2:** {{Story title and brief description}}
|
|
76
|
+
3. **Story 3:** {{Story title and brief description}}
|
|
77
|
+
|
|
78
|
+
#### Compatibility Requirements
|
|
79
|
+
|
|
80
|
+
- [ ] Existing APIs remain unchanged
|
|
81
|
+
- [ ] Database schema changes are backward compatible
|
|
82
|
+
- [ ] UI changes follow existing patterns
|
|
83
|
+
- [ ] Performance impact is minimal
|
|
84
|
+
|
|
85
|
+
#### Risk Mitigation
|
|
86
|
+
|
|
87
|
+
- **Primary Risk:** {{main risk to existing system}}
|
|
88
|
+
- **Mitigation:** {{how risk will be addressed}}
|
|
89
|
+
- **Rollback Plan:** {{how to undo changes if needed}}
|
|
90
|
+
|
|
91
|
+
#### Definition of Done
|
|
92
|
+
|
|
93
|
+
- [ ] All stories completed with acceptance criteria met
|
|
94
|
+
- [ ] Existing functionality verified through testing
|
|
95
|
+
- [ ] Integration points working correctly
|
|
96
|
+
- [ ] Documentation updated appropriately
|
|
97
|
+
- [ ] No regression in existing features
|
|
98
|
+
|
|
99
|
+
### 3. Validation Checklist
|
|
100
|
+
|
|
101
|
+
Before finalizing the epic, ensure:
|
|
102
|
+
|
|
103
|
+
**Scope Validation:**
|
|
104
|
+
|
|
105
|
+
- [ ] Epic can be completed in 1-3 stories maximum
|
|
106
|
+
- [ ] No architectural documentation is required
|
|
107
|
+
- [ ] Enhancement follows existing patterns
|
|
108
|
+
- [ ] Integration complexity is manageable
|
|
109
|
+
|
|
110
|
+
**Risk Assessment:**
|
|
111
|
+
|
|
112
|
+
- [ ] Risk to existing system is low
|
|
113
|
+
- [ ] Rollback plan is feasible
|
|
114
|
+
- [ ] Testing approach covers existing functionality
|
|
115
|
+
- [ ] Team has sufficient knowledge of integration points
|
|
116
|
+
|
|
117
|
+
**Completeness Check:**
|
|
118
|
+
|
|
119
|
+
- [ ] Epic goal is clear and achievable
|
|
120
|
+
- [ ] Stories are properly scoped
|
|
121
|
+
- [ ] Success criteria are measurable
|
|
122
|
+
- [ ] Dependencies are identified
|
|
123
|
+
|
|
124
|
+
### 4. Handoff to Story Manager
|
|
125
|
+
|
|
126
|
+
Once the epic is validated, provide this handoff to the Story Manager:
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
**Story Manager Handoff:**
|
|
131
|
+
|
|
132
|
+
"Please develop detailed user stories for this brownfield epic. Key considerations:
|
|
133
|
+
|
|
134
|
+
- This is an enhancement to an existing system running {{technology stack}}
|
|
135
|
+
- Integration points: {{list key integration points}}
|
|
136
|
+
- Existing patterns to follow: {{relevant existing patterns}}
|
|
137
|
+
- Critical compatibility requirements: {{key requirements}}
|
|
138
|
+
- Each story must include verification that existing functionality remains intact
|
|
139
|
+
|
|
140
|
+
The epic should maintain system integrity while delivering {{epic goal}}."
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## Success Criteria
|
|
145
|
+
|
|
146
|
+
The epic creation is successful when:
|
|
147
|
+
|
|
148
|
+
1. Enhancement scope is clearly defined and appropriately sized
|
|
149
|
+
2. Integration approach respects existing system architecture
|
|
150
|
+
3. Risk to existing functionality is minimized
|
|
151
|
+
4. Stories are logically sequenced for safe implementation
|
|
152
|
+
5. Compatibility requirements are clearly specified
|
|
153
|
+
6. Rollback plan is feasible and documented
|
|
154
|
+
|
|
155
|
+
## Important Notes
|
|
156
|
+
|
|
157
|
+
- This task is specifically for SMALL brownfield enhancements
|
|
158
|
+
- If the scope grows beyond 3 stories, consider the full brownfield PRD process
|
|
159
|
+
- Always prioritize existing system integrity over new functionality
|
|
160
|
+
- When in doubt about scope or complexity, escalate to full brownfield planning
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
# Create Brownfield Story Task
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Create a single user story for very small brownfield enhancements that can be completed in one focused development session. This task is for minimal additions or bug fixes that require existing system integration awareness.
|
|
6
|
+
|
|
7
|
+
## When to Use This Task
|
|
8
|
+
|
|
9
|
+
**Use this task when:**
|
|
10
|
+
|
|
11
|
+
- The enhancement can be completed in a single story
|
|
12
|
+
- No new architecture or significant design is required
|
|
13
|
+
- The change follows existing patterns exactly
|
|
14
|
+
- Integration is straightforward with minimal risk
|
|
15
|
+
- Change is isolated with clear boundaries
|
|
16
|
+
|
|
17
|
+
**Use brownfield-create-epic when:**
|
|
18
|
+
|
|
19
|
+
- The enhancement requires 2-3 coordinated stories
|
|
20
|
+
- Some design work is needed
|
|
21
|
+
- Multiple integration points are involved
|
|
22
|
+
|
|
23
|
+
**Use the full brownfield PRD/Architecture process when:**
|
|
24
|
+
|
|
25
|
+
- The enhancement requires multiple coordinated stories
|
|
26
|
+
- Architectural planning is needed
|
|
27
|
+
- Significant integration work is required
|
|
28
|
+
|
|
29
|
+
## Instructions
|
|
30
|
+
|
|
31
|
+
### 1. Quick Project Assessment
|
|
32
|
+
|
|
33
|
+
Gather minimal but essential context about the existing project:
|
|
34
|
+
|
|
35
|
+
**Current System Context:**
|
|
36
|
+
|
|
37
|
+
- [ ] Relevant existing functionality identified
|
|
38
|
+
- [ ] Technology stack for this area noted
|
|
39
|
+
- [ ] Integration point(s) clearly understood
|
|
40
|
+
- [ ] Existing patterns for similar work identified
|
|
41
|
+
|
|
42
|
+
**Change Scope:**
|
|
43
|
+
|
|
44
|
+
- [ ] Specific change clearly defined
|
|
45
|
+
- [ ] Impact boundaries identified
|
|
46
|
+
- [ ] Success criteria established
|
|
47
|
+
|
|
48
|
+
### 2. Story Creation
|
|
49
|
+
|
|
50
|
+
Create a single focused story following this structure:
|
|
51
|
+
|
|
52
|
+
#### Story Title
|
|
53
|
+
|
|
54
|
+
{{Specific Enhancement}} - Brownfield Addition
|
|
55
|
+
|
|
56
|
+
#### User Story
|
|
57
|
+
|
|
58
|
+
As a {{user type}},
|
|
59
|
+
I want {{specific action/capability}},
|
|
60
|
+
So that {{clear benefit/value}}.
|
|
61
|
+
|
|
62
|
+
#### Story Context
|
|
63
|
+
|
|
64
|
+
**Existing System Integration:**
|
|
65
|
+
|
|
66
|
+
- Integrates with: {{existing component/system}}
|
|
67
|
+
- Technology: {{relevant tech stack}}
|
|
68
|
+
- Follows pattern: {{existing pattern to follow}}
|
|
69
|
+
- Touch points: {{specific integration points}}
|
|
70
|
+
|
|
71
|
+
#### Acceptance Criteria
|
|
72
|
+
|
|
73
|
+
**Functional Requirements:**
|
|
74
|
+
|
|
75
|
+
1. {{Primary functional requirement}}
|
|
76
|
+
2. {{Secondary functional requirement (if any)}}
|
|
77
|
+
3. {{Integration requirement}}
|
|
78
|
+
|
|
79
|
+
**Integration Requirements:** 4. Existing {{relevant functionality}} continues to work unchanged 5. New functionality follows existing {{pattern}} pattern 6. Integration with {{system/component}} maintains current behavior
|
|
80
|
+
|
|
81
|
+
**Quality Requirements:** 7. Change is covered by appropriate tests 8. Documentation is updated if needed 9. No regression in existing functionality verified
|
|
82
|
+
|
|
83
|
+
#### Technical Notes
|
|
84
|
+
|
|
85
|
+
- **Integration Approach:** {{how it connects to existing system}}
|
|
86
|
+
- **Existing Pattern Reference:** {{link or description of pattern to follow}}
|
|
87
|
+
- **Key Constraints:** {{any important limitations or requirements}}
|
|
88
|
+
|
|
89
|
+
#### Definition of Done
|
|
90
|
+
|
|
91
|
+
- [ ] Functional requirements met
|
|
92
|
+
- [ ] Integration requirements verified
|
|
93
|
+
- [ ] Existing functionality regression tested
|
|
94
|
+
- [ ] Code follows existing patterns and standards
|
|
95
|
+
- [ ] Tests pass (existing and new)
|
|
96
|
+
- [ ] Documentation updated if applicable
|
|
97
|
+
|
|
98
|
+
### 3. Risk and Compatibility Check
|
|
99
|
+
|
|
100
|
+
**Minimal Risk Assessment:**
|
|
101
|
+
|
|
102
|
+
- **Primary Risk:** {{main risk to existing system}}
|
|
103
|
+
- **Mitigation:** {{simple mitigation approach}}
|
|
104
|
+
- **Rollback:** {{how to undo if needed}}
|
|
105
|
+
|
|
106
|
+
**Compatibility Verification:**
|
|
107
|
+
|
|
108
|
+
- [ ] No breaking changes to existing APIs
|
|
109
|
+
- [ ] Database changes (if any) are additive only
|
|
110
|
+
- [ ] UI changes follow existing design patterns
|
|
111
|
+
- [ ] Performance impact is negligible
|
|
112
|
+
|
|
113
|
+
### 4. Validation Checklist
|
|
114
|
+
|
|
115
|
+
Before finalizing the story, confirm:
|
|
116
|
+
|
|
117
|
+
**Scope Validation:**
|
|
118
|
+
|
|
119
|
+
- [ ] Story can be completed in one development session
|
|
120
|
+
- [ ] Integration approach is straightforward
|
|
121
|
+
- [ ] Follows existing patterns exactly
|
|
122
|
+
- [ ] No design or architecture work required
|
|
123
|
+
|
|
124
|
+
**Clarity Check:**
|
|
125
|
+
|
|
126
|
+
- [ ] Story requirements are unambiguous
|
|
127
|
+
- [ ] Integration points are clearly specified
|
|
128
|
+
- [ ] Success criteria are testable
|
|
129
|
+
- [ ] Rollback approach is simple
|
|
130
|
+
|
|
131
|
+
## Success Criteria
|
|
132
|
+
|
|
133
|
+
The story creation is successful when:
|
|
134
|
+
|
|
135
|
+
1. Enhancement is clearly defined and appropriately scoped for single session
|
|
136
|
+
2. Integration approach is straightforward and low-risk
|
|
137
|
+
3. Existing system patterns are identified and will be followed
|
|
138
|
+
4. Rollback plan is simple and feasible
|
|
139
|
+
5. Acceptance criteria include existing functionality verification
|
|
140
|
+
|
|
141
|
+
## Important Notes
|
|
142
|
+
|
|
143
|
+
- This task is for VERY SMALL brownfield changes only
|
|
144
|
+
- If complexity grows during analysis, escalate to brownfield-create-epic
|
|
145
|
+
- Always prioritize existing system integrity
|
|
146
|
+
- When in doubt about integration complexity, use brownfield-create-epic instead
|
|
147
|
+
- Stories should take no more than 4 hours of focused development work
|