TRENDSHIFT #7 딥다이브 · 2026-03-23 분석
Claude Code Game Studios 딥다이브
— 49명의 AI 전문가로 이루어진 게임 개발 스튜디오 템플릿
혼자 게임을 만들고 싶지만 기획자·아트디렉터·QA까지 다 혼자 해야 한다는 게 막막했나요? Claude Code Game Studios는 49개 에이전트 + 73개 워크플로우 스킬 + 12개 자동화 훅으로 Claude Code 세션 하나를 완전한 게임 스튜디오 조직으로 탈바꿈시킵니다. (저장소: Donchitos/Claude-Code-Game-Studios · ⭐20.8k · 마크다운 + 셸 스크립트 · MIT)
1프로젝트 한줄 요약
Claude Code Game Studios가 정확히 무엇을 하는가
Claude Code Game Studios는 하나의 Claude Code 세션을 49명의 전문 AI 에이전트로 구성된 게임 개발 스튜디오로 변환하는 프로젝트 템플릿입니다. 단일 AI 어시스턴트가 아니라, 크리에이티브 디렉터 → 부서장 → 전문가로 이어지는 3계층 조직을 Claude Code의 에이전트/스킬/훅/룰 시스템으로 구현했습니다. 49개 에이전트, 73개 워크플로우 스킬, 12개 자동화 훅, 11개 경로별 코딩 규칙을 포함합니다.
한 컷 비유
"솔로 개발자가 아니라, AI 스튜디오의 사장이 되는 경험"
혼자 게임을 만들면 기획·코딩·아트·사운드·QA를 한 사람이 다 해야 합니다. Claude Code Game Studios는 이 각 역할을 전문 에이전트에게 위임합니다. 당신은 "전투 시스템 만들어줘"라고 한마디만 하면 됩니다.
에이전트들이 선택지를 제안하고, 당신이 결정하고, 에이전트들이 실행합니다. 코드 한 줄 없이 마크다운 파일 49개로 완전한 스튜디오 조직을 구성한 것이 이 프로젝트의 가장 흥미로운 점입니다.
2왜 주목받는가
트렌딩 이유와 경쟁 대비 차별점
기존 방식의 한계
Claude Code를 단일 어시스턴트로만 쓸 때
일반적으로 Claude Code는 "코드를 작성하는 AI 어시스턴트"로 씁니다. 그런데 게임처럼 복잡한 프로젝트에서는 기획·아키텍처·아트·QA 등 도메인이 전혀 다른 전문가가 필요합니다. 단일 어시스턴트는 모든 것을 다 알려고 하다가 초점이 흐려지고, 품질이 일관되지 않습니다.
이 레포의 해법
49명의 전문가가 자기 영역에만 집중
각 에이전트는 자기 도메인 밖의 결정을 절대 하지 않습니다. Creative Director는 코드를 건드리지 않고, Lead Programmer는 아트 방향을 결정하지 않습니다. "협업이지 자율실행이 아님" — 모든 결정은 사용자가 내립니다.
경쟁 도구 대비 위치
| 비교 대상 | Claude Code Game Studios 차별점 |
|---|
| 일반 Claude Code 사용 | 비구조적 대화 vs 49명 전문가 팀 + 73개 워크플로우 스킬 |
| Cursor/Windsurf 게임 개발 | 에디터 보조 vs 프로덕션 파이프라인 전체 커버 |
| obra/superpowers | 범용 에이전트 프레임워크 vs 게임 개발 도메인 특화 |
| ChatGPT로 게임 만들기 | 자유 대화 vs 검증 게이트 + 품질 자동화 |
핵심 철학: Question → Options → Decision → Draft → Approval 프로토콜 — 에이전트가 자율 실행하는 것이 아니라, 선택지를 제안하고 사용자 승인을 받은 뒤 실행합니다.
3기술 스택 전체 지도
Claude Code 생태계 구성 요소 전체
┌─────────────────────────────────────────────────────────┐
│ Claude Code 생태계 │
├─────────────────────────────────────────────────────────┤
│ 에이전트 시스템 │ .claude/agents/*.md (49개) │
│ 스킬 시스템 │ .claude/skills/*/SKILL.md (73개) │
│ 훅 시스템 │ .claude/hooks/*.sh (12개, Bash/POSIX)│
│ 룰 시스템 │ .claude/rules/*.md (11개) │
│ 설정 │ .claude/settings.json │
│ 마스터 구성 │ CLAUDE.md │
├─────────────────────────────────────────────────────────┤
│ 지원 도구 │
├─────────────────────────────────────────────────────────┤
│ jq │ 훅에서 JSON 파싱 (선택적) │
│ Python 3 │ JSON 유효성 검증 (선택적) │
│ Git │ 버전 관리 + 훅 트리거 │
│ Bash/POSIX sh │ 모든 자동화 스크립트 │
├─────────────────────────────────────────────────────────┤
│ 지원 게임 엔진 (사용자 선택) │
├─────────────────────────────────────────────────────────┤
│ Godot 4 │ GDScript, Shaders, GDExtension │
│ Unity │ C#, DOTS/ECS, Addressables, URP/HDRP│
│ Unreal Engine 5 │ C++, Blueprint, GAS, CommonUI │
└─────────────────────────────────────────────────────────┘
핵심 인사이트
코드가 없는 프로젝트
이 레포에는 런타임 코드가 단 한 줄도 없습니다. 모든 파일은 마크다운(.md), 셸 스크립트(.sh), JSON 설정 파일입니다. "기술 스택"이란 곧 Claude Code의 구성 시스템 자체를 의미합니다. 프롬프트 엔지니어링과 에이전트 오케스트레이션만으로 복잡한 시스템을 구축한 것입니다.
4아키텍처 심화 분석
3계층 조직 구조와 4가지 핵심 설계 패턴
시스템 구조도
┌─────────────┐
│ 사용자 │
│ (게임 개발자) │
└──────┬──────┘
│ 질문 → 선택지 → 결정 → 초안 → 승인
▼
┌────────────────────────┐
│ CLAUDE.md │
│ (마스터 구성 파일) │
└────────────┬───────────┘
│
┌──────────────────┼──────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐
│ Tier 1: 디렉터 │ │ 스킬(73개) │ │ 훅(12개) │
│ Creative Dir. │ │ /start │ │ validate-commit │
│ Technical Dir. │ │ /brainstorm │ │ validate-push │
│ Producer │ │ /team-combat │ │ session-start │
│ (Opus 모델) │ │ /sprint-plan │ │ session-stop │
└───────┬─────────┘ └──────────────┘ └──────────────────┘
│
▼
┌─────────────────┐ ┌──────────────────┐
│ Tier 2: 부서장 │ │ 룰(11개) │
│ Game Designer │ │ gameplay-code.md │
│ Lead Programmer │ │ engine-code.md │
│ Art Director │ │ ai-code.md │
│ Audio Director │ │ network-code.md │
│ Narrative Dir. │ │ ... │
│ QA Lead │ └──────────────────┘
│ Release Manager │
│ Localization Ld │
│ (Sonnet 모델) │
└───────┬─────────┘
▼
┌─────────────────┐
│ Tier 3: 전문가 │
│ Gameplay Prog. │
│ AI Programmer │
│ Technical Artist│
│ Sound Designer │
│ QA Tester │
│ (Sonnet/Haiku)│
└─────────────────┘
패턴 1 — 계층적 위임 (Hierarchical Delegation)
사용자: "전투 시스템 만들어줘"
│
├─→ Creative Director: 비전/톤/감정 목표 설정
├─→ Technical Director: 기술적 실현 가능성 판단
├─→ Producer: 일정/범위 조율
│ ├─→ Game Designer: 메카닉 설계 + 공식 정의
│ ├─→ Lead Programmer: 아키텍처 결정
│ │ ├─→ Gameplay Programmer: 전투 로직
│ │ ├─→ AI Programmer: 적 AI 행동
│ │ └─→ Network Programmer: 멀티플레이어 동기화
│ └─→ Art Director → Technical Artist: 셰이더/VFX
└─→ QA Lead → QA Tester: 테스트 계획 + 실행
패턴 2 — 사용자 게이트 (User-Gated Decisions)
에이전트 작업 흐름:
1. 맥락 파악 (문서 리뷰 + 질문)
2. 선택지 2~4개 제시 (장단점 포함)
3. 사용자 결정 대기 ← 게이트
4. 초안 작성
5. 사용자 승인 대기 ← 게이트
6. 최종 실행
패턴 3 — 경로 기반 규칙 자동 적용 (Path-Scoped Rules)
파일 경로 → 자동 적용 규칙
─────────────────────────────────────
src/gameplay/** → 데이터 주도 설계 필수, 하드코딩 금지
src/core/** → 제로 할당, 스레드 안전성, API 안정성
src/ai/** → 성능 예산, 디버그 가능성
src/networking/** → 서버 권위적, 메시지 버전닝
src/ui/** → 게임 상태 비소유, 접근성 필수
design/gdd/** → 8개 필수 섹션
tests/** → 네이밍 컨벤션, 커버리지 요구사항
prototypes/** → 완화된 기준, 가설 문서화 필수
패턴 4 — 자동화 훅 파이프라인
# validate-commit.sh 핵심 로직
# 하드코딩 값 감지 — src/gameplay/ 내 "damage = 50" 같은 패턴
grep -rn 'damage\|health\|speed\|rate\|chance\|cost\|duration' \
--include="*.gd" --include="*.cs" --include="*.cpp" src/gameplay/
# TODO 형식 체크 — TODO(이름) 형식 강제
grep -rn 'TODO\|FIXME\|HACK' src/ | grep -v '(.*)'
5디렉토리 구조 해부
핵심 디렉토리와 파일 역할
Claude-Code-Game-Studios/
├── CLAUDE.md # 마스터 구성 — 프로젝트 메타, 엔진 선택, 글로벌 규칙
├── UPGRADING.md # 이전 버전 마이그레이션 가이드
├── LICENSE
│
├── .claude/ # ★ 핵심: Claude Code 구성 전체
│ ├── settings.json # 훅, 권한, 룰 등록
│ ├── agents/ # 49개 에이전트 정의 (.md)
│ │ ├── creative-director.md # Tier 1
│ │ ├── technical-director.md # Tier 1
│ │ ├── producer.md # Tier 1
│ │ ├── game-designer.md # Tier 2
│ │ ├── gameplay-programmer.md # Tier 3
│ │ ├── godot-specialist.md # 엔진별 전문가
│ │ └── ... (총 49개)
│ ├── skills/ # 73개 슬래시 커맨드 워크플로우
│ │ ├── start/SKILL.md # /start — 온보딩 진입점
│ │ ├── brainstorm/SKILL.md # /brainstorm — 아이디어 발굴
│ │ ├── team-combat/SKILL.md # /team-combat — 전투 팀 오케스트레이션
│ │ └── ... (총 73개)
│ ├── hooks/ # 12개 자동화 스크립트
│ │ ├── validate-commit.sh # 커밋 전 코드 품질 검증
│ │ ├── session-start.sh # 세션 시작 시 컨텍스트 로딩
│ │ └── log-agent.sh # 에이전트 호출 추적
│ ├── rules/ # 11개 경로별 코딩 표준
│ └── docs/ # 내부 문서 + 38개 문서 템플릿 (하위 폴더 포함 시 41개)
│
├── docs/ # 외부 문서
│ ├── engine-reference/ # Godot/Unity/UE5 레퍼런스 (각 5~7개 파일)
│ └── examples/ # 세션 예시 (설계, 구현, 스코프 위기)
│
├── src/ # 게임 소스코드 (사용자가 채움)
├── assets/ # 아트/오디오/VFX/셰이더/데이터
├── design/ # GDD, 내러티브, 레벨 설계
├── tests/ # 테스트 스위트
├── production/ # 스프린트·마일스톤·릴리스 관리
├── tools/ # 빌드·파이프라인 도구
└── prototypes/ # src/와 격리된 버려질 프로토타입
6학습 포인트 (기술별)
이 레포에서 무엇을 배울 수 있는가
6-1. Claude Code 에이전트 시스템 설계
배울 것: 에이전트를 .md 파일로 정의하는 방법 — 역할, 책임, 위임 체인, 금지 행동을 구조화합니다. 3계층(Director → Lead → Specialist) 위임 모델의 설계 원리와 모델별 역할 배정(Opus=전략적 결정, Sonnet=실행, Haiku=단순 작업)을 익힐 수 있습니다.
에이전트 정의 구조
creative-director.md 핵심 섹션
역할 요약 / 핵심 책임 / 의사결정 프레임워크 6단계 필터 / 위임 맵 / 금지 행동(Prohibited Actions) — 이 섹션이 도메인 경계를 강제합니다.
6-2. 스킬(Slash Commands) 워크플로우 설계
배울 것: SKILL.md 파일 구조로 복잡한 워크플로우를 단계별로 정의하는 방법. /team-combat 같은 팀 오케스트레이션 스킬의 6단계 파이프라인: Design → Architecture → Implementation(병렬) → Integration → Validation → Sign-off.
6-3. 훅(Hooks) 자동화 시스템
배울 것: PreToolUse 훅으로 git commit 전에 코드 품질 자동 검증. JSON 파싱: jq 우선 → 정규식 폴백 패턴(POSIX 호환성). 훅 종료 코드 전략: 0(경고만, 진행) vs 2(블로킹).
6-4. 게임 개발 프로세스 프레임워크
배울 것: MDA 프레임워크(Mechanics → Dynamics → Aesthetics), 자기결정이론(SDT)으로 플레이어 동기 설계, Bartle 플레이어 유형(Achiever/Explorer/Socializer/Killer) 기반 타겟팅.
7하드웨어 / 시스템 요구사항
이 레포를 사용하기 위해 필요한 것
| 항목 | 요구사항 |
|---|
| 필수 | Git, Claude Code CLI (npm install -g @anthropic-ai/claude-code) |
| 권장 | jq (JSON 파싱), Python 3 (JSON 유효성 검증) |
| OS | Windows 10+ (Git Bash), macOS, Linux |
| Claude 모델 | Opus (디렉터), Sonnet (부서장/전문가), Haiku (경량 작업) |
| 게임 엔진 | Godot 4 / Unity / Unreal Engine 5 (선택) |
| Anthropic 요금 | 49개 에이전트 활용 시 API 비용 상당 — Opus 사용 빈도 주의 |
비용 주의
Opus 모델 사용 비용
디렉터 레벨 에이전트가 Opus를 사용하므로, 빈번한 디렉터 레벨 결정이 필요한 초기 설계 단계에서 비용이 높을 수 있습니다. Sonnet으로 대체 테스트 후 Opus로 업그레이드하는 전략을 권장합니다.
8직접 해볼 수 있는 실습 과제
난이도별 3~5개 과제
TASK 01
기본 — 클론하고 /start 실행하기 ⭐ 초급
에이전트가 어떤 질문을 하는지 관찰하고, 워크플로우 라우팅을 이해합니다.
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game && claude && /start
TASK 02
중급 — 자기 도메인용 에이전트 3개 만들기 ⭐⭐ 중급
이 프로젝트의 에이전트 구조를 참고하여 웹 개발 스튜디오 버전을 만들어보세요. frontend-architect.md(Creative Director 참고), backend-lead.md, devops-specialist.md를 작성합니다. 각 에이전트에 포함할 것: 역할 요약, 핵심 책임, 위임 맵, 결정 프레임워크, 금지 행동.
TASK 03
중급 — 팀 오케스트레이션 스킬 작성 ⭐⭐ 중급
/team-combat SKILL.md를 분석하고, /team-feature(새 기능 개발 팀 조율) 스킬을 작성합니다. Phase 1: 요구사항 분석 → Phase 2: 기술 설계 → Phase 3: 구현(병렬) → Phase 4: 테스트+리뷰 → Phase 5: 배포.
TASK 04
고급 — 커밋 검증 훅 커스터마이징 ⭐⭐⭐ 고급
validate-commit.sh를 기반으로 TypeScript 프로젝트용 커밋 훅을 작성합니다. console.log 남아있으면 경고, 환경변수 하드코딩 감지(API_KEY, SECRET 등), 커밋 메시지 컨벤셔널 커밋 형식 검증.
TASK 05
고급 — SaaS 개발 스튜디오 템플릿 구축 ⭐⭐⭐⭐ 도전
Claude Code Game Studios의 전체 구조를 참고하여 SaaS 개발 스튜디오 템플릿을 구축합니다. CEO/CTO/CPO(Tier 1), Engineering Lead/Design Lead/Data Lead(Tier 2), Frontend/Backend/ML/QA(Tier 3). 스킬: /kickoff, /sprint, /deploy, /incident-response.
9관련 기술 심화 학습 로드맵
4주 커리큘럼
1주차 — Claude Code 기초 마스터
| 일 | 학습 내용 |
|---|
| 1~2일 | Claude Code CLI 설치, CLAUDE.md 구성법, 기본 명령어 |
| 3~4일 | 에이전트(.md) 작성법 — 역할, 모델, 위임 규칙 정의 |
| 5~7일 | 스킬(SKILL.md) 작성법 — 단계별 워크플로우 정의 |
2주차 — 자동화와 규칙 시스템
| 일 | 학습 내용 |
|---|
| 1~2일 | 훅(hooks) — PreToolUse, PostToolUse, 세션 라이프사이클 |
| 3~4일 | 경로별 규칙(rules) — 파일 패턴 매칭, 자동 적용 |
| 5~7일 | settings.json — 권한 관리, 허용/차단 명령어 설정 |
3주차 — 멀티 에이전트 오케스트레이션
| 일 | 학습 내용 |
|---|
| 1~2일 | 에이전트 계층 설계 — Director/Lead/Specialist 패턴 |
| 3~4일 | 팀 스킬 — 다중 에이전트 파이프라인(병렬/직렬 실행) |
| 5~7일 | 충돌 해소 — 에스컬레이션 프로토콜, 도메인 경계 설정 |
4주차 — 실전 프로젝트 적용
| 일 | 학습 내용 |
|---|
| 1~2일 | 자기 프로젝트에 맞는 스튜디오 템플릿 구축 |
| 3~4일 | 문서 템플릿 커스터마이징 (ADR, 스프린트, 릴리스) |
| 5~7일 | 전체 통합 테스트 — 실제 프로젝트에서 워크플로우 실행 |
10핵심 키워드 사전
이 레포를 이해하는 데 꼭 필요한 개념들
| 키워드 | 설명 |
|---|
| 에이전트(Agent) | Claude Code의 서브프로세스. .claude/agents/에 마크다운으로 정의되며, 특정 역할과 도메인을 가진 AI 전문가 역할을 수행 |
| 스킬(Skill) | Claude Code의 슬래시 커맨드(/start, /brainstorm 등). SKILL.md에 정의된 단계별 워크플로우 |
| 훅(Hook) | 특정 이벤트(커밋, 푸시, 세션 시작 등)에 자동 실행되는 셸 스크립트. 품질 게이트 역할 |
| 경로별 규칙 | 파일 경로 패턴에 따라 자동 적용되는 코딩 표준. src/gameplay/**에만 적용되는 규칙 등 |
| PreToolUse | Claude Code 훅 이벤트. 도구(git commit 등) 실행 직전에 검증 로직을 삽입하는 시점 |
| MDA 프레임워크 | Mechanics-Dynamics-Aesthetics. 게임 디자인을 3계층으로 분석하는 프레임워크 |
| GDD | Game Design Document. 게임의 메카닉, 시스템, 규칙을 정의하는 설계 문서 |
| ADR | Architecture Decision Record. 기술적 결정의 맥락, 선택지, 결론을 기록하는 문서 |
| 사용자 게이트 | 에이전트가 자율 실행하지 않고 사용자 승인을 대기하는 체크포인트 |
| 위임 체인 | Director → Lead → Specialist로 이어지는 작업 위임 경로 |
| 데이터 주도 설계 | 게임플레이 수치를 코드에 하드코딩하지 않고 외부 설정 파일로 관리하는 패턴 |
| POSIX 호환 | Unix 계열 OS 간 이식성을 보장하는 셸 스크립트 표준 |
11참고 링크
더 깊이 공부하려면