Donchitos/Claude-Code-Game-Studios

단 한 번의 Claude Code 세션을 완전한 게임 개발 스튜디오로 전환하세요.

49개의 에이전트 (Agents). 73개의 기술 (Skills). 하나의 조율된 AI 팀.

AI와 함께 혼자 게임을 만드는 것은 강력하지만, 단일 채팅 세션에는 구조가 없습니다. 매직 넘버 (magic numbers)를 하드코딩하거나, 설계 문서 (design docs)를 건너뛰거나, 스파게티 코드 (spaghetti code)를 작성하는 것을 막아줄 사람이 없습니다. QA (Quality Assurance) 단계도, 디자인 리뷰 (design review)도, "이것이 실제로 게임의 비전에 부합하는가?"라고 질문할 사람도 없습니다.

Claude Code Game Studios는 AI 세션에 실제 스튜디오의 구조를 부여함으로써 이 문제를 해결합니다. 하나의 범용 어시스턴트 대신, 스튜디오 계층 구조로 조직된 49개의 전문화된 에이전트 (agents)를 제공합니다. 비전을 수호하는 디렉터 (directors), 각 도메인을 책임지는 부서장 (department leads), 그리고 실무를 수행하는 전문가 (specialists)가 그들입니다. 각 에이전트는 정의된 책임, 에스컬레이션 경로 (escalation paths), 그리고 품질 게이트 (quality gates)를 가집니다.

결과적으로: 당신은 여전히 모든 결정을 내리지만, 이제는 올바른 질문을 던지고, 실수를 조기에 발견하며, 첫 브레인스토밍부터 출시까지 프로젝트를 체계적으로 유지하는 팀을 갖게 됩니다.

• 포함 사항
• 스튜디오 계층 구조 (Studio Hierarchy)
• 슬래시 명령어 (Slash Commands)
• 시작하기
• 업그레이드
• 프로젝트 구조
• 작동 방식
• 디자인 철학
• 커스터마이징
• 플랫폼 지원
• 커뮤니티
• 프로젝트 지원하기
• 라이선스 (License)

카테고리	수	설명
에이전트 (Agents)	49	디자인, 프로그래밍, 아트, 오디오, 내러티브, QA, 프로덕션 전반에 걸친 전문 서브 에이전트 (subagents)
기술 (Skills)	73	모든 워크플로우 단계에 대한 슬래시 명령어 (Slash commands) (/start, /design-system, /create-epics, /create-stories, /dev-story, /story-done 등)
훅 (Hooks)	12	커밋 (commits), 푸시 (pushes), 에셋 변경 (asset changes), 세션 라이프사이클 (session lifecycle), 에이전트 감사 추적 (agent audit trail), 격차 탐지 (gap detection)에 대한 자동화된 검증
규칙 (Rules)	11	게임플레이, 엔진, AI, UI, 네트워크 코드 등을 편집할 때 적용되는 경로 범위 지정 코딩 표준 (Path-scoped coding standards)
템플릿 (Templates)	41	GDD (Game Design Document), UX 사양서, ADR (Architecture Decision Records), 스프린트 계획, HUD 디자인, 접근성 등을 위한 문서 템플릿

에이전트는 실제 스튜디오가 운영되는 방식에 맞춰 세 가지 티어 (tiers)로 구성됩니다:

Tier 1 — 디렉터 (Directors) (Opus)
크리에이티브 디렉터 (creative-director), 테크니컬 디렉터 (technical-director), 프로듀서 (producer)
Tier 2 — 부서장 (Department Leads) (Sonnet)
...

이 템플릿에는 세 가지 주요 엔진에 대한 에이전트 세트가 포함되어 있습니다. 프로젝트에 맞는 세트를 사용하세요:

엔진 (Engine)	리드 에이전트 (Lead Agent)	하위 전문가 (Sub-Specialists)
Godot 4	godot-specialist	GDScript, 셰이더 (Shaders), GDExtension
Unity	unity-specialist	DOTS/ECS, 셰이더/VFX (Shaders/VFX), 어드레서블 (Addressables), UI Toolkit
Unreal Engine 5	unreal-specialist	GAS, 블루프린트 (Blueprints), 복제 (Replication), UMG/CommonUI

Claude Code에서 /를 입력하면 73개의 모든 기술 (skills)에 접근할 수 있습니다:

