bmad-method 4.9.0 → 4.9.2
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/CHANGELOG.md +14 -0
- package/bmad-core/tasks/shard-doc.md +1 -1
- package/bmad-core/templates/architecture-tmpl.md +2 -2
- package/bmad-core/templates/brownfield-architecture-tmpl.md +2 -2
- package/bmad-core/templates/front-end-spec-tmpl.md +1 -1
- package/bmad-core/utils/workflow-management.md +5 -5
- package/bmad-core/workflows/brownfield-service.yml +1 -1
- package/dist/agents/architect.txt +4 -4
- package/dist/agents/bmad-master.txt +11 -11
- package/dist/agents/bmad-orchestrator.txt +5 -5
- package/dist/agents/dev.txt +9 -17
- package/dist/agents/pm.txt +1 -1
- package/dist/agents/po.txt +1 -1
- package/dist/agents/ux-expert.txt +1 -1
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +144 -18
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +139 -95
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +39 -0
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +310 -118
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +16 -16
- package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt +25 -27
- package/dist/teams/team-all.txt +20 -28
- package/dist/teams/team-fullstack.txt +11 -11
- package/dist/teams/team-ide-minimal.txt +15 -23
- package/dist/teams/team-no-ui.txt +10 -10
- package/docs/core-architecture.md +5 -3
- package/docs/how-to-contribute-with-pull-requests.md +6 -6
- package/docs/user-guide.md +51 -66
- package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +107 -87
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.md +4 -4
- package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md +21 -2
- package/expansion-packs/bmad-infrastructure-devops/README.md +5 -5
- package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.md +0 -0
- package/expansion-packs/expansion-creator/tasks/create-agent.md +10 -10
- package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md +2 -4
- package/expansion-packs/expansion-creator/templates/agent-teams-tmpl.md +6 -6
- package/expansion-packs/expansion-creator/templates/agent-tmpl.md +15 -15
- package/expansion-packs/expansion-creator/utils/workflow-management.md +8 -8
- package/package.json +1 -1
- package/tools/installer/README.md +3 -3
- package/tools/installer/package.json +1 -1
|
@@ -109,6 +109,7 @@ Create detailed, actionable game development stories that enable AI developers t
|
|
|
109
109
|
## Prerequisites
|
|
110
110
|
|
|
111
111
|
Before creating stories, ensure you have:
|
|
112
|
+
|
|
112
113
|
- Completed Game Design Document (GDD)
|
|
113
114
|
- Game Architecture Document
|
|
114
115
|
- Epic definition this story belongs to
|
|
@@ -119,12 +120,14 @@ Before creating stories, ensure you have:
|
|
|
119
120
|
### 1. Story Identification
|
|
120
121
|
|
|
121
122
|
**Review Epic Context:**
|
|
123
|
+
|
|
122
124
|
- Understand the epic's overall goal
|
|
123
125
|
- Identify specific features that need implementation
|
|
124
126
|
- Review any existing stories in the epic
|
|
125
127
|
- Ensure no duplicate work
|
|
126
128
|
|
|
127
129
|
**Feature Analysis:**
|
|
130
|
+
|
|
128
131
|
- Reference specific GDD sections
|
|
129
132
|
- Understand player experience goals
|
|
130
133
|
- Identify technical complexity
|
|
@@ -133,12 +136,14 @@ Before creating stories, ensure you have:
|
|
|
133
136
|
### 2. Story Scoping
|
|
134
137
|
|
|
135
138
|
**Single Responsibility:**
|
|
139
|
+
|
|
136
140
|
- Focus on one specific game feature
|
|
137
141
|
- Ensure story is completable in 1-3 days
|
|
138
142
|
- Break down complex features into multiple stories
|
|
139
143
|
- Maintain clear boundaries with other stories
|
|
140
144
|
|
|
141
145
|
**Implementation Clarity:**
|
|
146
|
+
|
|
142
147
|
- Define exactly what needs to be built
|
|
143
148
|
- Specify all technical requirements
|
|
144
149
|
- Include all necessary integration points
|
|
@@ -150,6 +155,7 @@ Before creating stories, ensure you have:
|
|
|
150
155
|
Use `templates#game-story-tmpl` following all embedded LLM instructions
|
|
151
156
|
|
|
152
157
|
**Key Focus Areas:**
|
|
158
|
+
|
|
153
159
|
- Clear, actionable description
|
|
154
160
|
- Specific acceptance criteria
|
|
155
161
|
- Detailed technical specifications
|
|
@@ -159,18 +165,21 @@ Use `templates#game-story-tmpl` following all embedded LLM instructions
|
|
|
159
165
|
### 4. Story Validation
|
|
160
166
|
|
|
161
167
|
**Technical Review:**
|
|
168
|
+
|
|
162
169
|
- Verify all technical specifications are complete
|
|
163
170
|
- Ensure integration points are clearly defined
|
|
164
171
|
- Confirm file paths match architecture
|
|
165
172
|
- Validate TypeScript interfaces and classes
|
|
166
173
|
|
|
167
174
|
**Game Design Alignment:**
|
|
175
|
+
|
|
168
176
|
- Confirm story implements GDD requirements
|
|
169
177
|
- Verify player experience goals are met
|
|
170
178
|
- Check balance parameters are included
|
|
171
179
|
- Ensure game mechanics are correctly interpreted
|
|
172
180
|
|
|
173
181
|
**Implementation Readiness:**
|
|
182
|
+
|
|
174
183
|
- All dependencies identified
|
|
175
184
|
- Assets requirements specified
|
|
176
185
|
- Testing criteria defined
|
|
@@ -182,6 +191,7 @@ Use `templates#game-story-tmpl` following all embedded LLM instructions
|
|
|
182
191
|
Execute `checklists#game-story-dod-checklist` against completed story
|
|
183
192
|
|
|
184
193
|
**Story Criteria:**
|
|
194
|
+
|
|
185
195
|
- Story is immediately actionable
|
|
186
196
|
- No design decisions left to developer
|
|
187
197
|
- Technical requirements are complete
|
|
@@ -191,12 +201,14 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
191
201
|
### 6. Story Refinement
|
|
192
202
|
|
|
193
203
|
**Developer Perspective:**
|
|
204
|
+
|
|
194
205
|
- Can a developer start implementation immediately?
|
|
195
206
|
- Are all technical questions answered?
|
|
196
207
|
- Is the scope appropriate for the estimated points?
|
|
197
208
|
- Are all dependencies clearly identified?
|
|
198
209
|
|
|
199
210
|
**Iterative Improvement:**
|
|
211
|
+
|
|
200
212
|
- Address any gaps or ambiguities
|
|
201
213
|
- Clarify complex technical requirements
|
|
202
214
|
- Ensure story fits within epic scope
|
|
@@ -205,6 +217,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
205
217
|
## Story Elements Checklist
|
|
206
218
|
|
|
207
219
|
### Required Sections
|
|
220
|
+
|
|
208
221
|
- [ ] Clear, specific description
|
|
209
222
|
- [ ] Complete acceptance criteria (functional, technical, game design)
|
|
210
223
|
- [ ] Detailed technical specifications
|
|
@@ -218,6 +231,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
218
231
|
- [ ] Definition of Done checklist
|
|
219
232
|
|
|
220
233
|
### Game-Specific Requirements
|
|
234
|
+
|
|
221
235
|
- [ ] GDD section references
|
|
222
236
|
- [ ] Game mechanic implementation details
|
|
223
237
|
- [ ] Player experience goals
|
|
@@ -227,6 +241,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
227
241
|
- [ ] Cross-platform considerations
|
|
228
242
|
|
|
229
243
|
### Technical Quality
|
|
244
|
+
|
|
230
245
|
- [ ] TypeScript strict mode compliance
|
|
231
246
|
- [ ] Architecture document alignment
|
|
232
247
|
- [ ] Code organization follows standards
|
|
@@ -237,18 +252,21 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
237
252
|
## Common Pitfalls
|
|
238
253
|
|
|
239
254
|
**Scope Issues:**
|
|
255
|
+
|
|
240
256
|
- Story too large (break into multiple stories)
|
|
241
257
|
- Story too vague (add specific requirements)
|
|
242
258
|
- Missing dependencies (identify all prerequisites)
|
|
243
259
|
- Unclear boundaries (define what's in/out of scope)
|
|
244
260
|
|
|
245
261
|
**Technical Issues:**
|
|
262
|
+
|
|
246
263
|
- Missing integration details
|
|
247
264
|
- Incomplete technical specifications
|
|
248
265
|
- Undefined interfaces or classes
|
|
249
266
|
- Missing performance requirements
|
|
250
267
|
|
|
251
268
|
**Game Design Issues:**
|
|
269
|
+
|
|
252
270
|
- Not referencing GDD properly
|
|
253
271
|
- Missing player experience context
|
|
254
272
|
- Unclear game mechanic implementation
|
|
@@ -257,6 +275,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
257
275
|
## Success Criteria
|
|
258
276
|
|
|
259
277
|
**Story Readiness:**
|
|
278
|
+
|
|
260
279
|
- [ ] Developer can start implementation immediately
|
|
261
280
|
- [ ] No additional design decisions required
|
|
262
281
|
- [ ] All technical questions answered
|
|
@@ -265,6 +284,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
265
284
|
- [ ] Story fits within epic scope
|
|
266
285
|
|
|
267
286
|
**Quality Validation:**
|
|
287
|
+
|
|
268
288
|
- [ ] Game story DOD checklist passes
|
|
269
289
|
- [ ] Architecture alignment confirmed
|
|
270
290
|
- [ ] GDD requirements covered
|
|
@@ -274,6 +294,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
274
294
|
## Handoff Protocol
|
|
275
295
|
|
|
276
296
|
**To Game Developer:**
|
|
297
|
+
|
|
277
298
|
1. Provide story document
|
|
278
299
|
2. Confirm GDD and architecture access
|
|
279
300
|
3. Verify all dependencies are met
|
|
@@ -281,6 +302,7 @@ Execute `checklists#game-story-dod-checklist` against completed story
|
|
|
281
302
|
5. Establish check-in schedule
|
|
282
303
|
|
|
283
304
|
**Story Status Updates:**
|
|
305
|
+
|
|
284
306
|
- Draft → Ready for Development
|
|
285
307
|
- In Development → Code Review
|
|
286
308
|
- Code Review → Testing
|
|
@@ -633,6 +655,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
633
655
|
## Story Completeness
|
|
634
656
|
|
|
635
657
|
### Basic Story Elements
|
|
658
|
+
|
|
636
659
|
- [ ] **Story Title** - Clear, descriptive title that identifies the feature
|
|
637
660
|
- [ ] **Epic Assignment** - Story is properly assigned to relevant epic
|
|
638
661
|
- [ ] **Priority Level** - Appropriate priority assigned (High/Medium/Low)
|
|
@@ -640,6 +663,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
640
663
|
- [ ] **Description** - Clear, concise description of what needs to be implemented
|
|
641
664
|
|
|
642
665
|
### Game Design Alignment
|
|
666
|
+
|
|
643
667
|
- [ ] **GDD Reference** - Specific Game Design Document section referenced
|
|
644
668
|
- [ ] **Game Mechanic Context** - Clear connection to game mechanics defined in GDD
|
|
645
669
|
- [ ] **Player Experience Goal** - Describes the intended player experience
|
|
@@ -649,6 +673,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
649
673
|
## Technical Specifications
|
|
650
674
|
|
|
651
675
|
### Architecture Compliance
|
|
676
|
+
|
|
652
677
|
- [ ] **File Organization** - Follows game architecture document structure
|
|
653
678
|
- [ ] **Class Definitions** - TypeScript interfaces and classes are properly defined
|
|
654
679
|
- [ ] **Integration Points** - Clear specification of how feature integrates with existing systems
|
|
@@ -656,6 +681,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
656
681
|
- [ ] **Dependencies** - All system dependencies clearly identified
|
|
657
682
|
|
|
658
683
|
### Phaser 3 Requirements
|
|
684
|
+
|
|
659
685
|
- [ ] **Scene Integration** - Specifies which scenes are affected and how
|
|
660
686
|
- [ ] **Game Object Usage** - Proper use of Phaser 3 game objects and components
|
|
661
687
|
- [ ] **Physics Integration** - Physics requirements specified if applicable
|
|
@@ -663,6 +689,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
663
689
|
- [ ] **Performance Considerations** - 60 FPS target and optimization requirements
|
|
664
690
|
|
|
665
691
|
### Code Quality Standards
|
|
692
|
+
|
|
666
693
|
- [ ] **TypeScript Strict Mode** - All code must comply with strict TypeScript
|
|
667
694
|
- [ ] **Error Handling** - Error scenarios and handling requirements specified
|
|
668
695
|
- [ ] **Memory Management** - Object pooling and cleanup requirements where needed
|
|
@@ -672,6 +699,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
672
699
|
## Implementation Readiness
|
|
673
700
|
|
|
674
701
|
### Acceptance Criteria
|
|
702
|
+
|
|
675
703
|
- [ ] **Functional Requirements** - All functional acceptance criteria are specific and testable
|
|
676
704
|
- [ ] **Technical Requirements** - Technical acceptance criteria are complete and verifiable
|
|
677
705
|
- [ ] **Game Design Requirements** - Game-specific requirements match GDD specifications
|
|
@@ -679,6 +707,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
679
707
|
- [ ] **Completeness** - No acceptance criteria are vague or unmeasurable
|
|
680
708
|
|
|
681
709
|
### Implementation Tasks
|
|
710
|
+
|
|
682
711
|
- [ ] **Task Breakdown** - Story broken into specific, ordered implementation tasks
|
|
683
712
|
- [ ] **Task Scope** - Each task is completable in 1-4 hours
|
|
684
713
|
- [ ] **Task Clarity** - Each task has clear, actionable instructions
|
|
@@ -686,6 +715,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
686
715
|
- [ ] **Development Flow** - Tasks follow logical implementation order
|
|
687
716
|
|
|
688
717
|
### Dependencies
|
|
718
|
+
|
|
689
719
|
- [ ] **Story Dependencies** - All prerequisite stories identified with IDs
|
|
690
720
|
- [ ] **Technical Dependencies** - Required systems and files identified
|
|
691
721
|
- [ ] **Asset Dependencies** - All needed assets specified with locations
|
|
@@ -695,6 +725,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
695
725
|
## Testing Requirements
|
|
696
726
|
|
|
697
727
|
### Test Coverage
|
|
728
|
+
|
|
698
729
|
- [ ] **Unit Test Requirements** - Specific unit test files and scenarios defined
|
|
699
730
|
- [ ] **Integration Test Cases** - Integration testing with other game systems specified
|
|
700
731
|
- [ ] **Manual Test Cases** - Game-specific manual testing procedures defined
|
|
@@ -702,6 +733,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
702
733
|
- [ ] **Edge Case Testing** - Edge cases and error conditions covered
|
|
703
734
|
|
|
704
735
|
### Test Implementation
|
|
736
|
+
|
|
705
737
|
- [ ] **Test File Paths** - Exact test file locations specified
|
|
706
738
|
- [ ] **Test Scenarios** - All test scenarios are complete and executable
|
|
707
739
|
- [ ] **Expected Behaviors** - Clear expected outcomes for all tests defined
|
|
@@ -711,6 +743,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
711
743
|
## Game-Specific Quality
|
|
712
744
|
|
|
713
745
|
### Gameplay Implementation
|
|
746
|
+
|
|
714
747
|
- [ ] **Mechanic Accuracy** - Implementation matches GDD mechanic specifications
|
|
715
748
|
- [ ] **Player Controls** - Input handling requirements are complete
|
|
716
749
|
- [ ] **Game Feel** - Requirements for juice, feedback, and responsiveness specified
|
|
@@ -718,6 +751,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
718
751
|
- [ ] **State Management** - Game state changes and persistence requirements defined
|
|
719
752
|
|
|
720
753
|
### User Experience
|
|
754
|
+
|
|
721
755
|
- [ ] **UI Requirements** - User interface elements and behaviors specified
|
|
722
756
|
- [ ] **Audio Integration** - Sound effect and music requirements defined
|
|
723
757
|
- [ ] **Visual Feedback** - Animation and visual effect requirements specified
|
|
@@ -725,6 +759,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
725
759
|
- [ ] **Error Recovery** - User-facing error handling and recovery specified
|
|
726
760
|
|
|
727
761
|
### Performance Optimization
|
|
762
|
+
|
|
728
763
|
- [ ] **Frame Rate Targets** - Specific FPS requirements for different platforms
|
|
729
764
|
- [ ] **Memory Usage** - Memory consumption limits and monitoring requirements
|
|
730
765
|
- [ ] **Asset Optimization** - Texture, audio, and data optimization requirements
|
|
@@ -734,6 +769,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
734
769
|
## Documentation and Communication
|
|
735
770
|
|
|
736
771
|
### Story Documentation
|
|
772
|
+
|
|
737
773
|
- [ ] **Implementation Notes** - Additional context and implementation guidance provided
|
|
738
774
|
- [ ] **Design Decisions** - Key design choices documented with rationale
|
|
739
775
|
- [ ] **Future Considerations** - Potential future enhancements or modifications noted
|
|
@@ -741,6 +777,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
741
777
|
- [ ] **Reference Materials** - Links to relevant GDD sections and architecture docs
|
|
742
778
|
|
|
743
779
|
### Developer Handoff
|
|
780
|
+
|
|
744
781
|
- [ ] **Immediate Actionability** - Developer can start implementation without additional questions
|
|
745
782
|
- [ ] **Complete Context** - All necessary context provided within the story
|
|
746
783
|
- [ ] **Clear Boundaries** - What is and isn't included in the story scope is clear
|
|
@@ -750,6 +787,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
750
787
|
## Final Validation
|
|
751
788
|
|
|
752
789
|
### Story Readiness
|
|
790
|
+
|
|
753
791
|
- [ ] **No Ambiguity** - No sections require interpretation or additional design decisions
|
|
754
792
|
- [ ] **Technical Completeness** - All technical requirements are specified and actionable
|
|
755
793
|
- [ ] **Scope Appropriateness** - Story scope matches assigned story points
|
|
@@ -757,6 +795,7 @@ class {{ClassName}} extends {{PhaseClass}} {
|
|
|
757
795
|
- [ ] **Review Completion** - Story has been reviewed for completeness and accuracy
|
|
758
796
|
|
|
759
797
|
### Implementation Preparedness
|
|
798
|
+
|
|
760
799
|
- [ ] **Environment Ready** - Development environment requirements specified
|
|
761
800
|
- [ ] **Resources Available** - All required resources (assets, docs, dependencies) accessible
|
|
762
801
|
- [ ] **Testing Prepared** - Testing environment and data requirements specified
|