bmad-method 5.0.0 → 5.1.0

package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md

@@ -0,0 +1,201 @@
+# Game Design Document Quality Checklist
+
+## Document Completeness
+
+### Executive Summary
+
+- [ ] **Core Concept** - Game concept is clearly explained in 2-3 sentences
+- [ ] **Target Audience** - Primary and secondary audiences defined with demographics
+- [ ] **Platform Requirements** - Technical platforms and requirements specified
+- [ ] **Unique Selling Points** - 3-5 key differentiators from competitors identified
+- [ ] **Technical Foundation** - Phaser 3 + TypeScript requirements confirmed
+
+### Game Design Foundation
+
+- [ ] **Game Pillars** - 3-5 core design pillars defined and actionable
+- [ ] **Core Gameplay Loop** - 30-60 second loop documented with specific timings
+- [ ] **Win/Loss Conditions** - Clear victory and failure states defined
+- [ ] **Player Motivation** - Clear understanding of why players will engage
+- [ ] **Scope Realism** - Game scope is achievable with available resources
+
+## Gameplay Mechanics
+
+### Core Mechanics Documentation
+
+- [ ] **Primary Mechanics** - 3-5 core mechanics detailed with implementation notes
+- [ ] **Mechanic Integration** - How mechanics work together is clear
+- [ ] **Player Input** - All input methods specified for each platform
+- [ ] **System Responses** - Game responses to player actions documented
+- [ ] **Performance Impact** - Performance considerations for each mechanic noted
+
+### Controls and Interaction
+
+- [ ] **Multi-Platform Controls** - Desktop, mobile, and gamepad controls defined
+- [ ] **Input Responsiveness** - Requirements for responsive game feel specified
+- [ ] **Accessibility Options** - Control customization and accessibility considered
+- [ ] **Touch Optimization** - Mobile-specific control adaptations designed
+- [ ] **Edge Case Handling** - Unusual input scenarios addressed
+
+## Progression and Balance
+
+### Player Progression
+
+- [ ] **Progression Type** - Linear, branching, or metroidvania approach defined
+- [ ] **Key Milestones** - Major progression points documented
+- [ ] **Unlock System** - What players unlock and when is specified
+- [ ] **Difficulty Scaling** - How challenge increases over time is detailed
+- [ ] **Player Agency** - Meaningful player choices and consequences defined
+
+### Game Balance
+
+- [ ] **Balance Parameters** - Numeric values for key game systems provided
+- [ ] **Difficulty Curve** - Appropriate challenge progression designed
+- [ ] **Economy Design** - Resource systems balanced for engagement
+- [ ] **Player Testing** - Plan for validating balance through playtesting
+- [ ] **Iteration Framework** - Process for adjusting balance post-implementation
+
+## Level Design Framework
+
+### Level Structure
+
+- [ ] **Level Types** - Different level categories defined with purposes
+- [ ] **Level Progression** - How players move through levels specified
+- [ ] **Duration Targets** - Expected play time for each level type
+- [ ] **Difficulty Distribution** - Appropriate challenge spread across levels
+- [ ] **Replay Value** - Elements that encourage repeated play designed
+
+### Content Guidelines
+
+- [ ] **Level Creation Rules** - Clear guidelines for level designers
+- [ ] **Mechanic Introduction** - How new mechanics are taught in levels
+- [ ] **Pacing Variety** - Mix of action, puzzle, and rest moments planned
+- [ ] **Secret Content** - Hidden areas and optional challenges designed
+- [ ] **Accessibility Options** - Multiple difficulty levels or assist modes considered
+
+## Technical Implementation Readiness
+
+### Performance Requirements
+
+- [ ] **Frame Rate Targets** - 60 FPS target with minimum acceptable rates
+- [ ] **Memory Budgets** - Maximum memory usage limits defined
+- [ ] **Load Time Goals** - Acceptable loading times for different content
+- [ ] **Battery Optimization** - Mobile battery usage considerations addressed
+- [ ] **Scalability Plan** - How performance scales across different devices
+
+### Platform Specifications
+
+- [ ] **Desktop Requirements** - Minimum and recommended PC/Mac specs
+- [ ] **Mobile Optimization** - iOS and Android specific requirements
+- [ ] **Browser Compatibility** - Supported browsers and versions listed
+- [ ] **Cross-Platform Features** - Shared and platform-specific features identified
+- [ ] **Update Strategy** - Plan for post-launch updates and patches
+
+### Asset Requirements
+
+- [ ] **Art Style Definition** - Clear visual style with reference materials
+- [ ] **Asset Specifications** - Technical requirements for all asset types
+- [ ] **Audio Requirements** - Music and sound effect specifications
+- [ ] **UI/UX Guidelines** - User interface design principles established
+- [ ] **Localization Plan** - Text and cultural localization requirements
+
+## Development Planning
+
+### Implementation Phases
+
+- [ ] **Phase Breakdown** - Development divided into logical phases
+- [ ] **Epic Definitions** - Major development epics identified
+- [ ] **Dependency Mapping** - Prerequisites between features documented
+- [ ] **Risk Assessment** - Technical and design risks identified with mitigation
+- [ ] **Milestone Planning** - Key deliverables and deadlines established
+
+### Team Requirements
+
+- [ ] **Role Definitions** - Required team roles and responsibilities
+- [ ] **Skill Requirements** - Technical skills needed for implementation
+- [ ] **Resource Allocation** - Time and effort estimates for major features
+- [ ] **External Dependencies** - Third-party tools, assets, or services needed
+- [ ] **Communication Plan** - How team members will coordinate work
+
+## Quality Assurance
+
+### Success Metrics
+
+- [ ] **Technical Metrics** - Measurable technical performance goals
+- [ ] **Gameplay Metrics** - Player engagement and retention targets
+- [ ] **Quality Benchmarks** - Standards for bug rates and polish level
+- [ ] **User Experience Goals** - Specific UX objectives and measurements
+- [ ] **Business Objectives** - Commercial or project success criteria
+
+### Testing Strategy
+
+- [ ] **Playtesting Plan** - How and when player feedback will be gathered
+- [ ] **Technical Testing** - Performance and compatibility testing approach
+- [ ] **Balance Validation** - Methods for confirming game balance
+- [ ] **Accessibility Testing** - Plan for testing with diverse players
+- [ ] **Iteration Process** - How feedback will drive design improvements
+
+## Documentation Quality
+
+### Clarity and Completeness
+
+- [ ] **Clear Writing** - All sections are well-written and understandable
+- [ ] **Complete Coverage** - No major game systems left undefined
+- [ ] **Actionable Detail** - Enough detail for developers to create implementation stories
+- [ ] **Consistent Terminology** - Game terms used consistently throughout
+- [ ] **Reference Materials** - Links to inspiration, research, and additional resources
+
+### Maintainability
+
+- [ ] **Version Control** - Change log established for tracking revisions
+- [ ] **Update Process** - Plan for maintaining document during development
+- [ ] **Team Access** - All team members can access and reference the document
+- [ ] **Search Functionality** - Document organized for easy reference and searching
+- [ ] **Living Document** - Process for incorporating feedback and changes
+
+## Stakeholder Alignment
+
+### Team Understanding
+
+- [ ] **Shared Vision** - All team members understand and agree with the game vision
+- [ ] **Role Clarity** - Each team member understands their contribution
+- [ ] **Decision Framework** - Process for making design decisions during development
+- [ ] **Conflict Resolution** - Plan for resolving disagreements about design choices
+- [ ] **Communication Channels** - Regular meetings and feedback sessions planned
+
+### External Validation
+
+- [ ] **Market Validation** - Competitive analysis and market fit assessment
+- [ ] **Technical Validation** - Feasibility confirmed with technical team
+- [ ] **Resource Validation** - Required resources available and committed
+- [ ] **Timeline Validation** - Development schedule is realistic and achievable
+- [ ] **Quality Validation** - Quality standards align with available time and resources
+
+## Final Readiness Assessment
+
+### Implementation Preparedness
+
+- [ ] **Story Creation Ready** - Document provides sufficient detail for story creation
+- [ ] **Architecture Alignment** - Game design aligns with technical capabilities
+- [ ] **Asset Production** - Asset requirements enable art and audio production
+- [ ] **Development Workflow** - Clear path from design to implementation
+- [ ] **Quality Assurance** - Testing and validation processes established
+
+### Document Approval
+
+- [ ] **Design Review Complete** - Document reviewed by all relevant stakeholders
+- [ ] **Technical Review Complete** - Technical feasibility confirmed
+- [ ] **Business Review Complete** - Project scope and goals approved
+- [ ] **Final Approval** - Document officially approved for implementation
+- [ ] **Baseline Established** - Current version established as development baseline
+
+## Overall Assessment
+
+**Document Quality Rating:** ⭐⭐⭐⭐⭐
+
+**Ready for Development:** [ ] Yes [ ] No
+
+**Key Recommendations:**
+_List any critical items that need attention before moving to implementation phase._
+
+**Next Steps:**
+_Outline immediate next actions for the team based on this assessment._

