🎮 Game Studio Sub-Agents

AI-Powered Game Development Team in Your Terminal

Created by Tuna Pamir - Empowering game developers with AI assistance

Transform your game ideas into reality with an intelligent team of specialized AI agents. Each agent is an expert in their domain - from game design to QA testing - working together seamlessly to help you create games for any platform.

✨ Features

🤖 12 Specialized Agents: Each focusing on their expertise (design, art, programming, QA, market analysis, data science)
📊 Data-Driven Development: Market analysis and analytics from day one
🎯 Multiple Development Modes: Design-only, Prototype, or Full Development
🏗️ Automatic Project Structure: Organized folders and documentation
🎨 Multi-Engine Support: Godot, Unity, Unreal, or custom engines
📱 Cross-Platform: PC, Mobile, Console, Web, VR/AR development
🔄 Milestone Tracking: Automated progress monitoring and reporting
📈 Market Intelligence: Competitive analysis and market validation
🎯 Engine-Optimized: Godot, Unity, and Unreal best practices built-in
🤖 Smart Agents: Project-specific agents with engine expertise
📋 Custom Development Rules: Define project-specific coding standards and practices

🚀 Quick Start

Prerequisites

Before starting, ensure you have these installed:

1. Git

# Windows (using Chocolatey)
choco install git

# macOS (using Homebrew)
brew install git

# Ubuntu/Debian
sudo apt update && sudo apt install git

# Verify installation
git --version

2. Python 3.8+

# Windows: Download from python.org
# Or using Chocolatey
choco install python

# macOS (using Homebrew)
brew install python

# Ubuntu/Debian
sudo apt update && sudo apt install python3 python3-pip

# Verify installation
python --version
# or
python3 --version

3. Node.js (for Mermaid diagram support)

# Windows (using Chocolatey)
choco install nodejs

# macOS (using Homebrew)
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Verify installation
node --version
npm --version

4. Claude Code

# Install Claude Code CLI
npm install -g @anthropic-ai/claude-code

# Or download from: https://claude.ai/code
# Follow the installation guide for your platform

# Verify installation
claude --version

# Login to Claude Code
claude auth login

Installation

# 1. Clone the repository
git clone https://github.com/pamirtuna/gamestudio-subagents.git
cd gamestudio-subagents

# 2. Optional: Create virtual environment (recommended)
python -m venv venv

# Activate virtual environment
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# 3. Create your first project
python scripts/init_project.py
# Creates: projects/[your-game-name]/

# 4. Start development with Claude
claude "Read agents/market_analyst.md and the project-config.json in projects/[project-name]. Perform a comprehensive market analysis and generate all reports."

# 5. Manage your projects
python scripts/project_manager.py

That's it! Your AI game development team is ready to help.

🎭 Meet Your AI Team

Management

🎯 Master Orchestrator: System coordinator and project initializer
📊 Producer Agent: Project manager ensuring timelines and quality

Intelligence Team

📈 Market Analyst: Competitive analysis and market intelligence
🔬 Data Scientist: Analytics, metrics, and predictive modeling

Design Team

🎨 Sr Game Designer: Vision holder and systems architect
📝 Mid Game Designer: Content creator and implementation specialist

Engineering Team

⚙️ Mechanics Developer: Core gameplay systems engineer
✨ Game Feel Developer: Polish and game juice specialist

Art Team

🖼️ Sr Game Artist: Art director defining visual style
🔧 Technical Artist: Shaders, VFX, and optimization expert
📱 UI/UX Agent: Interface and user experience designer

Quality

🐛 QA Agent: Testing, validation, and quality assurance

📚 How It Works

1. Project Initialization

The system starts with market validation, then project setup:

Market Analysis: Competitive research and opportunity assessment
Project Setup: Organized folders and agent configuration
Documentation: Templates and milestone schedules
Analytics Setup: Telemetry and metrics planning

1.5. Development Rules Configuration

During initialization, you can define custom development rules:

Coding Standards: Clean Code, SOLID, DRY, KISS principles
Architecture Patterns: MVC, ECS, State Machines, etc.
Performance Requirements: FPS targets, memory limits
Project-Specific Rules: Any custom standards for your team

All rules are stored in project-config.json and enforced by the Producer Agent throughout development.

2. Development Modes

🎨 Design Mode

Perfect for exploring ideas without committing to development:

Market Validation: Competitive analysis and target audience research
Design Documentation: Complete game design with data backing
Art Direction: Style exploration based on market research
Technical Assessment: Multi-engine feasibility analysis

🚧 Prototype Mode

Quickly validate your core gameplay:

