bmad-method 4.30.1 → 4.30.3

package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md

@@ -0,0 +1,160 @@
+# Game Development Story Definition of Done Checklist
+
+## Story Completeness
+
+### Basic Story Elements
+
+- [ ] **Story Title** - Clear, descriptive title that identifies the feature
+- [ ] **Epic Assignment** - Story is properly assigned to relevant epic
+- [ ] **Priority Level** - Appropriate priority assigned (High/Medium/Low)
+- [ ] **Story Points** - Realistic estimation for implementation complexity
+- [ ] **Description** - Clear, concise description of what needs to be implemented
+
+### Game Design Alignment
+
+- [ ] **GDD Reference** - Specific Game Design Document section referenced
+- [ ] **Game Mechanic Context** - Clear connection to game mechanics defined in GDD
+- [ ] **Player Experience Goal** - Describes the intended player experience
+- [ ] **Balance Parameters** - Includes any relevant game balance values
+- [ ] **Design Intent** - Purpose and rationale for the feature is clear
+
+## Technical Specifications
+
+### Architecture Compliance
+
+- [ ] **File Organization** - Follows game architecture document structure (e.g., scripts, prefabs, scenes)
+- [ ] **Class Definitions** - C# classes and interfaces are properly defined
+- [ ] **Integration Points** - Clear specification of how feature integrates with existing systems
+- [ ] **Event Communication** - UnityEvents or C# events usage specified
+- [ ] **Dependencies** - All system dependencies clearly identified
+
+### Unity Requirements
+
+- [ ] **Scene Integration** - Specifies which scenes are affected and how
+- [ ] **Prefab Usage** - Proper use of prefabs for reusable GameObjects
+- [ ] **Component Design** - Logic is encapsulated in well-defined MonoBehaviour components
+- [ ] **Asset Requirements** - All needed assets (sprites, audio, materials) identified
+- [ ] **Performance Considerations** - Stable frame rate target and optimization requirements
+
+### Code Quality Standards
+
+- [ ] **C# Best Practices** - All code must comply with modern C# standards
+- [ ] **Error Handling** - Error scenarios and handling requirements specified
+- [ ] **Memory Management** - Coroutine and object lifecycle management requirements where needed
+- [ ] **Cross-Platform Support** - Desktop and mobile considerations addressed
+- [ ] **Code Organization** - Follows established Unity project structure
+
+## Implementation Readiness
+
+### Acceptance Criteria
+
+- [ ] **Functional Requirements** - All functional acceptance criteria are specific and testable
+- [ ] **Technical Requirements** - Technical acceptance criteria are complete and verifiable
+- [ ] **Game Design Requirements** - Game-specific requirements match GDD specifications
+- [ ] **Performance Requirements** - Frame rate and memory usage criteria specified
+- [ ] **Completeness** - No acceptance criteria are vague or unmeasurable
+
+### Implementation Tasks
+
+- [ ] **Task Breakdown** - Story broken into specific, ordered implementation tasks
+- [ ] **Task Scope** - Each task is completable in 1-4 hours
+- [ ] **Task Clarity** - Each task has clear, actionable instructions
+- [ ] **File Specifications** - Exact file paths and purposes specified (e.g., `Scripts/Player/PlayerMovement.cs`)
+- [ ] **Development Flow** - Tasks follow logical implementation order
+
+### Dependencies
+
+- [ ] **Story Dependencies** - All prerequisite stories identified with IDs
+- [ ] **Technical Dependencies** - Required systems and files identified
+- [ ] **Asset Dependencies** - All needed assets specified with locations
+- [ ] **External Dependencies** - Any third-party or external requirements noted (e.g., Asset Store packages)
+- [ ] **Dependency Validation** - All dependencies are actually available
+
+## Testing Requirements
+
+### Test Coverage
+
+- [ ] **Unit Test Requirements** - Specific unit test files and scenarios defined for NUnit
+- [ ] **Integration Test Cases** - Integration testing with other game systems specified
+- [ ] **Manual Test Cases** - Game-specific manual testing procedures defined in the Unity Editor
+- [ ] **Performance Tests** - Frame rate and memory testing requirements specified
+- [ ] **Edge Case Testing** - Edge cases and error conditions covered
+
+### Test Implementation
+
+- [ ] **Test File Paths** - Exact test file locations specified (e.g., `Assets/Tests/EditMode`)
+- [ ] **Test Scenarios** - All test scenarios are complete and executable
+- [ ] **Expected Behaviors** - Clear expected outcomes for all tests defined
+- [ ] **Performance Metrics** - Specific performance targets for testing
+- [ ] **Test Data** - Any required test data or mock objects specified
+
+## Game-Specific Quality
+
+### Gameplay Implementation
+
+- [ ] **Mechanic Accuracy** - Implementation matches GDD mechanic specifications
+- [ ] **Player Controls** - Input handling requirements are complete (e.g., Input System package)
+- [ ] **Game Feel** - Requirements for juice, feedback, and responsiveness specified
+- [ ] **Balance Implementation** - Numeric values and parameters from GDD included
+- [ ] **State Management** - Game state changes and persistence requirements defined
+
+### User Experience
+
+- [ ] **UI Requirements** - User interface elements and behaviors specified (e.g., UI Toolkit or UGUI)
+- [ ] **Audio Integration** - Sound effect and music requirements defined
+- [ ] **Visual Feedback** - Animation and visual effect requirements specified (e.g., Animator, Particle System)
+- [ ] **Accessibility** - Mobile touch and responsive design considerations
+- [ ] **Error Recovery** - User-facing error handling and recovery specified
+
+### Performance Optimization
+
+- [ ] **Frame Rate Targets** - Specific FPS requirements for different platforms
+- [ ] **Memory Usage** - Memory consumption limits and monitoring requirements (e.g., Profiler)
+- [ ] **Asset Optimization** - Texture, audio, and data optimization requirements
+- [ ] **Mobile Considerations** - Touch controls and mobile performance requirements
+- [ ] **Loading Performance** - Asset loading and scene transition requirements
+
+## Documentation and Communication
+
+### Story Documentation
+
+- [ ] **Implementation Notes** - Additional context and implementation guidance provided
+- [ ] **Design Decisions** - Key design choices documented with rationale
+- [ ] **Future Considerations** - Potential future enhancements or modifications noted
+- [ ] **Change Tracking** - Process for tracking any requirement changes during development
+- [ ] **Reference Materials** - Links to relevant GDD sections and architecture docs
+
+### Developer Handoff
+
+- [ ] **Immediate Actionability** - Developer can start implementation without additional questions
+- [ ] **Complete Context** - All necessary context provided within the story
+- [ ] **Clear Boundaries** - What is and isn't included in the story scope is clear
+- [ ] **Success Criteria** - Objective measures for story completion defined
+- [ ] **Communication Plan** - Process for developer questions and updates established
+
+## Final Validation
+
+### Story Readiness
+
+- [ ] **No Ambiguity** - No sections require interpretation or additional design decisions
+- [ ] **Technical Completeness** - All technical requirements are specified and actionable
+- [ ] **Scope Appropriateness** - Story scope matches assigned story points
+- [ ] **Quality Standards** - Story meets all game development quality standards
+- [ ] **Review Completion** - Story has been reviewed for completeness and accuracy
+
+### Implementation Preparedness
+
+- [ ] **Environment Ready** - Development environment requirements specified (e.g., Unity version)
+- [ ] **Resources Available** - All required resources (assets, docs, dependencies) accessible
+- [ ] **Testing Prepared** - Testing environment and data requirements specified
+- [ ] **Definition of Done** - Clear, objective completion criteria established
+- [ ] **Handoff Complete** - Story is ready for developer assignment and implementation
+
+## Checklist Completion
+
+**Overall Story Quality:** ⭐⭐⭐⭐⭐
+
+**Ready for Development:** [ ] Yes [ ] No
+
+**Additional Notes:**
+_Any specific concerns, recommendations, or clarifications needed before development begins._

