bmad-method 4.9.0 → 4.9.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 (39) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/bmad-core/tasks/shard-doc.md +1 -1
  3. package/bmad-core/templates/architecture-tmpl.md +2 -2
  4. package/bmad-core/templates/brownfield-architecture-tmpl.md +2 -2
  5. package/bmad-core/templates/front-end-spec-tmpl.md +1 -1
  6. package/bmad-core/utils/workflow-management.md +5 -5
  7. package/dist/agents/architect.txt +4 -4
  8. package/dist/agents/bmad-master.txt +11 -11
  9. package/dist/agents/bmad-orchestrator.txt +5 -5
  10. package/dist/agents/dev.txt +9 -17
  11. package/dist/agents/pm.txt +1 -1
  12. package/dist/agents/po.txt +1 -1
  13. package/dist/agents/ux-expert.txt +1 -1
  14. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +144 -18
  15. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +139 -95
  16. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +39 -0
  17. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +310 -118
  18. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +16 -16
  19. package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt +25 -27
  20. package/dist/teams/team-all.txt +20 -28
  21. package/dist/teams/team-fullstack.txt +11 -11
  22. package/dist/teams/team-ide-minimal.txt +15 -23
  23. package/dist/teams/team-no-ui.txt +10 -10
  24. package/docs/core-architecture.md +5 -3
  25. package/docs/how-to-contribute-with-pull-requests.md +6 -6
  26. package/docs/user-guide.md +51 -66
  27. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +107 -87
  28. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.md +4 -4
  29. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md +21 -2
  30. package/expansion-packs/bmad-infrastructure-devops/README.md +5 -5
  31. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.md +0 -0
  32. package/expansion-packs/expansion-creator/tasks/create-agent.md +10 -10
  33. package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md +2 -4
  34. package/expansion-packs/expansion-creator/templates/agent-teams-tmpl.md +6 -6
  35. package/expansion-packs/expansion-creator/templates/agent-tmpl.md +15 -15
  36. package/expansion-packs/expansion-creator/utils/workflow-management.md +8 -8
  37. package/package.json +1 -1
  38. package/tools/installer/README.md +3 -3
  39. 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