⚡ Evolved from Claude Code Game Studios (CCGS) — now a standalone framework supporting OpenCode, Pi, oh-my-pi, Claude Code, and Codex coding agents.

• 💡 Motivation
• 📊 Port Status
• 🚀 Quick Start
• 🔌 Recommended Plugins
• 🗺️ Key Mappings
• 📁 Directory Tree
• 🔌 Plugin Architecture
• 🏗️ Studio Hierarchy
• 🐛 Known Issues
• 📄 License

Game development is a multi-disciplinary process — design, writing, architecture, programming, art, audio, QA, release — that's hard to coordinate with AI assistants in ad-hoc chat sessions. OpenCode Game Studios provides a structured framework for the full game lifecycle:

• Pre-workflow exploration — Rapidly prototype 2-4 ideas with zero commitment before choosing a development workflow
• Design-first pipeline — Brainstorm → systems map → section-by-section GDDs → cross-GDD review, before any code is written
• Phase gates — Formal checkpoints between phases with PASS/CONCERNS/FAIL verdicts that prevent advancing with gaps
• Workflow selection — Choose Hybrid (lightweight discovery then production) or Full OCGS (process-heavy from day one), depending on team size and project maturity
• 52 coordinated agents — From creative director to engine specialists, each with defined responsibilities, delegation maps, and strict domain boundaries
• 78 slash commands — Route through the right skill every time, from /concept-brainstorm to /launch-checklist

This project evolved from CCGS and runs on OpenCode, Pi and oh-my-pi.

⚠️ Active Development — This is a living framework. Things will break, change, and improve. Report bugs at github.com/striderZA/OpenCodeGameStudios/issues.

opencode

Windows users: .opencode/{agents,commands,skills,rules} are git symlinks and require core.symlinks=true (+ Developer Mode) to check out correctly — see Known Issues if / shows no commands.

Type / to browse all 78 skills and 78 commands, or /start for onboarding.

pi

All OCGS skills and commands load automatically through Pi extensions. Pi has no subagent tool; the ocgs-tool-map extension tells agents to do the work directly when a workflow names Task. See docs/pi-compatibility.md#delegation.

omp

omp reads .agents/ skills, commands, and rules natively and loads the shared Pi extensions through .omp/config.yml. Its task tool reads project agents from .omp/agents/; run /init-template --harness omp (or add core --harness omp) to generate them from .agents/agents/. See docs/omp-compatibility.md for setup details and known gaps.

claude

Claude Code reads AGENTS.md natively and .claude/rules/ with paths frontmatter. Run /init-template --harness claude (or add core --harness claude) to install agents, skills, and commands into .claude/; agent files gain the required name: frontmatter. Project MCP servers live in .mcp.json and need approval in an interactive session.

codex