package/expansion-packs/bmad-2d-phaser-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
+- [ ] **Class Definitions** - TypeScript interfaces and classes are properly defined
+- [ ] **Integration Points** - Clear specification of how feature integrates with existing systems
+- [ ] **Event Communication** - Event emitting and listening requirements specified
+- [ ] **Dependencies** - All system dependencies clearly identified
+
+### Phaser 3 Requirements
+
+- [ ] **Scene Integration** - Specifies which scenes are affected and how
+- [ ] **Game Object Usage** - Proper use of Phaser 3 game objects and components
+- [ ] **Physics Integration** - Physics requirements specified if applicable
+- [ ] **Asset Requirements** - All needed assets (sprites, audio, data) identified
+- [ ] **Performance Considerations** - 60 FPS target and optimization requirements
+
+### Code Quality Standards
+
+- [ ] **TypeScript Strict Mode** - All code must comply with strict TypeScript
+- [ ] **Error Handling** - Error scenarios and handling requirements specified
+- [ ] **Memory Management** - Object pooling and cleanup requirements where needed
+- [ ] **Cross-Platform Support** - Desktop and mobile considerations addressed
+- [ ] **Code Organization** - Follows established game 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
+- [ ] **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
+- [ ] **Dependency Validation** - All dependencies are actually available
+
+## Testing Requirements
+
+### Test Coverage
+
+- [ ] **Unit Test Requirements** - Specific unit test files and scenarios defined
+- [ ] **Integration Test Cases** - Integration testing with other game systems specified
+- [ ] **Manual Test Cases** - Game-specific manual testing procedures defined
+- [ ] **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
+- [ ] **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
+- [ ] **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
+- [ ] **Audio Integration** - Sound effect and music requirements defined
+- [ ] **Visual Feedback** - Animation and visual effect requirements specified
+- [ ] **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
+- [ ] **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
+- [ ] **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-phaser-game-dev/config.yaml

