bmad-method 4.43.0 → 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.
Files changed (100) hide show
  1. package/CONTRIBUTING.md +2 -9
  2. package/README.md +0 -82
  3. package/bmad-core/agents/bmad-master.md +6 -6
  4. package/bmad-core/tasks/validate-next-story.md +1 -1
  5. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +5 -5
  6. package/dist/agents/architect.txt +5 -5
  7. package/dist/agents/bmad-master.txt +11 -11
  8. package/dist/agents/dev.txt +1 -1
  9. package/dist/agents/po.txt +1 -1
  10. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +1 -1
  11. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +1 -1
  12. package/dist/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.txt +1513 -0
  13. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-analyst.txt +3190 -0
  14. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-architect.txt +4499 -0
  15. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-designer.txt +3925 -0
  16. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-developer.txt +666 -0
  17. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-pm.txt +2381 -0
  18. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-po.txt +1612 -0
  19. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-qa.txt +1745 -0
  20. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-sm.txt +1208 -0
  21. package/dist/expansion-packs/bmad-godot-game-dev/agents/game-ux-expert.txt +958 -0
  22. package/dist/expansion-packs/bmad-godot-game-dev/teams/godot-game-team.txt +27721 -0
  23. package/dist/teams/team-all.txt +6 -6
  24. package/dist/teams/team-fullstack.txt +6 -6
  25. package/dist/teams/team-ide-minimal.txt +1 -1
  26. package/dist/teams/team-no-ui.txt +6 -6
  27. package/docs/GUIDING-PRINCIPLES.md +3 -3
  28. package/docs/flattener.md +91 -0
  29. package/docs/versions.md +1 -1
  30. package/docs/working-in-the-brownfield.md +15 -6
  31. package/expansion-packs/bmad-godot-game-dev/README.md +244 -0
  32. package/expansion-packs/bmad-godot-game-dev/agent-teams/godot-game-team.yaml +18 -0
  33. package/expansion-packs/bmad-godot-game-dev/agents/bmad-orchestrator.md +147 -0
  34. package/expansion-packs/bmad-godot-game-dev/agents/game-analyst.md +84 -0
  35. package/expansion-packs/bmad-godot-game-dev/agents/game-architect.md +146 -0
  36. package/expansion-packs/bmad-godot-game-dev/agents/game-designer.md +78 -0
  37. package/expansion-packs/bmad-godot-game-dev/agents/game-developer.md +124 -0
  38. package/expansion-packs/bmad-godot-game-dev/agents/game-pm.md +82 -0
  39. package/expansion-packs/bmad-godot-game-dev/agents/game-po.md +115 -0
  40. package/expansion-packs/bmad-godot-game-dev/agents/game-qa.md +160 -0
  41. package/expansion-packs/bmad-godot-game-dev/agents/game-sm.md +66 -0
  42. package/expansion-packs/bmad-godot-game-dev/agents/game-ux-expert.md +75 -0
  43. package/expansion-packs/bmad-godot-game-dev/checklists/game-architect-checklist.md +377 -0
  44. package/expansion-packs/bmad-godot-game-dev/checklists/game-change-checklist.md +250 -0
  45. package/expansion-packs/bmad-godot-game-dev/checklists/game-design-checklist.md +225 -0
  46. package/expansion-packs/bmad-godot-game-dev/checklists/game-po-checklist.md +448 -0
  47. package/expansion-packs/bmad-godot-game-dev/checklists/game-story-dod-checklist.md +202 -0
  48. package/expansion-packs/bmad-godot-game-dev/config.yaml +30 -0
  49. package/expansion-packs/bmad-godot-game-dev/data/bmad-kb.md +811 -0
  50. package/expansion-packs/bmad-godot-game-dev/data/brainstorming-techniques.md +36 -0
  51. package/expansion-packs/bmad-godot-game-dev/data/development-guidelines.md +893 -0
  52. package/expansion-packs/bmad-godot-game-dev/data/elicitation-methods.md +156 -0
  53. package/expansion-packs/bmad-godot-game-dev/data/technical-preferences.md +3 -0
  54. package/expansion-packs/bmad-godot-game-dev/tasks/advanced-elicitation.md +110 -0
  55. package/expansion-packs/bmad-godot-game-dev/tasks/apply-qa-fixes.md +224 -0
  56. package/expansion-packs/bmad-godot-game-dev/tasks/brownfield-create-epic.md +162 -0
  57. package/expansion-packs/bmad-godot-game-dev/tasks/brownfield-create-story.md +149 -0
  58. package/expansion-packs/bmad-godot-game-dev/tasks/correct-course-game.md +159 -0
  59. package/expansion-packs/bmad-godot-game-dev/tasks/create-deep-research-prompt.md +278 -0
  60. package/expansion-packs/bmad-godot-game-dev/tasks/create-doc.md +103 -0
  61. package/expansion-packs/bmad-godot-game-dev/tasks/create-game-story.md +202 -0
  62. package/expansion-packs/bmad-godot-game-dev/tasks/document-project.md +343 -0
  63. package/expansion-packs/bmad-godot-game-dev/tasks/execute-checklist.md +88 -0
  64. package/expansion-packs/bmad-godot-game-dev/tasks/facilitate-brainstorming-session.md +136 -0
  65. package/expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-epic.md +160 -0
  66. package/expansion-packs/bmad-godot-game-dev/tasks/game-brownfield-create-story.md +147 -0
  67. package/expansion-packs/bmad-godot-game-dev/tasks/game-design-brainstorming.md +290 -0
  68. package/expansion-packs/bmad-godot-game-dev/tasks/game-risk-profile.md +368 -0
  69. package/expansion-packs/bmad-godot-game-dev/tasks/game-test-design.md +219 -0
  70. package/expansion-packs/bmad-godot-game-dev/tasks/generate-ai-frontend-prompt.md +51 -0
  71. package/expansion-packs/bmad-godot-game-dev/tasks/kb-mode-interaction.md +77 -0
  72. package/expansion-packs/bmad-godot-game-dev/tasks/review-game-story.md +364 -0
  73. package/expansion-packs/bmad-godot-game-dev/tasks/shard-doc.md +187 -0
  74. package/expansion-packs/bmad-godot-game-dev/tasks/validate-game-story.md +208 -0
  75. package/expansion-packs/bmad-godot-game-dev/templates/brainstorming-output-tmpl.yaml +156 -0
  76. package/expansion-packs/bmad-godot-game-dev/templates/brownfield-prd-tmpl.yaml +281 -0
  77. package/expansion-packs/bmad-godot-game-dev/templates/competitor-analysis-tmpl.yaml +306 -0
  78. package/expansion-packs/bmad-godot-game-dev/templates/game-architecture-tmpl.yaml +1111 -0
  79. package/expansion-packs/bmad-godot-game-dev/templates/game-brief-tmpl.yaml +356 -0
  80. package/expansion-packs/bmad-godot-game-dev/templates/game-design-doc-tmpl.yaml +724 -0
  81. package/expansion-packs/bmad-godot-game-dev/templates/game-prd-tmpl.yaml +209 -0
  82. package/expansion-packs/bmad-godot-game-dev/templates/game-qa-gate-tmpl.yaml +186 -0
  83. package/expansion-packs/bmad-godot-game-dev/templates/game-story-tmpl.yaml +406 -0
  84. package/expansion-packs/bmad-godot-game-dev/templates/game-ui-spec-tmpl.yaml +601 -0
  85. package/expansion-packs/bmad-godot-game-dev/templates/level-design-doc-tmpl.yaml +620 -0
  86. package/expansion-packs/bmad-godot-game-dev/templates/market-research-tmpl.yaml +418 -0
  87. package/expansion-packs/bmad-godot-game-dev/utils/bmad-doc-template.md +327 -0
  88. package/expansion-packs/bmad-godot-game-dev/utils/workflow-management.md +71 -0
  89. package/expansion-packs/bmad-godot-game-dev/workflows/game-dev-greenfield.yaml +245 -0
  90. package/expansion-packs/bmad-godot-game-dev/workflows/game-prototype.yaml +213 -0
  91. package/package.json +1 -1
  92. package/release_notes.md +14 -2
  93. package/tools/flattener/ignoreRules.js +2 -0
  94. package/tools/installer/bin/bmad.js +2 -1
  95. package/tools/installer/config/install.config.yaml +16 -7
  96. package/tools/installer/lib/ide-setup.js +192 -80
  97. package/tools/installer/package.json +1 -1
  98. package/tools/upgraders/v3-to-v4-upgrader.js +1 -0
  99. package/test.md +0 -1
  100. /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