Game Studio Agent Architecture — complete setup (Phases 1-7)

48 coordinated Claude Code subagents for indie game development:
- 3 leadership agents (creative-director, technical-director, producer)
- 10 department leads (game-designer, lead-programmer, art-director, etc.)
- 23 specialist agents (gameplay, engine, AI, networking, UI, tools, etc.)
- 12 engine-specific agents (Godot, Unity, Unreal with sub-specialists)

Infrastructure:
- 34 skills (slash commands) for workflows, reviews, and team orchestration
- 8 hooks for commit validation, asset checks, session management
- 11 path-scoped rules enforcing domain-specific standards
- 28 templates for design docs, reports, and collaborative protocols

Key features:
- User-driven collaboration protocol (Question → Options → Decision → Draft → Approval)
- Engine version awareness with knowledge-gap detection (Godot 4.6 pinned)
- Phase gate system for development milestone validation
- CLAUDE.md kept under 80 lines with extracted doc imports

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.claude/docs/setup-requirements.md

@@ -0,0 +1,80 @@
+# Setup Requirements
+
+This template requires a few tools to be installed for full functionality.
+All hooks fail gracefully if tools are missing — nothing will break, but
+you'll lose validation features.
+
+## Required
+
+| Tool | Purpose | Install |
+| ---- | ---- | ---- |
+| **Git** | Version control, branch management | [git-scm.com](https://git-scm.com/) |
+| **Claude Code** | AI agent CLI | `npm install -g @anthropic-ai/claude-code` |
+
+## Recommended
+
+| Tool | Used By | Purpose | Install |
+| ---- | ---- | ---- | ---- |
+| **jq** | Hooks (4 of 8) | JSON parsing in commit/push/asset/agent hooks | See below |
+| **Python 3** | Hooks (2 of 8) | JSON validation for data files | [python.org](https://www.python.org/) |
+| **Bash** | All hooks | Shell script execution | Included with Git for Windows |
+
+### Installing jq
+
+**Windows** (any of these):
+```
+winget install jqlang.jq
+choco install jq
+scoop install jq
+```
+
+**macOS**:
+```
+brew install jq
+```
+
+**Linux**:
+```
+sudo apt install jq     # Debian/Ubuntu
+sudo dnf install jq     # Fedora
+sudo pacman -S jq       # Arch
+```
+
+## Platform Notes
+
+### Windows
+- Git for Windows includes **Git Bash**, which provides the `bash` command
+  used by all hooks in `settings.json`
+- Ensure Git Bash is on your PATH (default if installed via the Git installer)
+- Hooks use `bash .claude/hooks/[name].sh` — this works on Windows because
+  Claude Code invokes commands through a shell that can find `bash.exe`
+
+### macOS / Linux
+- Bash is available natively
+- Install `jq` via your package manager for full hook support
+
+## Verifying Your Setup
+
+Run these commands to check prerequisites:
+
+```bash
+git --version          # Should show git version
+bash --version         # Should show bash version
+jq --version           # Should show jq version (optional)
+python3 --version      # Should show python version (optional)
+```
+
+## What Happens Without Optional Tools
+
+| Missing Tool | Effect |
+| ---- | ---- |
+| **jq** | Commit validation, push protection, asset validation, and agent audit hooks silently skip their checks. Commits and pushes still work. |
+| **Python 3** | JSON data file validation in commit and asset hooks is skipped. Invalid JSON can be committed without warning. |
+| **Both** | All hooks still execute without error (exit 0) but provide no validation. You're flying without safety nets. |
+
+## Recommended IDE
+
+Claude Code works with any editor, but the template is optimized for:
+- **VS Code** with the Claude Code extension
+- **Cursor** (Claude Code compatible)
+- Terminal-based Claude Code CLI