package/expansion-packs/bmad-2d-unity-game-dev/config.yaml

@@ -0,0 +1,6 @@
+name: bmad-2d-unity-game-dev
+version: 1.2.0
+short-title: Unity C# 2D Game Dev Pack
+description: 2D Game Development expansion pack for BMad Method - Unity & C# focused
+author: pbean (PinkyD)
+slashPrefix: bmad2du

package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md

@@ -0,0 +1,251 @@
+# Game Development BMad Knowledge Base
+
+## Overview
+
+This game development expansion of BMad-Method specializes in creating 2D games using Unity and C#. It extends the core BMad framework with game-specific agents, workflows, and best practices for professional game development.
+
+### Game Development Focus
+
+- **Target Engine**: Unity 2022 LTS or newer with C# 10+
+- **Platform Strategy**: Cross-platform (PC, Console, Mobile) with a focus on 2D
+- **Development Approach**: Agile story-driven development
+- **Performance Target**: Stable frame rate on target devices
+- **Architecture**: Component-based architecture using Unity's best practices
+
+## Core Game Development Philosophy
+
+### Player-First Development
+
+You are developing games as a "Player Experience CEO" - thinking like a game director with unlimited creative resources and a singular vision for player enjoyment. Your AI agents are your specialized game development team:
+
+- **Direct**: Provide clear game design vision and player experience goals
+- **Refine**: Iterate on gameplay mechanics until they're compelling
+- **Oversee**: Maintain creative alignment across all development disciplines
+- **Playfocus**: Every decision serves the player experience
+
+### Game Development Principles
+
+1. **PLAYER_EXPERIENCE_FIRST**: Every mechanic must serve player engagement and fun
+2. **ITERATIVE_DESIGN**: Prototype, test, refine - games are discovered through iteration
+3. **TECHNICAL_EXCELLENCE**: Stable performance and cross-platform compatibility are non-negotiable
+4. **STORY_DRIVEN_DEV**: Game features are implemented through detailed development stories
+5. **BALANCE_THROUGH_DATA**: Use metrics and playtesting to validate game balance
+6. **DOCUMENT_EVERYTHING**: Clear specifications enable proper game implementation
+7. **START_SMALL_ITERATE_FAST**: Core mechanics first, then expand and polish
+8. **EMBRACE_CREATIVE_CHAOS**: Games evolve - adapt design based on what's fun
+
+## Game Development Workflow
+
+### Phase 1: Game Concept and Design
+
+1. **Game Designer**: Start with brainstorming and concept development
+
+   - Use \*brainstorm to explore game concepts and mechanics
+   - Create Game Brief using game-brief-tmpl
+   - Develop core game pillars and player experience goals
+
+2. **Game Designer**: Create comprehensive Game Design Document
+
+   - Use game-design-doc-tmpl to create detailed GDD
+   - Define all game mechanics, progression, and balance
+   - Specify technical requirements and platform targets
+
+3. **Game Designer**: Develop Level Design Framework
+   - Create level-design-doc-tmpl for content guidelines
+   - Define level types, difficulty progression, and content structure
+   - Establish performance and technical constraints for levels
+
+### Phase 2: Technical Architecture
+
+4. **Solution Architect** (or Game Designer): Create Technical Architecture
+   - Use game-architecture-tmpl to design technical implementation
+   - Define Unity systems, performance optimization, and C# code structure
+   - Align technical architecture with game design requirements
+
+### Phase 3: Story-Driven Development
+
+5. **Game Scrum Master**: Break down design into development stories
+
+   - Use create-game-story task to create detailed implementation stories
+   - Each story should be immediately actionable by game developers
+   - Apply game-story-dod-checklist to ensure story quality
+
+6. **Game Developer**: Implement game features story by story
+
+   - Follow C# best practices and Unity's component-based architecture
+   - Maintain stable frame rate on target devices
+   - Use Unity Test Framework for game logic components
+
+7. **Iterative Refinement**: Continuous playtesting and improvement
+   - Test core mechanics early and often in the Unity Editor
+   - Validate game balance through metrics and player feedback
+   - Iterate on design based on implementation discoveries
+
+## Game-Specific Development Guidelines
+
+### Unity + C# Standards
+
+**Project Structure:**
+
+```text
+UnityProject/
+├── Assets/
+│   ├── Scenes/          # Game scenes (Boot, Menu, Game, etc.)
+│   ├── Scripts/         # C# scripts
+│   │   ├── Editor/      # Editor-specific scripts
+│   │   └── Runtime/     # Runtime scripts
+│   ├── Prefabs/         # Reusable game objects
+│   ├── Art/             # Art assets (sprites, models, etc.)
+│   ├── Audio/           # Audio assets
+│   ├── Data/            # ScriptableObjects and other data
+│   └── Tests/           # Unity Test Framework tests
+│       ├── EditMode/
+│       └── PlayMode/
+├── Packages/            # Package Manager manifest
+└── ProjectSettings/     # Unity project settings
+```
+
+**Performance Requirements:**
+
+- Maintain stable frame rate on target devices
+- Memory usage under specified limits per level
+- Loading times under 3 seconds for levels
+- Smooth animation and responsive controls
+
+**Code Quality:**
+
+- C# best practices compliance
+- Component-based architecture (SOLID principles)
+- Efficient use of the MonoBehaviour lifecycle
+- Error handling and graceful degradation
+
+### Game Development Story Structure
+
+**Story Requirements:**
+
+- Clear reference to Game Design Document section
+- Specific acceptance criteria for game functionality
+- Technical implementation details for Unity and C#
+- Performance requirements and optimization considerations
+- Testing requirements including gameplay validation
+
+**Story Categories:**
+
+- **Core Mechanics**: Fundamental gameplay systems
+- **Level Content**: Individual levels and content implementation
+- **UI/UX**: User interface and player experience features
+- **Performance**: Optimization and technical improvements
+- **Polish**: Visual effects, audio, and game feel enhancements
+
+### Quality Assurance for Games
+
+**Testing Approach:**
+
+- Unit tests for C# logic (EditMode tests)
+- Integration tests for game systems (PlayMode tests)
+- Performance benchmarking and profiling with Unity Profiler
+- Gameplay testing and balance validation
+- Cross-platform compatibility testing
+
+**Performance Monitoring:**
+
+- Frame rate consistency tracking
+- Memory usage monitoring
+- Asset loading performance
+- Input responsiveness validation
+- Battery usage optimization (mobile)
+
+## Game Development Team Roles
+
+### Game Designer (Alex)
+
+- **Primary Focus**: Game mechanics, player experience, design documentation
+- **Key Outputs**: Game Brief, Game Design Document, Level Design Framework
+- **Specialties**: Brainstorming, game balance, player psychology, creative direction
+
+### Game Developer (Maya)
+
+- **Primary Focus**: Unity implementation, C# excellence, performance
+- **Key Outputs**: Working game features, optimized code, technical architecture
+- **Specialties**: C#/Unity, performance optimization, cross-platform development
+
+### Game Scrum Master (Jordan)
+
+- **Primary Focus**: Story creation, development planning, agile process
+- **Key Outputs**: Detailed implementation stories, sprint planning, quality assurance
+- **Specialties**: Story breakdown, developer handoffs, process optimization
+
+## Platform-Specific Considerations
+
+### Cross-Platform Development
+
+- Abstract input using the new Input System
+- Use platform-dependent compilation for specific logic
+- Test on all target platforms regularly
+- Optimize for different screen resolutions and aspect ratios
+
+### Mobile Optimization
+
+- Touch gesture support and responsive controls
+- Battery usage optimization
+- Performance scaling for different device capabilities
+- App store compliance and packaging
+
+### Performance Targets
+
+- **PC/Console**: 60+ FPS at target resolution
+- **Mobile**: 60 FPS on mid-range devices, 30 FPS minimum on low-end
+- **Loading**: Initial load under 5 seconds, scene transitions under 2 seconds
+- **Memory**: Within platform-specific memory budgets
+
+## Success Metrics for Game Development
+
+### Technical Metrics
+
+- Frame rate consistency (>90% of time at target FPS)
+- Memory usage within budgets
+- Loading time targets met
+- Zero critical bugs in core gameplay systems
+
+### Player Experience Metrics
+
+- Tutorial completion rate >80%
+- Level completion rates appropriate for difficulty curve
+- Average session length meets design targets
+- Player retention and engagement metrics
+
+### Development Process Metrics
+
+- Story completion within estimated timeframes
+- Code quality metrics (test coverage, code analysis)
+- Documentation completeness and accuracy
+- Team velocity and delivery consistency
+
+## Common Unity Development Patterns
+
+### Scene Management
+
+- Use a loading scene for asynchronous loading of game scenes
+- Use additive scene loading for large levels or streaming
+- Manage scenes with a dedicated SceneManager class
+
+### Game State Management
+
+- Use ScriptableObjects to store shared game state
+- Implement a finite state machine (FSM) for complex behaviors
+- Use a GameManager singleton for global state management
+
+### Input Handling
+
+- Use the new Input System for robust, cross-platform input
+- Create Action Maps for different input contexts (e.g., menu, gameplay)
+- Use PlayerInput component for easy player input handling
+
+### Performance Optimization
+
+- Object pooling for frequently instantiated objects (e.g., bullets, enemies)
+- Use the Unity Profiler to identify performance bottlenecks
+- Optimize physics settings and collision detection
+- Use LOD (Level of Detail) for complex models
+
+This knowledge base provides the foundation for effective game development using the BMad-Method framework with specialized focus on 2D game creation using Unity and C#.