Market-Informed Design: Based on competitive analysis
Rapid Prototyping: Core mechanics with telemetry
Data Collection: Player behavior and engagement metrics
Performance Validation: Technical and market viability

🎮 Development Mode

Full production pipeline with all agents:

Data-Driven Development: Analytics throughout production
Market-Aware Implementation: Features based on competitive research
Continuous Optimization: A/B testing and performance monitoring
Quality Assurance: QA with telemetry integration

3. Agent Coordination

Agents communicate through structured protocols:

User → Master Orchestrator → Market Analysis → Producer → Specialized Agents → Data Collection → Optimization

🔄 System Workflow Schematic

graph TD
    A[User: Game Idea] --> B[Initialize Project]
    B --> C{Market Analysis Phase}
    
    C --> D[Market Analyst Agent]
    D --> E[Competitive Research]
    D --> F[Market Sizing]
    D --> G[Target Audience Analysis]
    
    E --> H{Go/No-Go Decision}
    F --> H
    G --> H
    
    H -->|No Go| I[Pivot or Stop]
    H -->|Go| J[Master Orchestrator]
    
    J --> K{Development Mode?}
    
    K -->|Design Mode| L[Design Team]
    K -->|Prototype Mode| M[Prototype Team]
    K -->|Development Mode| N[Full Team]
    
    L --> O[Producer Agent Coordination]
    M --> O
    N --> O
    
    O --> P[Data Scientist Setup]
    P --> Q[Analytics Framework]
    P --> R[Telemetry Planning]
    P --> S[A/B Testing Design]
    
    Q --> T[Parallel Development]
    R --> T
    S --> T
    
    T --> U[Sr Game Designer]
    T --> V[Mid Game Designer]
    T --> W[Mechanics Developer]
    T --> X[Game Feel Developer]
    T --> Y[Sr Game Artist]
    T --> Z[Technical Artist]
    T --> AA[UI/UX Agent]
    T --> BB[QA Agent]
    
    U --> CC[Continuous Data Collection]
    V --> CC
    W --> CC
    X --> CC
    Y --> CC
    Z --> CC
    AA --> CC
    BB --> CC
    
    CC --> DD[Data Scientist Analysis]
    DD --> EE[Market Analyst Validation]
    EE --> FF[Producer Agent Optimization]
    
    FF --> GG{Milestone Complete?}
    GG -->|No| T
    GG -->|Yes| HH[Next Phase]
    
    HH --> II{Final Release?}
    II -->|No| T
    II -->|Yes| JJ[Launch with Data Monitoring]
    
    JJ --> KK[Post-Launch Analytics]
    KK --> LL[Continuous Optimization]

How the System Works:

Phase 1: Market Validation 🎯

User Input: Provides game concept and competitor information
Market Analyst: Analyzes market opportunity, competition, and audience
Go/No-Go: Data-driven decision to proceed or pivot

Phase 2: Team Assembly 🤖

Master Orchestrator: Selects appropriate agents based on project mode
Producer Agent: Coordinates team and establishes workflows
Data Scientist: Sets up analytics and testing frameworks

Phase 3: Parallel Development ⚡

Design Agents: Create game systems with market insights
Art Agents: Develop visuals based on competitive analysis
Engineering Agents: Build mechanics with telemetry integration
QA Agent: Tests with performance monitoring

Phase 4: Continuous Optimization 📈

Data Collection: Real-time metrics from all development phases
Analysis Loop: Data Scientist analyzes, Market Analyst validates, Producer optimizes
Iteration: Teams adjust based on data insights

Phase 5: Launch & Beyond 🚀

Market-Ready Release: Launched with proven data backing
Post-Launch Monitoring: Continuous analytics and optimization
Long-term Success: Data-driven updates and improvements

📁 Project Management

The system includes powerful project management capabilities:

Project Creation

# Interactive project setup with engine selection
python scripts/init_project.py
# Creates: projects/[your-game-name]/
# ✨ Automatically configures for your chosen engine (Godot/Unity/Unreal)
# ✨ Creates engine-specific folder structure
# ✨ Generates project-specific agents with engine expertise

Project Management Commands

# Show all projects
python scripts/project_manager.py status

# Show specific project details
python scripts/project_manager.py status my-game

# Resume work on a project
python scripts/project_manager.py resume my-game

# Pause project indefinitely
python scripts/project_manager.py freeze my-game

# Reset project to start over
python scripts/project_manager.py startover my-game

# Interactive menu
python scripts/project_manager.py menu

Project Structure

Each project is created with engine-optimized structure:

Godot Projects