Codex reads .agents/skills and AGENTS.md natively. Run /init-template --harness codex (or add core --harness codex) to generate .codex/agents/*.toml. Codex has no project-level slash commands and no path-scoped rule equivalent; its MCP entries live in .codex/config.toml and load only in trusted projects.

See OCGS-Pong — a complete Pong game built entirely with this toolchain. Demonstrates the full workflow from concept through implementation using OCGS agents and skills.

The framework is partitioned into 22 pluggable theme modules. Only install what you need for your project:

# Install modules (OpenCode target is the default)
node .opencode/modules/install.mjs add core
node .opencode/modules/install.mjs add engine-godot art design qa

# Install for a specific harness
node .opencode/modules/install.mjs add core --harness omp
node .opencode/modules/install.mjs add core --harness claude
node .opencode/modules/install.mjs add core --harness codex

# List all available and installed modules
node .opencode/modules/install.mjs list

# See module details
node .opencode/modules/install.mjs info core

# Remove a module (preserves user-modified files)
node .opencode/modules/install.mjs remove art

Module sources are mirrored: .opencode/modules/ feeds the OpenCode target (the default) and .agents/modules/ feeds every other target. Both trees are tracked; keep them in sync when changing a module. User-modified files are detected during removal and left in place.

These plugins enhance the OpenCode experience and are recommended for all game development sessions:

OpenCode: Add to your opencode.json:

{
  "plugins": [
    "./.opencode/plugins/ccgs-hooks.ts",
    "PLUGIN_NAME"
  ]
}

Pi: OCGS Pi extensions are bundled in .pi/extensions/ and auto-discovered on startup. See docs/pi-extensions.md for details.

/
├── AGENTS.md                  📋 Project configuration
├── opencode.json              ⚙️ OpenCode config (permissions, plugins)
├── .pi/                       ⚙️ Pi config (extensions, settings)
│   └── extensions/            🧩 Pi extensions (ocgs-core, delegation, question, etc.)
├── .omp/                      ⚙️ oh-my-pi config (extensions, generated agents, MCP)
├── .claude/                   ⚙️ Claude Code target (agents, skills, commands, rules)
├── .mcp.json                  ⚙️ Claude Code project MCP servers
├── .codex/                    ⚙️ Codex target (agents, MCP config)
├── .agents/                   📦 Canonical content (harness-agnostic)
│   ├── agents/                🤖 52 agent definitions
│   ├── skills/                🛠️ 78 skill workflows
│   ├── commands/              ⌨️ 78 slash commands
│   ├── rules/                 📏 11 coding standards
│   └── modules/               🧩 22 module sources (non-OpenCode targets)
│       ├── ...                22 modules total
├── .opencode/                 ⚙️ OpenCode-specific (plugins, config)
│   ├── commands/ → .agents/commands/ (symlink)
│   ├── agents/ → .agents/agents/     (symlink)
│   ├── skills/ → .agents/skills/     (symlink)
│   ├── rules/ → .agents/rules/       (symlink)
│   ├── plugins/
│   │   ├── ccgs-hooks.ts      🔗 Session lifecycle, validation
│   │   ├── drift-detector.ts  🔍 Template drift detection
│   │   ├── changelog-generator.ts 📝 Changelog generation
│   │   └── tests/             🧪 19 test suites (177 tests)
│   └── modules/
│       ├── install.mjs        CLI: add/remove/list modules
│       ├── installed.json     Module manifest
│       └── ...                22 OpenCode-target module mirrors
├── design/                    🎨 Game design documents
├── docs/
│   ├── CONTRIBUTING.md        📖 Framework contribution guide
│   ├── authoring-agents.md    🤖 Agent authoring guide
│   ├── authoring-skills.md    🛠️ Skill authoring guide
│   ├── pi-compatibility.md    🔧 Pi setup guide
│   ├── pi-extensions.md       🧩 Pi extension reference
│   ├── pi-workflow.md         🔄 Pi workflow differences
│   ├── omp-compatibility.md   🔧 oh-my-pi setup guide
│   ├── framework/             🏛️ OCGS framework reference docs & templates
│   ├── architecture/          🏗️ ADRs
│   └── engine-reference/      📚 Engine API reference
├── tests/
│   ├── agents/                🔍 Agent framework validation
│   ├── workflow/              🔄 Workflow integrity (refs, paths, gates, invariants)
│   ├── [game-specific tests]
│   └── [spawned by test-setup]
├── production/                📊 Sprint plans, session logs
└── ...                        🎮 Game source & assets

The OCGS plugin system is documented in .opencode/plugins/README.md. Three TypeScript plugins implement the original 12 CCGS bash hooks plus extensions:

All 12 bash hooks from CCGS ported to ccgs-hooks.ts:

Pi and oh-my-pi run the same 12 hooks from .pi/extensions/ocgs-hooks/. See docs/pi-extensions.md.

🧪 Run plugin test suite: npm run test:plugins (needs the tsx ESM loader — see CONTRIBUTING.md) 🧪 Run workflow integrity suite: node tests/workflow/run-all.mjs 🧪 Run e2e parity suite: npm run test:parity (requires both the opencode and pi CLIs installed)

See CONTRIBUTING.md for guides on adding agents, skills, commands, rules, and plugins.

🎬  creative-director    🔧  technical-director    🎯  producer
├── 🎨  art-director        ├── 💻  lead-programmer
├── 🎵  audio-director      ├── 🧪  qa-lead
├── 📖  narrative-director  ├── 📦  release-manager
├── 🎮  game-designer       └── 🌍  localization-lead
└── ... (52 agents total)

MIT — Free for any use.

_{Built with ❤️ for AI-assisted game development
OpenCode Game Studios · CCGS Port
MIT License · Free for any use}

☕ Support development