game-performance-profiler — Claude Code command for game performance

---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[profile-type] | --fps | --memory | --rendering | --comprehensive"
description: Use PROACTIVELY to analyze game performance bottlenecks and generate optimization recommendations across multiple platforms
---

# Game Performance Analysis & Optimization

Analyze game performance and generate optimization recommendations: $ARGUMENTS

## Current Performance Context

- Game engine: @package.json or detect Unity/Unreal/Godot project files
- Platform targets: !`find . -name "*.pbxproj" -o -name "*.gradle" -o -name "*.vcxproj" | head -3`
- Asset pipeline: !`find . -name "*.meta" -o -name "*.asset" | wc -l` game assets
- Build configs: !`grep -r "BuildTarget\|Platform" . 2>/dev/null | wc -l` platform configurations
- Performance logs: !`find . -name "*profile*" -o -name "*perf*" | head -5`

## Task

Create comprehensive performance analysis with automated bottleneck detection, optimization suggestions, and platform-specific recommendations for game development projects.

## Performance Analysis Areas

### 1. Frame Rate & Rendering Performance
- Analyze draw calls and batching efficiency
- Identify overdraw and fillrate bottlenecks
- Review shader complexity and optimization opportunities
- Evaluate mesh and texture optimization potential
- Check lighting and shadow rendering performance

### 2. Memory Usage Analysis
- Memory allocation patterns and potential leaks
- Texture memory usage and compression opportunities
- Audio memory optimization suggestions
- Object pooling and garbage collection analysis
- Platform-specific memory constraints evaluation

### 3. CPU Performance Profiling
- Script execution bottlenecks identification
- Physics simulation optimization opportunities
- AI and pathfinding performance analysis
- Animation system efficiency review
- Threading and parallelization recommendations

### 4. Platform-Specific Optimization
- Mobile performance considerations (battery, thermal throttling)
- Console-specific optimization guidelines
- PC hardware scaling recommendations
- VR performance requirements and optimizations
- Web/WebGL specific performance considerations

## Deliverables

1. **Performance Audit Report**
   - Current performance metrics and benchmarks
   - Identified bottlenecks with severity ratings
   - Platform-specific performance analysis

2. **Optimization Recommendations**
   - Prioritized optimization suggestions
   - Implementation difficulty and impact assessment
   - Code and asset optimization guidelines

3. **Monitoring Setup**
   - Performance monitoring implementation
   - Key metrics tracking configuration
   - Automated performance regression detection

4. **Testing Strategy**
   - Performance testing procedures
   - Target device testing recommendations
   - Continuous performance monitoring setup

## Implementation Guidelines

Follow game engine best practices and target platform requirements. Generate actionable recommendations with clear implementation steps and expected performance improvements.