
혼자서 AI로 게임을 만드는 건 강력하다. 하지만 단일 채팅 세션에는 구조가 없다. 매직 넘버를 하드코딩하고, 디자인 문서를 건너뛰고, 스파게티 코드를 작성해도 막아주는 사람이 없다. QA도 없고, 디자인 리뷰도 없고, “이게 게임의 비전에 맞나?”라고 묻는 사람도 없다.
Claude Code Game Studios는 이 문제를 실제 스튜디오의 구조를 AI 세션에 적용해서 해결한다.
무엇이 들어있나
| 카테고리 | 개수 | 설명 |
|---|---|---|
| Agents | 48 | 디자인, 프로그래밍, 아트, 오디오, 내러티브, QA, 프로덕션 전문 에이전트 |
| Skills | 37 | /start, /sprint-plan, /code-review, /brainstorm 등 워크플로우 |
| Hooks | 8 | 커밋, 푸시, 에셋 변경, 세션 라이프사이클 자동 검증 |
| Rules | 11 | 경로 기반 코딩 표준 (gameplay, engine, AI, UI, network 등) |
| Templates | 29 | GDD, ADR, 스프린트 계획, 이코노미 모델, 팩션 디자인 등 |
스튜디오 계층 구조
실제 스튜디어 운영 방식을 그대로 반영한 3단계 계층:
Tier 1 — Directors (Opus)
creative-director— 비전 수호technical-director— 기술 아키텍처producer— 크로스 팀 조율
Tier 2 — Department Leads (Sonnet)
game-designer— 게임 디자인 총괄lead-programmer— 프로그래밍 리드art-director— 아트 디렉션audio-director— 오디오 디렉션narrative-director— 내러티브 디렉션qa-lead— QA 리드release-manager— 릴리즈 관리localization-lead— 로컬라이제이션
Tier 3 — Specialists (Sonnet/Haiku)
| 분야 | 에이전트 |
|---|---|
| 프로그래밍 | gameplay, engine, ai, network, tools, ui |
| 디자인 | systems, level, economy |
| 아트/오디오 | technical-artist, sound-designer |
| 내러티브 | writer, world-builder |
| QA/DevOps | qa-tester, performance-analyst, devops, security |
| 기타 | ux-designer, prototyper, analytics, accessibility, live-ops, community |
게임 엔진 지원
3대 엔진에 맞는 에이전트 세트 제공:
| 엔진 | 리드 에이전트 | 서브 스페셜리스트 |
|---|---|---|
| Godot 4 | godot-specialist | GDScript, Shaders, GDExtension |
| Unity | unity-specialist | DOTS/ECS, Shaders/VFX, Addressables, UI Toolkit |
| Unreal 5 | unreal-specialist | GAS, Blueprints, Replication, UMG/CommonUI |
슬래시 커맨드
Claude Code에서 /를 입력하면 37개 스킬 사용 가능:
리뷰 & 분석
/design-review— 디자인 리뷰/code-review— 코드 리뷰/balance-check— 밸런스 체크/asset-audit— 에셋 감사/scope-check— 스코프 체크/perf-profile— 성능 프로파일링/tech-debt— 기술 부채 분석
프로덕션
/sprint-plan— 스프린트 계획/milestone-review— 마일스톤 리뷰/estimate— 작업 추정/retrospective— 회고/bug-report— 버그 리포트
프로젝트 관리
/start— 프로젝트 시작 (어디에 있는지 물어보고 안내)/project-stage-detect— 기존 프로젝트 분석/reverse-document— 코드에서 문서 역추적/gate-check— 게이트 체크/map-systems— 시스템 매핑/design-system— 디자인 시스템
릴리즈
/release-checklist— 릴리즈 체크리스트/launch-checklist— 런치 체크리스트/changelog— 체인지로그/patch-notes— 패치 노트/hotfix— 핫픽스
크리에이티브
/brainstorm— 아이디어 브레인스토밍/playtest-report— 플레이테스트 리포트/prototype— 프로토타입/onboard— 온보딩/localize— 로컬라이제이션
팀 오케스트레이션
/team-combat— 전투 팀/team-narrative— 내러티브 팀/team-ui— UI 팀/team-release— 릴리즈 팀/team-polish— 폴리시 팀/team-audio— 오디오 팀/team-level— 레벨 팀
작동 방식
위임 모델
Vertical: Directors → Leads → Specialists
Horizontal: 같은 티어끼리 컨설테이션 (바인딩 결정은 불가)
Conflict: 공통 부모로 에스컬레이션
협업 프로토콜
이것은 오토파일럿이 아니다.
- Ask — 에이전트는 해결책 제안 전에 질문
- Present options — 2-4개 옵션과 장단점 제시
- You decide — 사용자가 결정
- Draft — 확정 전에 초안 보여줌
- Approve — 승인 없이는 아무것도 작성 안 함
당신이 컨트롤한다. 에이전트는 구조와 전문성을 제공, 자율성이 아니다.
자동 검증 (Hooks)
| Hook | 트리거 | 동작 |
|---|---|---|
validate-commit.sh | git commit | 하드코딩 값, TODO 포맷, JSON 유효성, 디자인 문서 섹션 체크 |
validate-push.sh | git push | 보호 브랜치 푸시 경고 |
validate-assets.sh | assets/ 파일 쓰기 | 네이밍 컨벤션, JSON 구조 검증 |
session-start.sh | 세션 시작 | 스프린트 컨텍스트, 최근 git 활동 로드 |
detect-gaps.sh | 세션 시작 | 신규 프로젝트 감지 (/start 제안), 문서 누락 감지 |
pre-compact.sh | 컨텍스트 압축 | 세션 진행 노트 보존 |
session-stop.sh | 세션 종료 | 성과 로깅 |
log-agent.sh | 에이전트 스폰 | 모든 서브에이전트 호출 감사 추적 |
경로 기반 코딩 표준
| 경로 | 적용 규칙 |
|---|---|
src/gameplay/** | 데이터 기반 값, delta time 사용, UI 참조 금지 |
src/core/** | 핫 패스 제로 할당, 스레드 안전, API 안정성 |
src/ai/** | 성능 예산, 디버깅 가능, 데이터 기반 파라미터 |
src/networking/** | 서버 권한, 버전 메시지, 보안 |
src/ui/** | 게임 상태 소유 금지, 로컬라이제이션 준비, 접근성 |
design/gdd/** | 필수 8 섹션, 포뮬라 포맷, 엣지 케이스 |
tests/** | 테스트 네이밍, 커버리지, 픽스처 패턴 |
prototypes/** | 완화된 표준, README 필수, 가설 문서화 |
설계 철학
전문 게임 개발 실무에 기반:
- MDA Framework — Mechanics, Dynamics, Aesthetics 분석
- Self-Determination Theory — 자율성, 역량, 관계성 (플레이어 동기)
- Flow State Design — 도전-스킬 밸런스
- Bartle Player Types — 타겟 오디언스 분석
- Verification-Driven Development — 테스트 우선, 그 다음 구현
시작하기
# 클론 또는 템플릿 사용
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
# Claude Code 세션 시작
claude
# /start 실행 — 프로젝트 상태를 물어보고 적절한 워크플로우 안내
/start
또는 바로 특정 스킬로:
/brainstorm # 게임 아이디어 탐색
/setup-engine godot 4.6 # 엔진 설정
/project-stage-detect # 기존 프로젝트 분석
마치며: 구조가 있는 AI 게임 개발
Claude Code Game Studios는 AI에게 자율성을 주는 게 아니라, AI에게 구조를 입히는 것이다.
여전히 모든 결정은 당신이 한다. 하지만 이제:
- 올바른 질문을 하는 팀
- 초기에 실수를 잡는 QA
- 첫 브레인스톰부터 런치까지 프로젝트를 정리해주는 시스템
혼자 개발해도, 혼자가 아니다.
🔗 관련 정보
- GitHub: https://github.com/Donchitos/Claude-Code-Game-Studios
- License: MIT
- 지원 플랫폼: Windows, macOS, Linux