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/hooks/detect-gaps.sh

@@ -0,0 +1,119 @@
+#!/bin/bash
+# Hook: detect-gaps.sh
+# Event: SessionStart
+# Purpose: Detect missing documentation when code/prototypes exist
+# Cross-platform: Windows Git Bash compatible (uses grep -E, not -P)
+
+# Exit on error for debugging (but don't fail the session)
+set +e
+
+echo "=== Checking for Documentation Gaps ==="
+
+# --- Check 1: Substantial codebase but sparse design docs ---
+if [ -d "src" ]; then
+  # Count source files (cross-platform, handles Windows paths)
+  SRC_FILES=$(find src -type f \( -name "*.gd" -o -name "*.cs" -o -name "*.cpp" -o -name "*.c" -o -name "*.h" -o -name "*.hpp" -o -name "*.rs" -o -name "*.py" -o -name "*.js" -o -name "*.ts" \) 2>/dev/null | wc -l)
+else
+  SRC_FILES=0
+fi
+
+if [ -d "design/gdd" ]; then
+  DESIGN_FILES=$(find design/gdd -type f -name "*.md" 2>/dev/null | wc -l)
+else
+  DESIGN_FILES=0
+fi
+
+# Normalize whitespace from wc output
+SRC_FILES=$(echo "$SRC_FILES" | tr -d ' ')
+DESIGN_FILES=$(echo "$DESIGN_FILES" | tr -d ' ')
+
+if [ "$SRC_FILES" -gt 50 ] && [ "$DESIGN_FILES" -lt 5 ]; then
+  echo "⚠️  GAP: Substantial codebase ($SRC_FILES source files) but sparse design docs ($DESIGN_FILES files)"
+  echo "    Suggested action: /reverse-document design src/[system]"
+  echo "    Or run: /project-stage-detect to get full analysis"
+fi
+
+# --- Check 2: Prototypes without documentation ---
+if [ -d "prototypes" ]; then
+  PROTOTYPE_DIRS=$(find prototypes -mindepth 1 -maxdepth 1 -type d 2>/dev/null)
+  UNDOCUMENTED_PROTOS=()
+
+  if [ -n "$PROTOTYPE_DIRS" ]; then
+    while IFS= read -r proto_dir; do
+      # Normalize path separators for Windows
+      proto_dir=$(echo "$proto_dir" | sed 's|\\|/|g')
+
+      # Check for README.md or CONCEPT.md
+      if [ ! -f "${proto_dir}/README.md" ] && [ ! -f "${proto_dir}/CONCEPT.md" ]; then
+        proto_name=$(basename "$proto_dir")
+        UNDOCUMENTED_PROTOS+=("$proto_name")
+      fi
+    done <<< "$PROTOTYPE_DIRS"
+
+    if [ ${#UNDOCUMENTED_PROTOS[@]} -gt 0 ]; then
+      echo "⚠️  GAP: ${#UNDOCUMENTED_PROTOS[@]} undocumented prototype(s) found:"
+      for proto in "${UNDOCUMENTED_PROTOS[@]}"; do
+        echo "    - prototypes/$proto/ (no README or CONCEPT doc)"
+      done
+      echo "    Suggested action: /reverse-document concept prototypes/[name]"
+    fi
+  fi
+fi
+
+# --- Check 3: Core systems without architecture docs ---
+if [ -d "src/core" ] || [ -d "src/engine" ]; then
+  if [ ! -d "docs/architecture" ]; then
+    echo "⚠️  GAP: Core engine/systems exist but no docs/architecture/ directory"
+    echo "    Suggested action: Create docs/architecture/ and run /architecture-decision"
+  else
+    ADR_COUNT=$(find docs/architecture -type f -name "*.md" 2>/dev/null | wc -l)
+    ADR_COUNT=$(echo "$ADR_COUNT" | tr -d ' ')
+
+    if [ "$ADR_COUNT" -lt 3 ]; then
+      echo "⚠️  GAP: Core systems exist but only $ADR_COUNT ADR(s) documented"
+      echo "    Suggested action: /reverse-document architecture src/core/[system]"
+    fi
+  fi
+fi
+
+# --- Check 4: Gameplay systems without design docs ---
+if [ -d "src/gameplay" ]; then
+  # Find major gameplay subdirectories (those with 5+ files)
+  GAMEPLAY_SYSTEMS=$(find src/gameplay -mindepth 1 -maxdepth 1 -type d 2>/dev/null)
+
+  if [ -n "$GAMEPLAY_SYSTEMS" ]; then
+    while IFS= read -r system_dir; do
+      system_dir=$(echo "$system_dir" | sed 's|\\|/|g')
+      system_name=$(basename "$system_dir")
+      file_count=$(find "$system_dir" -type f 2>/dev/null | wc -l)
+      file_count=$(echo "$file_count" | tr -d ' ')
+
+      # If system has 5+ files, check for corresponding design doc
+      if [ "$file_count" -ge 5 ]; then
+        # Check for design doc (allow variations: combat-system.md, combat.md)
+        design_doc_1="design/gdd/${system_name}-system.md"
+        design_doc_2="design/gdd/${system_name}.md"
+
+        if [ ! -f "$design_doc_1" ] && [ ! -f "$design_doc_2" ]; then
+          echo "⚠️  GAP: Gameplay system 'src/gameplay/$system_name/' ($file_count files) has no design doc"
+          echo "    Expected: design/gdd/${system_name}-system.md or design/gdd/${system_name}.md"
+          echo "    Suggested action: /reverse-document design src/gameplay/$system_name"
+        fi
+      fi
+    done <<< "$GAMEPLAY_SYSTEMS"
+  fi
+fi
+
+# --- Check 5: Production planning ---
+if [ "$SRC_FILES" -gt 100 ]; then
+  # For projects with substantial code, check for production planning
+  if [ ! -d "production/sprints" ] && [ ! -d "production/milestones" ]; then
+    echo "⚠️  GAP: Large codebase ($SRC_FILES files) but no production planning found"
+    echo "    Suggested action: /sprint-plan or create production/ directory"
+  fi
+fi
+
+# --- Summary ---
+echo ""
+echo "💡 To get a comprehensive project analysis, run: /project-stage-detect"
+echo "==================================="