온보딩 및 내비게이션 (Onboarding & Navigation)
/start

/help

/project-stage-detect

/setup-engine

/adopt

게임 디자인 (Game Design)
/brainstorm

/map-systems

/design-system

/quick-design

/review-all-gdds

/propagate-design-change

아트 및 에셋 (Art & Assets)
/art-bible

/asset-spec

/asset-audit

UX 및 인터페이스 디자인 (UX & Interface Design)
/ux-design

/ux-review

아키텍처 (Architecture)
/create-architecture

/architecture-decision

/architecture-review

/create-control-manifest

스토리 및 스프린트 (Stories & Sprints)
/create-epics

/create-stories

/dev-story

/sprint-plan

/sprint-status

/story-readiness

/story-done

/estimate

리뷰 및 분석 (Reviews & Analysis)
/design-review

/code-review

/balance-check

/content-audit

/scope-check

/perf-profile

/tech-debt

/gate-check

/consistency-check

/security-audit

QA 및 테스트 (QA & Testing)
/qa-plan

/smoke-check

/soak-test

/regression-suite

/test-setup

/test-helpers

/test-evidence-review

/test-flakiness

/skill-test

/skill-improve

프로덕션 (Production)
/milestone-review

/retrospective

/bug-report

/bug-triage

/reverse-document

/playtest-report

릴리스 (Release)
/release-checklist

/launch-checklist

/changelog

/patch-notes

/hotfix

/day-one-patch

크리에이티브 및 콘텐츠 (Creative & Content)
/prototype

/onboard

/localize

팀 오케스트레이션 (Team Orchestration) (단일 기능에 대해 여러 에이전트를 조정)
/team-combat

/team-narrative

/team-ui

/team-release

/team-polish

/team-audio

/team-level

/team-live-ops

/team-qa

• Git
• Claude Code (
  npm install -g @anthropic-ai/claude-code
  )
• 권장 사항 (Recommended): jq (훅 검증용) 및 Python 3 (JSON 검증용)

선택적 도구가 누락되더라도 모든 훅(hook)은 유연하게 실패 처리됩니다. 시스템이 중단되지는 않지만, 검증 기능만 사용할 수 없게 됩니다.

복제 또는 템플릿으로 사용하기 (Clone or use as template): git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game cd my-game

Claude Code 실행하기 (Open Claude Code) 및 세션 시작: claude

실행하기 (Run) — 시스템이 현재 상태(아이디어 없음, 모호한 개념, 명확한 설계, 기존 작업물)를 묻고 적절한 워크플로우(workflow)로 안내합니다. 어떠한 가정도 하지 않습니다. /start

또는 필요한 내용을 이미 알고 있다면 특정 기술(skill)로 직접 이동할 수 있습니다:

/brainstorm
— 처음부터 게임 아이디어 탐색

/setup-engine godot 4.6
— 엔진을 이미 알고 있는 경우 엔진 설정

/project-stage-detect
— 기존 프로젝트 분석

이미 이 템플릿의 이전 버전을 사용 중이신가요? 단계별 마이그레이션(migration) 지침, 버전 간 변경 사항 분석, 덮어써도 안전한 파일과 수동 병합(merge)이 필요한 파일에 대한 상세 정보는 UPGRADING.md를 참조하세요.

CLAUDE.md # 마스터 설정 (Master configuration)
.claude/
settings.json # 훅 (Hooks), 권한 (permissions), 안전 규칙 (safety rules)
...

에이전트(Agents)는 구조화된 위임 모델(delegation model)을 따릅니다:

수직적 위임 (Vertical delegation) — 디렉터(directors)가 리드(leads)에게 위임하고, 리드가 전문가(specialists)에게 위임합니다.
수평적 협의 (Horizontal consultation) — 동일 계층의 에이전트끼리 서로 협의할 수 있지만, 도메인을 넘나드는 구속력 있는 결정을 내릴 수는 없습니다.
갈등 해결 (Conflict resolution) — 의견 불일치는 공유 부모(shared parent)에게 에스컬레이션(escalate)됩니다. (설계의 경우 creative-director, 기술의 경우 technical-director)
변경 전파 (Change propagation) — 부서 간 변경 사항은 producer에 의해 조정됩니다.
도메인 경계 (Domain boundaries) — 에이전트는 명시적인 위임 없이는 자신의 도메인 외부의 파일을 수정하지 않습니다.

