codex-game-studios/README.md

Codex Game Studios

Codex Game Studios is a Codex plugin for game-production workflows. It follows the normal plugin layout: .codex-plugin/plugin.json points to ./skills/, and skills expose the runtime workflows directly. Do not use a global ~/.codex/skills/codex-game-studio bridge as the plugin entry point.

Current State

• Skills:
  • $brainstorm guides game concept ideation into design/gdd/game-concept.md.
  • $setup-engine configures engine/version, technical preferences, engine reference docs, and specialist routing.
• Runtime agents:
  • Director agents: creative-director, art-director, technical-director, producer
  • Godot specialists: godot-specialist, godot-gdscript-specialist, godot-csharp-specialist, godot-shader-specialist, godot-gdextension-specialist
  • Unity specialists: unity-specialist, unity-dots-specialist, unity-shader-specialist, unity-addressables-specialist, unity-ui-specialist
  • Unreal specialists: unreal-specialist, ue-blueprint-specialist, ue-gas-specialist, ue-replication-specialist, ue-umg-specialist
• Runtime source: runtime/agents/
• Project guide template: project-template/AGENTS.md
• References: references/studio-docs/director-gates.md, references/studio-docs/templates/game-concept.md, references/studio-docs/templates/game-pillars.md, references/studio-docs/templates/technical-preferences.md, references/engine-reference/
• Standards: standards/design-docs.md
• Marketplace: .agents/plugins/marketplace.json
• No hooks, rules, MCP servers, or app integrations yet

$setup-engine is the next technical step after $brainstorm: it pins the engine version, writes the Technology Stack section in AGENTS.md, creates docs/technical-preferences.md, and seeds docs/engine-reference/<engine>/.

Review Intensity

production/review-mode.txt controls review-gate intensity:

• full: all gates active — every workflow step reviewed.
• lean: PHASE-GATEs only (/gate-check) — per-skill gates skipped.
• solo: no director gates anywhere.

Runtime Setup

To install the bundled custom agents into a game project, run the installer directly:

python3 scripts/install_codex_runtime.py /path/to/game-project

The installer writes all bundled director and engine specialist agents plus the project guide to:

/path/to/game-project/.codex/agents/
/path/to/game-project/AGENTS.md

Each runtime agent is a standalone TOML file with name, description, and developer_instructions, matching Codex custom-agent conventions.

If the target project already has a different AGENTS.md, the installer reports a conflict and leaves it unchanged. Use --force-agents-md only when you intend to overwrite it.

Packaging Hygiene

Only plugin source files should be packaged. .git/, .env, .DS_Store, local caches, and generated artifacts are not part of the plugin runtime. Run the validation script before publishing or refreshing an installed cache:

python3 scripts/validate_plugin.py