# 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:
  - `$using-codex-game-studios` explains the plugin workflow and entry points.
  - `$setup-runtime` installs bundled director agents into a target game project.
  - `$brainstorm` guides game concept ideation into `design/gdd/game-concept.md`.
- Runtime agents: `creative-director`, `art-director`, `technical-director`, `producer`
- Runtime source: `runtime/agents/`
- References: `references/studio-docs/director-gates.md`, `references/studio-docs/templates/game-concept.md`
- Standards: `standards/design-docs.md`
- Marketplace: `.agents/plugins/marketplace.json`
- No hooks, rules, MCP servers, or app integrations yet

## Runtime Setup

To install the bundled custom agents into a game project, invoke `$setup-runtime`
or run the installer directly:

```bash
python3 skills/setup-runtime/scripts/install_codex_runtime.py /path/to/game-project
```

The installer writes custom agents to:

```text
/path/to/game-project/.codex/agents/
```

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

## 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:

```bash
python3 scripts/validate_plugin.py
```