Kiro Game Studio

Turn a Kiro project into a coordinated game-development studio. kgd is a terminal CLI that scaffolds a studio config — agent personas, path-scoped coding rules, and automation hooks — into any project's .kiro/ folder.

It is a Kiro-native reimagining of the "AI game studio" idea: a tiered set of specialist roles, a collaborative (not autopilot) workflow, and quality gates baked into the project.

What gets installed

Into <your-project>/.kiro/:

• steering/ — always-on studio config (hierarchy, collaboration protocol, coding/design/testing standards, context management).
• steering/rules/ — 11 path-scoped rules that auto-apply by file location (gameplay, engine, AI, network, UI, shaders, design docs, narrative, data, tests, prototypes).
• steering/agents/ — agent personas you load on demand with #name (3 directors, 8 leads, 6 specialists, plus engine-specific leads/specialists).
• skills/ — workflow guides you load with #skill-name: 15 core skills plus engine-specific ones.
• hooks/ — 4 automation hooks (session orientation, gap detection, pre-commit check, asset validation).

Engine tracks

Pick one at install time. Engine-specific agents and skills install only for the selected track:

• --godot / --unity / --unreal — that engine's specialist agent + setup skill.
• --scratch — the no-engine track: build a game in raw code. Adds 4 agents (custom-engine-architect, game-loop / rendering / platform programmers) and 5 skills (from-scratch-setup, game-loop-design, build-ecs, rendering-pipeline, asset-loading).
• --engine none (default) — core studio only, no engine specialists.

Requirements

• Python 3.9+
• uv (recommended) or pip

The CLI has zero runtime dependencies — only the Python standard library.

Install & use

Run it straight from the repo without installing:

uvx --from . kgd install --godot

Or install the tool once and use it anywhere:

uv tool install .
cd path/to/your/game
kgd install --unity

With pip instead of uv:

pip install .
kgd install

Commands

kgd install                 Scaffold .kiro/ into the current project
kgd install --godot         Include the Godot agent + skill set (also: --unity, --unreal)
kgd install --scratch       Include the no-engine (from-scratch) agent + skill set
kgd install --engine none   No engine specialists (default)
kgd install --force         Overwrite files that already exist
kgd install --dry-run       Show what would change, write nothing
kgd install --target DIR    Install into DIR instead of the current directory
kgd list                    List the bundled agents, rules, skills, and hooks
kgd uninstall               Remove studio-managed files from .kiro/
kgd --version

kgd --install --godot works as an alias for kgd install --godot.

How the studio works

Agents are organized in three tiers — directors guard vision, leads own domains, specialists do hands-on work. The workflow is collaborative:

Question → Options → Decision → Draft → Approval.

You make every decision; the personas bring structure, expertise, and quality gates. Load a persona into a Kiro chat with #creative-director, #lead-programmer, and so on.

Layout of this repo

pyproject.toml              # `kgd` entry point, uv-ready, no runtime deps
src/kgd/
  cli.py                    # argument parsing and commands
  installer.py              # copy payload into a target .kiro/
  templates/kiro/           # the payload that gets installed
docs/                       # README, TODO, CHANGELOG

Credits

Inspired by the "Claude Code Game Studios" concept. This is an independent, Kiro-native reimplementation — all files are original, no upstream content is copied. Licensed under MIT.