projects/your-game-name/
├── agents/                     # 🆕 Project-specific agents
├── project-config.json         # Project configuration
├── documentation/              # Design & technical docs
├── source/                     # Godot project
│   ├── project.godot          # Godot project file
│   ├── scenes/                # Game scenes (.tscn)
│   ├── scripts/               # GDScript files (.gd)
│   ├── assets/                # Sprites, models, audio
│   ├── autoload/              # Global scripts
│   └── addons/                # Godot plugins
├── qa/                        # Testing plans
└── builds/                    # Export builds

Unity Projects

projects/your-game-name/
├── agents/                     # 🆕 Project-specific agents
├── project-config.json         # Project configuration
├── documentation/              # Design & technical docs
├── source/                     # Unity project
│   ├── Assets/                # Unity assets folder
│   │   ├── Scripts/           # C# scripts
│   │   ├── Scenes/            # Unity scenes
│   │   ├── Prefabs/           # Game object prefabs
│   │   └── Materials/         # Materials & shaders
│   ├── Packages/              # Package manager
│   └── ProjectSettings/       # Unity project settings
├── qa/                        # Testing framework
└── builds/                    # Build outputs

Unreal Projects

projects/your-game-name/
├── agents/                     # 🆕 Project-specific agents
├── project-config.json         # Project configuration
├── documentation/              # Design & technical docs
├── source/                     # Unreal project
│   ├── ProjectName.uproject   # Unreal project file
│   ├── Content/               # Game content
│   │   ├── Blueprints/        # Blueprint classes
│   │   ├── Maps/              # Game levels
│   │   ├── Materials/         # Materials & shaders
│   │   └── Audio/             # Sound assets
│   ├── Source/                # C++ source code
│   └── Config/                # Configuration files
├── qa/                        # Testing suite
└── builds/                    # Packaged builds

Project Status Tracking

🟢 Active: Currently being developed
🟡 Paused: Temporarily stopped
🔵 Frozen: Long-term pause
✅ Completed: Finished and released
❌ Cancelled: Abandoned

🎮 Engine-Specific Features

Intelligent Agent Customization

Each project gets customized agents based on your engine choice:

Godot Agents Know:

GDScript best practices and node-based architecture
Signal-driven programming patterns
Godot's built-in physics and rendering
Scene composition and resource management
Export templates for all platforms

Unity Agents Know:

C# programming and component architecture
Unity's Package Manager and ecosystem
Scriptable Objects and data management
UGUI and UI Toolkit for interfaces
Build pipelines and platform deployment

Unreal Agents Know:

Blueprint and C++ hybrid development
Unreal's Gameplay Framework patterns
Material Editor and rendering pipeline
UMG widget system for UI
Platform-specific optimizations

Automated Best Practices

Folder structures follow engine conventions
Naming conventions match engine standards
Project files created with optimal settings
Development workflows tailored to engine strengths

💡 Example Workflows

Creating a Mobile Puzzle Game

python scripts/init_project.py
# Select: Mobile, Casual, Design Mode

claude "Design a match-3 puzzle game with a space theme"
# Agents will create complete design documentation

Building a PC Indie Game

python scripts/init_project.py  
# Select: PC, Core, Development Mode

claude "Create a 2D platformer with procedural levels"
# Full team activates for complete development

Rapid Prototyping

python scripts/init_project.py
# Select: Any platform, Prototype Mode, Rapid timeline

claude "Build a prototype to test this combat mechanic"
# Focused team creates playable prototype in days

📁 Project Structure

your-game/
├── documentation/          # All design and technical docs
│   ├── design/            # GDD, systems, mechanics
│   ├── art/               # Style guides, concepts
│   └── production/        # Timeline, milestones
├── source/                # Game source code
│   ├── assets/           # Art, audio, UI
│   └── scripts/          # Game logic
├── qa/                    # Testing and bug reports
└── project-config.json    # Project configuration

🛠️ Advanced Features

Custom Agent Creation

Extend the system with your own specialized agents:

# Create new agent template
# Update orchestrator configuration  
# Add to workflow pipelines

CI/CD Integration

Automate builds and deployment:

# GitHub Actions, GitLab CI, Jenkins supported
# Automated testing and release pipelines

Multi-Project Management

Handle multiple games simultaneously:

# Each project isolated in its own folder
# Switch between projects seamlessly
# Share assets and code between projects

📖 Documentation

Setup Guide - Detailed installation and configuration
Agent Documentation - Individual agent capabilities
Templates - Production-ready templates for all workflows
Example Workflows - Common development patterns
System Verification - Complete validation report
API Reference - For advanced integration

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to Contribute

