game-testing-framework — Claude Code command for game testing

---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[test-type] | --unit | --integration | --performance | --automation | --comprehensive"
description: Use PROACTIVELY to implement comprehensive game testing frameworks with automated validation, performance testing, and multi-platform verification
---

# Game Testing Framework & Automation

Implement comprehensive game testing framework: $ARGUMENTS

## Current Testing Context

- Game engine: @package.json or detect Unity/Unreal/Godot project files
- Existing tests: !`find . -name "*test*" -o -name "*Test*" | head -10`
- CI/CD setup: @.github/workflows/ or @.gitlab-ci.yml or @Jenkinsfile (if exists)
- Build configs: !`find . -name "*.sln" -o -name "*.csproj" -o -name "build.gradle" | head -3`
- Platform targets: !`grep -r "BuildTarget\|Platform\|Target" . 2>/dev/null | wc -l` target configurations

## Task

Create a comprehensive testing framework for game development with automated validation, performance benchmarks, cross-platform testing, and continuous integration.

## Testing Framework Components

### 1. Unit Testing Infrastructure
- Core game logic and mechanics testing
- Component-based testing for modular systems
- Mock and stub systems for external dependencies
- Data validation and serialization testing
- Mathematical calculations and algorithm verification

### 2. Integration Testing Suite
- Scene loading and transition testing
- Asset loading and management validation
- Save/load system integrity testing
- Networking and multiplayer functionality
- Platform-specific feature integration testing

### 3. Performance & Benchmarking
- Frame rate stability testing across scenarios
- Memory usage profiling and leak detection
- Loading time benchmarks for different content
- Stress testing with high entity counts
- Platform-specific performance validation

### 4. Automated Gameplay Testing
- AI behavior validation and regression testing
- User input simulation and response verification
- Game state progression and checkpoint validation
- Balance testing for game mechanics
- Procedural content generation validation

## Testing Categories

### Functional Testing
- Core gameplay mechanics validation
- User interface responsiveness and functionality
- Audio system integration and spatial audio
- Physics simulation accuracy and stability
- Animation system timing and blending

### Compatibility Testing
- Multi-platform build verification
- Device-specific feature testing (mobile, console, VR)
- Different screen resolutions and aspect ratios
- Hardware capability scaling and adaptation
- Operating system compatibility validation

### Regression Testing
- Automated testing for code changes impact
- Asset modification impact on game performance
- Save file compatibility across versions
- Feature functionality preservation
- Performance regression detection

### User Experience Testing
- Accessibility features validation
- Control scheme testing across input devices
- Localization and internationalization testing
- Tutorial and onboarding flow validation
- Error handling and recovery testing

## Deliverables

1. **Testing Framework Setup**
   - Test runner configuration and automation
   - Mock systems and test data generation
   - Continuous integration pipeline integration
   - Test reporting and metrics collection

2. **Test Suite Implementation**
   - Unit tests for core game systems
   - Integration tests for complex interactions
   - Performance benchmarks and monitoring
   - Automated gameplay validation scripts

3. **Platform Testing Strategy**
   - Device-specific test configurations
   - Cloud testing and device farm integration
   - Performance validation across target platforms
   - Compatibility testing automation

4. **Monitoring & Reporting**
   - Test results dashboard and visualization
   - Performance regression tracking
   - Code coverage analysis and reporting
   - Automated test failure investigation

## Implementation Guidelines

Integrate with game engine testing tools and establish CI/CD pipelines for automated testing. Ensure scalable test architecture that grows with project complexity and team size.