이것은 자동 조종 (auto-pilot) 시스템이 아닙니다. 모든 에이전트는 엄격한 협업 프로토콜(collaboration protocol)을 따릅니다:

질문 (Ask)— 에이전트는 해결책을 제안하기 전에 질문을 합니다
옵션 제시 (Present options)— 에이전트는 장단점과 함께 2~4개의 옵션을 보여줍니다
사용자 결정 (You decide)— 최종 결정은 항상 사용자가 내립니다
초안 작성 (Draft)— 에이전트는 작업을 마무리하기 전에 초안을 보여줍니다
승인 (Approve)— 사용자의 승인 없이는 아무것도 작성되지 않습니다

사용자가 통제권을 유지합니다. 에이전트는 자율성 (autonomy)이 아닌 구조와 전문 지식을 제공합니다.

**훅 (Hooks)**은 모든 세션에서 자동으로 실행됩니다:

훅 (Hook)	트리거 (Trigger)	기능
validate-commit.sh	PreToolUse (Bash)	하드코딩된 값, TODO 형식, JSON 유효성, 설계 문서 (design doc) 섹션을 확인합니다 — 명령어가 git commit이 아니면 조기에 종료됩니다
validate-push.sh	PreToolUse (Bash)	보호된 브랜치 (protected branches)로의 푸시(push) 시 경고를 보냅니다 — 명령어가 git push가 아니면 조기에 종료됩니다
validate-assets.sh	PostToolUse (Write/Edit)	명명 규칙 (naming conventions) 및 JSON 구조를 검증합니다 — 파일이 assets/에 있지 않으면 조기에 종료됩니다
session-start.sh	세션 오픈 (Session open)	방향 설정을 위해 현재 브랜치와 최근 커밋 (commits)을 보여줍니다
detect-gaps.sh	세션 오픈 (Session open)	신규 프로젝트를 감지하여 (/start 제안)하고, 코드나 프로토타입이 존재할 때 누락된 설계 문서 (design docs)를 감지합니다
pre-compact.sh	압축 전 (Before compaction)	세션 진행 노트 (session progress notes)를 보존합니다
post-compact.sh	압축 후 (After compaction)	Claude에게 active.md로부터 세션 상태 (session state)를 복구하도록 상기시킵니다
notify.sh	알림 이벤트 (Notification event)	PowerShell을 통해 Windows 토스트 알림 (toast notification)을 표시합니다
session-stop.sh	세션 종료 (Session close)	active.md를 세션 로그로 아카이브하고 git 활동을 기록합니다
log-agent.sh	에이전트 생성 (Agent spawned)	감사 추적 (Audit trail) 시작 — 하위 에이전트 (subagent) 호출을 기록합니다
log-agent-stop.sh	에이전트 중지 (Agent stops)	감사 추적 (Audit trail) 종료 — 하위 에이전트 기록을 완료합니다
validate-skill-change.sh	PostToolUse (Write/Edit)	.claude/skills/ 변경 후 /skill-test 실행을 권장합니다

참고: validate-commit.sh, validate-assets.sh, 그리고 validate-skill-change.sh

모든 Bash/Write 도구 호출 시 실행되며, 명령어나 파일 경로가 관련이 없는 경우 즉시 종료(exit 0)합니다. 이는 정상적인 훅 (hook) 동작이며, 성능 문제는 아닙니다.

settings.json의 권한 규칙 (Permission rules)

안전한 작업(git status, 테스트 실행)은 자동으로 허용하고, 위험한 작업(force push, rm -rf, .env 파일 읽기)은 차단합니다.

코딩 표준 (Coding standards)은 파일 위치에 따라 자동으로 적용됩니다:

