bmad-method 4.42.1 → 4.43.1

package/expansion-packs/bmad-godot-game-dev/checklists/game-story-dod-checklist.md

@@ -0,0 +1,202 @@
+# Game Development Story Definition of Done (DoD) Checklist (Godot)
+
+## Instructions for Developer Agent
+
+Before marking a story as 'Ready for Review', please go through each item in this checklist. Report the status of each item (e.g., [x] Done, [ ] Not Done, [N/A] Not Applicable) and provide brief comments if necessary.
+
+[[LLM: INITIALIZATION INSTRUCTIONS - GODOT GAME STORY DOD VALIDATION
+
+This checklist is for GAME DEVELOPER AGENTS to self-validate their Godot implementation work before marking a story complete.
+
+IMPORTANT: This is a self-assessment following TDD principles. Be honest about what's actually done vs what should be done. Performance targets (60+ FPS) are non-negotiable.
+
+EXECUTION APPROACH:
+
+1. Verify tests were written FIRST (TDD compliance)
+2. Go through each section systematically
+3. Mark items as [x] Done, [ ] Not Done, or [N/A] Not Applicable
+4. Add brief comments explaining any [ ] or [N/A] items
+5. Report performance metrics (FPS, draw calls, memory)
+6. Flag any technical debt or optimization needs
+
+The goal is performant, tested, quality delivery following John Carmack's optimization philosophy.]]
+
+## Checklist Items
+
+1. **Test-Driven Development Compliance:**
+
+   [[LLM: TDD is mandatory. Tests must be written FIRST. No exceptions.]]
+   - [ ] Tests were written BEFORE implementation (Red phase)
+   - [ ] Tests initially failed as expected
+   - [ ] Implementation made tests pass (Green phase)
+   - [ ] Code was refactored while maintaining passing tests (Refactor phase)
+   - [ ] GUT tests written for all GDScript code
+   - [ ] GoDotTest tests written for all C# code
+   - [ ] Test coverage meets 80% minimum requirement
+   - [ ] Performance benchmarks defined and passing
+
+2. **Requirements & Game Design:**
+
+   [[LLM: Requirements drive implementation. GDD alignment is critical.]]
+   - [ ] All functional requirements from story implemented
+   - [ ] All acceptance criteria met and tested
+   - [ ] Game Design Document (GDD) requirements implemented
+   - [ ] Player experience goals achieved
+   - [ ] Core gameplay loop functions correctly
+   - [ ] Fun factor validated through testing
+
+3. **Godot Standards & Architecture:**
+
+   [[LLM: Godot best practices ensure maintainability and performance.]]
+   - [ ] Node hierarchy follows Godot conventions
+   - [ ] Scene composition patterns properly used
+   - [ ] Signal connections documented and optimized
+   - [ ] Autoload/singleton usage justified
+   - [ ] Resource system used appropriately
+   - [ ] Export variables properly configured
+   - [ ] Node groups used for efficient queries
+   - [ ] Scene inheritance utilized where appropriate
+
+4. **Code Quality & Language Strategy:**
+
+   [[LLM: Language choice impacts performance. GDScript for iteration, C# for computation.]]
+   - [ ] GDScript code uses static typing throughout
+   - [ ] C# code follows .NET conventions
+   - [ ] Language choice (GDScript vs C#) justified for each system
+   - [ ] Interop between languages minimized
+   - [ ] Memory management patterns followed (pooling, references)
+   - [ ] No GDScript/C# marshalling in hot paths
+   - [ ] Code comments explain optimization decisions
+   - [ ] No new script errors or warnings
+
+5. **Performance Validation:**
+
+   [[LLM: 60+ FPS is the minimum, not the target. Profile everything.]]
+   - [ ] Stable 60+ FPS achieved on target hardware
+   - [ ] Frame time consistently under 16.67ms
+   - [ ] Draw calls within budget for scene type
+   - [ ] Memory usage within platform limits
+   - [ ] No memory leaks detected
+   - [ ] Object pooling implemented where needed
+   - [ ] Godot profiler shows no bottlenecks
+   - [ ] Performance regression tests pass
+
+6. **Platform Testing:**
+
+   [[LLM: Test on all target platforms. Platform-specific issues kill games.]]
+   - [ ] Functionality verified in Godot Editor
+   - [ ] Desktop export tested (Windows/Mac/Linux)
+   - [ ] Mobile export tested if applicable (iOS/Android)
+   - [ ] Web export tested if applicable (HTML5)
+   - [ ] Input handling works on all platforms
+   - [ ] Platform-specific optimizations applied
+   - [ ] Export settings properly configured
+   - [ ] Build sizes within acceptable limits
+
+7. **Game Functionality:**
+
+   [[LLM: Games must be fun AND functional. Test the player experience.]]
+   - [ ] Game mechanics work as specified
+   - [ ] Player controls responsive (<50ms input latency)
+   - [ ] UI elements function correctly (Control nodes)
+   - [ ] Audio integration works (AudioStreamPlayer)
+   - [ ] Visual feedback and animations smooth
+   - [ ] Particle effects within performance budget
+   - [ ] Save/load system functions correctly
+   - [ ] Scene transitions work smoothly
+
+8. **Testing Coverage:**
+
+   [[LLM: Comprehensive testing prevents player frustration.]]
+   - [ ] Unit tests (GUT/GoDotTest) all passing
+   - [ ] Integration tests for scene interactions pass
+   - [ ] Performance tests meet benchmarks
+   - [ ] Edge cases and error conditions handled
+   - [ ] Multiplayer tests pass (if applicable)
+   - [ ] Platform-specific tests complete
+   - [ ] Regression tests for existing features pass
+   - [ ] Manual playtesting completed
+
+9. **Story Administration:**
+
+   [[LLM: Documentation enables team collaboration.]]
+   - [ ] All tasks within story marked complete [x]
+   - [ ] Implementation decisions documented
+   - [ ] Performance optimizations noted
+   - [ ] File List section updated with all changes
+   - [ ] Debug Log references added
+   - [ ] Completion Notes comprehensive
+   - [ ] Change Log updated
+   - [ ] Status set to 'Ready for Review'
+
+10. **Project & Dependencies:**
+
+    [[LLM: Project must build and run. Dependencies must be justified.]]
+    - [ ] Godot project opens without errors
+    - [ ] Project exports successfully for all platforms
+    - [ ] Any new plugins/addons pre-approved
+    - [ ] Asset import settings optimized
+    - [ ] Project settings properly configured
+    - [ ] Version control files (.tscn/.tres) clean
+    - [ ] No uncommitted debug code
+    - [ ] Build automation scripts updated
+
+11. **Optimization & Polish:**
+
+    [[LLM: Following Carmack's philosophy - measure, optimize, verify.]]
+    - [ ] Hot paths identified and optimized
+    - [ ] Critical code moved to C# if needed
+    - [ ] Draw call batching implemented
+    - [ ] Texture atlasing used where appropriate
+    - [ ] LOD system implemented if needed
+    - [ ] Occlusion culling configured
+    - [ ] Static typing used throughout GDScript
+    - [ ] Signal connections optimized
+
+12. **Documentation:**
+
+    [[LLM: Good documentation prevents future confusion.]]
+    - [ ] GDScript documentation comments complete
+    - [ ] C# XML documentation complete
+    - [ ] Node purposes documented in scenes
+    - [ ] Export variable tooltips added
+    - [ ] Performance notes included
+    - [ ] Platform-specific notes documented
+    - [ ] Known issues or limitations noted
+
+## Performance Metrics Report
+
+[[LLM: Report actual performance metrics, not estimates.]]
+
+- **Frame Rate:** \_\_\_ FPS (Target: 60+)
+- **Frame Time:** \_\_\_ ms (Target: <16.67ms)
+- **Draw Calls:** **_ (Budget: _**)
+- **Memory Usage:** **_ MB (Limit: _**)
+- **Scene Load Time:** \_\_\_ seconds
+- **Input Latency:** \_\_\_ ms
+- **Test Coverage:** \_\_\_% (Minimum: 80%)
+
+## Final Confirmation
+
+[[LLM: FINAL GODOT DOD SUMMARY
+
+After completing the checklist:
+
+1. Confirm TDD was followed (tests written first)
+2. Report performance metrics with specific numbers
+3. List any items marked [ ] with explanations
+4. Identify optimization opportunities
+5. Note any technical debt created
+6. Confirm the story is truly ready for review
+7. State whether 60+ FPS target is met
+
+Remember Carmack's principle: "Focus on what matters: framerate and responsiveness."
+
+Be honest - performance issues and bugs found now are easier to fix than after release.]]
+
+- [ ] I, the Game Developer Agent, confirm that:
+  - [ ] TDD was followed (tests written first)
+  - [ ] All applicable items above have been addressed
+  - [ ] Performance targets (60+ FPS) are met
+  - [ ] Tests provide 80%+ coverage
+  - [ ] The story is ready for review

package/expansion-packs/bmad-godot-game-dev/config.yaml

@@ -0,0 +1,30 @@
+name: bmad-godot-game-dev
+version: 1.0.0
+short-title: Godot Game Dev Pack
+description: Game Development expansion pack for BMad Method - Godot GDscript & C# focused
+author: sjennings (Lum), based on BMAD Unity Game Dev expansion pack by pbean (PinkyD)
+slashPrefix: BmadG
+markdownExploder: true
+qa:
+  qaLocation: docs/qa
+prd:
+  prdFile: docs/prd.md
+  prdVersion: v4
+  prdSharded: true
+  prdShardedLocation: docs/prd
+  epicFilePattern: epic-{n}*.md
+architecture:
+  architectureFile: docs/architecture.md
+  architectureVersion: v4
+  architectureSharded: true
+  architectureShardedLocation: docs/architecture
+customTechnicalDocuments: null
+devLoadAlwaysFiles:
+  - docs/architecture/coding-standards.md
+  - docs/architecture/tech-stack.md
+  - docs/architecture/source-tree.md
+  - docs/architecture/testing-strategy-and-standards.md
+qaLoadAlwaysFiles:
+  - docs/architecture/testing-strategy-and-standards.md
+devDebugLog: .ai/debug-log.md
+devStoryLocation: docs/stories