OpenCode Game Studios - Godot Edition

AI-powered game development framework for Godot 4.6.1.

C# primary language with optional GDScript support - AI models have better C# code generation quality.

中文文档 | English

---

What Is This?

A coordinated AI agent system for indie game development:

• 21 specialized skills for Godot game dev
• Automated hooks for quality enforcement
• Path-scoped rules for coding standards

Adapted from Claude-Code-Game-Studios.

---

Quick Start (5 minutes)

🚀 Apply to Your Project

Step 1: Clone this repo

git clone https://github.com/gwtt/Open-Code-Godot-Studio.git

Step 2: Copy to your project

# Copy the framework to your Godot project
cp -r Open-Code-Godot-Studio/.opencode/ your-godot-project/.opencode/

# Copy OPENCODE.md (AI entry point)
cp Open-Code-Godot-Studio/OPENCODE.md your-godot-project/OPENCODE.md

Step 3: Update your version

Edit OPENCODE.md and update your Godot version:

## Technology Stack
- **Engine**: Godot 4.x  ← Change to your version

Step 4: Use in OpenCode

Open your project in OpenCode and run:

/start

Done! You now have 21 Godot AI skills in your project.

What you copied:

• .opencode/ — Skills, hooks, rules, engine reference
• OPENCODE.md — AI entry point configuration

---

📁 Minimum Required Files

If you only need core functionality:

your-project/.opencode/
├── skills/     # Required — 19 Godot skills
├── hooks/      # Recommended — Automation scripts
└── rules/      # Recommended — Coding standards

---

🎯 What You Get

Component	Count	Purpose
Skills	21	Godot-specific AI agents
Hooks	4	Automation (session, commit, asset)
Rules	3	Coding standards (GDScript, C#)
Engine Reference	12 docs	API updates (4.4-4.6)

---

Option A: Interactive Onboarding

/start

System detects your state and guides you.

Option B: Manual Steps

1. /brainstorm "your idea"    → Game concept
2. /setup-engine godot 4.6.1  → Engine setup
3. /sprint-plan               → Sprint planning

📖 Step-by-step tutorial →

---

Documentation

Document	Description
SKILLS.md	All 21 skills detailed guide
WORKFLOW.md	Typical workflows
QUICK-START.md	5-minute guide
case-study-2person-team.md	🆕 2-person team guide
tutorials/	Hands-on tutorials

---

Skills Overview

Category	Skills
Leadership Core	start, producer, technical-director
Execution Support	godot-specialist, sprint-plan, art-coordinator, prototype-mode, player-evaluator
Design Support	brainstorm, game-designer, design-review, art-bible, asset-spec
Deep Technical	godot-gdscript, godot-csharp, godot-shader, godot-gdextension, code-review
Advisory	creative-director, lead-programmer

See docs/SKILLS.md for detailed descriptions.

---

Project Structure

.opencode/
├── skills/        → 21 game dev skills
├── hooks/         → Automation scripts
├── rules/         → Coding standards
└── docs/          → Templates and references

src/               → Game code (C# primary, GDScript optional, C++ for GDExtension)
assets/            → Art, audio, VFX
design/            → GDDs, narrative
production/        → Sprint plans, milestones
prototypes/        → Throwaway prototypes
tests/             → Test suites

---

Typical Workflows

Team Lead Weekly Cycle

Monday:   /sprint-plan review → Progress check
Wednesday: /art-coordinator → Art sync
Friday:   /producer → Week summary

New Feature Development

/design-review → Validate design
/art-coordinator → Request art assets
/prototype-mode → Quick validation (optional)
/technical-director → Architecture check
/godot-specialist → Implementation
/code-review → Quality gate

---

Features

Skills (21 total)

• Godot-specific: godot-specialist, godot-gdscript, godot-csharp, godot-shader, godot-gdextension
• Game dev core: creative-director, technical-director, producer, game-designer, lead-programmer
• Workflows: start, brainstorm, setup-engine, sprint-plan, code-review, design-review
• Art pipeline: art-bible, asset-spec, art-coordinator
• Design validation: player-evaluator (multi-perspective GDD evaluation)
• Prototyping: prototype-mode

Language Support

• C# (Primary): .NET ecosystem, better AI code generation, complex data processing
• GDScript (Optional): Native Godot scripting, rapid prototyping
• GDExtension: Performance-critical native code (C++/Rust)

Hooks (4)

• Session start/stop — Context loading
• Commit validation — Message format
• Asset validation — Naming conventions

Rules (3)

• C# standards — .NET 8 patterns, Godot C# API
• GDScript standards — Static typing, signals
• Gameplay rules — Game-specific patterns

---

Integration with oh-my-openagent

Compatible with oh-my-openagent.

See integration docs for details.

---

Key Differences from Claude-Code-Game-Studios

Original	This Version
.claude/ directory	.opencode/ directory
CLAUDE.md	OPENCODE.md
48 agents + 72 skills	21 focused skills
Multi-engine	Godot-focused

---

Contributing

See original project: Claude-Code-Game-Studios

---

License

MIT License

---

Quick Summary

# 1. Clone
git clone https://github.com/gwtt/Open-Code-Godot-Studio.git

# 2. Copy to your project
cp -r Open-Code-Godot-Studio/.opencode/ your-project/
cp Open-Code-Godot-Studio/OPENCODE.md your-project/

# 3. Update version in OPENCODE.md
# 4. Run /start in OpenCode