경로	적용 사항
src/gameplay/**	데이터 기반 값 (Data-driven values), 델타 타임 (delta time) 사용, UI 참조 금지
src/core/**	핫 패스 (hot paths) 내 할당 제로 (Zero allocations), 스레드 안전성 (thread safety), API 안정성
src/ai/**	성능 예산 (Performance budgets), 디버깅 가능성 (debuggability), 데이터 기반 파라미터
src/networking/**	서버 권한 방식 (Server-authoritative), 버전 관리된 메시지, 보안
src/ui/**	게임 상태 소유 금지, 현지화 준비 (localization-ready), 접근성
design/gdd/**	필수 8개 섹션, 공식 형식, 예외 케이스 (edge cases)
tests/**	테스트 명명 규칙, 커버리지 요구사항, 픽스처 패턴 (fixture patterns)
prototypes/**	완화된 표준, README 필수, 가설 문서화

이 템플릿은 전문적인 게임 개발 관행에 기반을 두고 있습니다:

MDA 프레임워크 (MDA Framework)— 게임 디자인을 위한 메카닉스 (Mechanics), 다이내믹스 (Dynamics), 에스테틱스 (Aesthetics) 분석
자기 결정 이론 (Self-Determination Theory)— 플레이어 동기 부여를 위한 자율성 (Autonomy), 유능성 (Competence), 관계성 (Relatedness)
몰입 상태 설계 (Flow State Design)— 플레이어 참여를 위한 도전과 기술의 균형
바틀 플레이어 유형 (Bartle Player Types)— 타겟 관객 설정 및 검증
검증 주도 개발 (Verification-Driven Development)— 테스트 우선, 그 다음 구현

이것은 **템플릿 (template)**이며, 고정된 프레임워크가 아닙니다. 모든 것은 맞춤 설정할 수 있도록 설계되었습니다:

에이전트 추가/제거 (Add/remove agents)— 필요 없는 에이전트 파일은 삭제하고, 사용자의 도메인에 맞는 새로운 에이전트를 추가하세요. 에이전트 프롬프트 편집 (Edit agent prompts)— 에이전트의 동작을 미세 조정하고, 프로젝트별 지식을 추가하세요. 스킬 수정 (Modify skills)— 팀의 프로세스에 맞게 워크플로우를 조정하세요. 규칙 추가 (Add rules)— 프로젝트의 디렉토리 구조를 위한 새로운 경로 범위 규칙 (path-scoped rules)을 생성하세요. 훅 튜닝 (Tune hooks)— 검증 엄격도를 조정하고 새로운 체크 항목을 추가하세요. 엔진 선택 (Pick your engine)— Godot, Unity 또는 Unreal 에이전트 세트를 사용하세요 (또는 사용하지 않을 수도 있습니다). 리뷰 강도 설정 (Set review intensity)— full (모든 디렉터 게이트 (director gates)), lean (단계별 게이트 (phase gates)만), 또는 solo (없음) 중 선택하세요. /start 명령 시 설정하거나 production/review-mode.txt를 편집하여 설정할 수 있습니다. 모든 스킬에 대해 --review solo를 사용하여 실행 시마다 재정의할 수 있습니다.

주요 개발 및 테스트는 Git Bash가 설치된 Windows 10 환경에서 진행되었습니다. 모든 훅 (hooks)은 POSIX 호환 패턴 (grep -P가 아닌 grep -E)을 사용하며, 도구가 누락된 경우를 대비한 폴백 (fallbacks)을 포함하고 있으므로 macOS 및 Linux에서도 실행되어야 합니다. notify.sh 훅은 Windows 토스트 알림을 위해 PowerShell을 사용하며, 그 외 환경에서는 아무 작업도 수행하지 않습니다(no-op). 즉, macOS/Linux에서의 데스크톱 알림은 아직 연결되지 않았습니다. 크로스 플랫폼 테스트가 진행 중이므로, 특정 플랫폼에서 발생하는 오류는 이슈 (issues)를 등록해 주세요.

토론 (Discussions)— 질문, 아이디어 공유 및 제작한 결과물 전시를 위한 GitHub Discussions
이슈 (Issues)— 버그 보고 및 기능 요청

Claude Code Game Studios는 무료이며 오픈 소스입니다. 이 프로젝트가 시간을 절약해 주거나 게임 출시를 도와주었다면, 지속적인 개발을 지원하는 것을 고려해 주세요:

Buy Me a Coffee— 일회성 후원
GitHub Sponsors— GitHub을 통한 정기 후원

후원금은 스킬 유지 관리, 새로운 에이전트 추가, Claude Code 및 엔진 API 변경 사항 추적, 그리고 커뮤니티 이슈 대응에 소요되는 시간을 지원하는 데 사용됩니다.

Claude Code를 위해 제작되었습니다. 유지 관리 및 확장 중 — GitHub Discussions를 통한 기여를 환영합니다.

MIT License. 자세한 내용은 LICENSE를 참조하세요.