@@ -0,0 +1,8 @@
+name: bmad-2d-phaser-game-dev
+version: 1.12.0
+short-title: Phaser 3 2D Game Dev Pack
+description: >-
+  2D Game Development expansion pack for BMad Method - Phaser 3 & TypeScript
+  focused
+author: Brian (BMad)
+slashPrefix: bmad2dp

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

@@ -0,0 +1,250 @@
+# Game Development BMad Knowledge Base
+
+## Overview
+
+This game development expansion of BMad-Method specializes in creating 2D games using Phaser 3 and TypeScript. It extends the core BMad framework with game-specific agents, workflows, and best practices for professional game development.
+
+### Game Development Focus
+
+- **Target Engine**: Phaser 3.70+ with TypeScript 5.0+
+- **Platform Strategy**: Web-first with mobile optimization
+- **Development Approach**: Agile story-driven development
+- **Performance Target**: 60 FPS on target devices
+- **Architecture**: Component-based game systems
+
+## 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**: 60 FPS 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 Phaser 3 systems, performance optimization, and 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 TypeScript strict mode and Phaser 3 best practices
+   - Maintain 60 FPS performance target throughout development
+   - Use test-driven development for game logic components
+
+7. **Iterative Refinement**: Continuous playtesting and improvement
+   - Test core mechanics early and often
+   - Validate game balance through metrics and player feedback
+   - Iterate on design based on implementation discoveries
+
+## Game-Specific Development Guidelines
+
+### Phaser 3 + TypeScript Standards
+
+**Project Structure:**
+
+```text
+game-project/
+├── src/
+│   ├── scenes/          # Game scenes (BootScene, MenuScene, GameScene)
+│   ├── gameObjects/     # Custom game objects and entities
+│   ├── systems/         # Core game systems (GameState, InputManager, etc.)
+│   ├── utils/           # Utility functions and helpers
+│   ├── types/           # TypeScript type definitions
+│   └── config/          # Game configuration and balance
+├── assets/              # Game assets (images, audio, data)
+├── docs/
+│   ├── stories/         # Development stories
+│   └── design/          # Game design documents
+└── tests/               # Unit and integration tests
+```
+
+**Performance Requirements:**
+
+- Maintain 60 FPS on target devices
+- Memory usage under specified limits per level
+- Loading times under 3 seconds for levels
+- Smooth animation and responsive controls
+
+**Code Quality:**
+
+- TypeScript strict mode compliance
+- Component-based architecture
+- Object pooling for frequently created/destroyed objects
+- 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 Phaser 3
+- 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 game logic (separate from Phaser)
+- Integration tests for game systems
+- Performance benchmarking and profiling
+- 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**: Phaser 3 implementation, technical excellence, performance
+- **Key Outputs**: Working game features, optimized code, technical architecture
+- **Specialties**: TypeScript/Phaser 3, 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
+
+### Web Platform
+
+- Browser compatibility across modern browsers
+- Progressive loading for large assets
+- Touch-friendly mobile controls
+- Responsive design for different screen sizes
+
+### Mobile Optimization
+
+- Touch gesture support and responsive controls
+- Battery usage optimization
+- Performance scaling for different device capabilities
+- App store compliance and packaging
+
+### Performance Targets
+
+- **Desktop**: 60 FPS at 1080p resolution
+- **Mobile**: 60 FPS on mid-range devices, 30 FPS minimum on low-end
+- **Loading**: Initial load under 5 seconds, level transitions under 2 seconds
+- **Memory**: Under 100MB total usage, under 50MB per level
+
+## 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, linting compliance)
+- Documentation completeness and accuracy
+- Team velocity and delivery consistency
+
+## Common Game Development Patterns
+
+### Scene Management
+
+- Boot scene for initial setup and configuration
+- Preload scene for asset loading with progress feedback
+- Menu scene for navigation and settings
+- Game scenes for actual gameplay
+- Clean transitions between scenes with proper cleanup
+
+### Game State Management
+
+- Persistent data (player progress, unlocks, settings)
+- Session data (current level, score, temporary state)
+- Save/load system with error recovery
+- Settings management with platform storage
+
+### Input Handling
+
+- Cross-platform input abstraction
+- Touch gesture support for mobile
+- Keyboard and gamepad support for desktop
+- Customizable control schemes
+
+### Performance Optimization
+
+- Object pooling for bullets, effects, enemies
+- Texture atlasing and sprite optimization
+- Audio compression and streaming
+- Culling and level-of-detail systems
+- Memory management and garbage collection optimization
+
+This knowledge base provides the foundation for effective game development using the BMad-Method framework with specialized focus on 2D game creation using Phaser 3 and TypeScript.