61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# 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`
|
|
and `design/gdd/game-pillars.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`, `references/studio-docs/templates/game-pillars.md`
|
|
- Standards: `standards/design-docs.md`
|
|
- Marketplace: `.agents/plugins/marketplace.json`
|
|
- No hooks, rules, MCP servers, or app integrations yet
|
|
|
|
## Review Intensity
|
|
|
|
`production/review-mode.txt` controls review-gate intensity:
|
|
|
|
- `full`: all key director / lead review gates call their custom agents.
|
|
- `lean`: only PHASE-GATE review gates such as `/gate-check` call directors;
|
|
ordinary per-skill review gates are skipped.
|
|
- `solo`: all director review gates are skipped.
|
|
|
|
This is not a global off switch for all custom agents. Future team workflows may
|
|
still call specialist subagents as part of their core work.
|
|
|
|
## 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
|
|
```
|