🐛 Report bugs and issues
💡 Suggest new features
📝 Improve documentation
🤖 Create new agent templates
🎮 Share your games built with the system

📜 License

This project is licensed under the MIT License - see LICENSE file for details.

🙏 Acknowledgments

Created by Tuna Pamir - This project represents a vision to democratize game development through AI assistance.

Special thanks to:

Claude (Anthropic) for powering the AI capabilities
The game development community for continuous inspiration
Early adopters and testers for valuable feedback
Open source contributors who help improve the system
Everyone who stars, shares, and supports this project

🌟 Showcase

Games built with Game Studio Sub-Agents:

[Add your game here!]

🧪 Testing & Validation

Verify your installation is working correctly:

# Test the complete workflow
python scripts/test_project_workflow.py

# Test engine-specific features
python scripts/test_engine_system.py

# Should show all PASS results

This validates:

All required files are present
Python scripts have valid syntax
Project structure can be created
All 12 agents are available
Engine configurations are valid
Project-specific agents work correctly
Engine-specific folder structures are created
Engine project files are generated properly

📞 Support

Issues: GitHub Issues
Discussions: Coming Soon
Wiki: Coming Soon

🚦 Roadmap

🎯 Who Is This For?

Indie Developers: Augment your small team with AI specialists
Solo Developers: Get expert help in areas outside your expertise
Game Designers: Quickly prototype and document ideas
Students: Learn game development with AI mentorship
Studios: Accelerate pre-production and prototyping

💬 Community

Join our growing community:

Discord Server - Coming Soon
Forum - Coming Soon
Twitter - Coming Soon

👨‍💻 Author

Tuna Pamir

GitHub: @pamirtuna
Project: Game Studio Sub-Agents

This project is free and open source for the game development community. If you find it helpful, please consider:

⭐ Starring the repository
🔄 Sharing with other developers
🐛 Contributing improvements
💬 Providing feedback

Ready to build your dream game? Get started in minutes with our Quick Start guide!

Made with ❤️ by Tuna Pamir for game developers worldwide

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
agents		agents
engine_configs		engine_configs
scripts		scripts
templates		templates
.gitignore		.gitignore
AUTHORS.md		AUTHORS.md
CITATION.cff		CITATION.cff
CODEOWNERS		CODEOWNERS
CONTRIBUTING.md		CONTRIBUTING.md
DEVELOPMENT_RULES.md		DEVELOPMENT_RULES.md
EXAMPLES.md		EXAMPLES.md
LICENSE		LICENSE
README.md		README.md
SETUP.md		SETUP.md
SYSTEM_VERIFICATION.md		SYSTEM_VERIFICATION.md
WORKFLOW_VALIDATION.md		WORKFLOW_VALIDATION.md
package.json		package.json

Uh oh!

License

Uh oh!

pamirtuna/gamestudio-subagents

Folders and files

Latest commit

History

Repository files navigation

🎮 Game Studio Sub-Agents

✨ Features

🚀 Quick Start

Prerequisites

1. Git

2. Python 3.8+

3. Node.js (for Mermaid diagram support)

4. Claude Code

Installation

🎭 Meet Your AI Team

Management

Intelligence Team

Design Team

Engineering Team

Art Team

Quality

📚 How It Works

1. Project Initialization

1.5. Development Rules Configuration

2. Development Modes

🎨 Design Mode

🚧 Prototype Mode

🎮 Development Mode

3. Agent Coordination

🔄 System Workflow Schematic

How the System Works:

Phase 1: Market Validation 🎯

Phase 2: Team Assembly 🤖

Phase 3: Parallel Development ⚡

Phase 4: Continuous Optimization 📈

Phase 5: Launch & Beyond 🚀

📁 Project Management

Project Creation

Project Management Commands

Project Structure

Godot Projects

Unity Projects

Unreal Projects

Project Status Tracking

🎮 Engine-Specific Features

Intelligent Agent Customization

Godot Agents Know:

Unity Agents Know:

Unreal Agents Know:

Automated Best Practices

💡 Example Workflows

Creating a Mobile Puzzle Game

Building a PC Indie Game

Rapid Prototyping

📁 Project Structure

🛠️ Advanced Features

Custom Agent Creation

CI/CD Integration

Multi-Project Management

📖 Documentation

🤝 Contributing

Ways to Contribute

📜 License

🙏 Acknowledgments

🌟 Showcase

🧪 Testing & Validation

📞 Support

🚦 Roadmap

🎯 Who Is This For?

💬 Community

👨‍💻 Author

About

Topics

Resources

License

Contributing

Uh oh!