TL;DR

이 레포는 단일 Claude Code 세션을 49개 전문 에이전트와 73개 슬래시 스킬로 조직화하여 게임 개발 전 과정을 구조화하는 템플릿이다. 에이전트 계층은 디렉터·리드·스페셜리스트로 역할을 분리하고 수직 위임과 수평 상담 규칙으로 변경 전파와 갈등 해결을 관리하며 훅과 경로 기반 규칙이 파일 수준에서 자동 검증을 수행한다. 초기 설치는 레포 복제 후 `claude` 실행과 `/start` 호출로 간단히 시작되며 엔진별 에이전트 세트와 문서 템플릿이 포함되어 있어 프로토타입부터 릴리스까지 일관된 워크플로와 품질 게이트를 제공한다. 트레이드오프로는 Claude Code 생태계와 훅의 플랫폼별 구현 상태에 의존하므로 플랫폼 제약이나 알림 기능의 일부가 아직 플랫폼별로 제한될 수 있다.

주요 기능

• 에이전트 팀을 조직화해 역할별 책임과 에스컬레이션 경로를 제공하며 스튜디오 계층 모델로 디렉터·리드·스페셜리스트 간 위임과 교차 상담을 구조화한다. 이 구조는 변경 전파와 품질 게이트를 명확히 하여 설계 일관성을 유지한다. 사용자는 에이전트가 제안한 옵션을 검토한 뒤 최종 결정을 내리는 방식으로 통제권을 유지한다.
• 워크플로 자동화를 위해 73개의 슬래시 명령을 제공하며 온보딩·설계·아트·QA·릴리스 등 단계별 작업을 바로 실행할 수 있게 한다. 각 슬래시 명령은 특정 산출물이나 검증 단계로 연결되며 반복 작업을 단축한다. 명령 호출은 Claude Code 내에서 즉시 실행되어 세션 흐름을 전환한다.
• 파일 변경과 커밋·푸시·세션 라이프사이클에 연결된 12개의 훅으로 자동 검증과 감사 기록을 수행하며 경로 기반 규칙으로 코드·디자인·테스트 기준을 적용한다. 훅은 관련 없는 호출에서는 즉시 종료(exit 0)되도록 설계되어 성능 부담을 최소화한다. 권한 규칙은 위험한 작업을 차단하고 안전한 기본 작업은 허용한다.
• 프로젝트 템플릿과 문서 템플릿 41개를 통해 GDD·ADR·스프린트 플랜·접근성 가이드 등 표준 산출물을 자동으로 생성하고 일관된 문서 구조를 유지한다. 템플릿은 엔진별( Godot, Unity, Unreal ) 에이전트 세트와 연동되어 엔진 특화 요구사항을 반영한다. 템플릿 기반 생성은 초기 설계와 검토 사이클을 가속한다.

어떻게 동작하는가

에이전트들은 수직 위임(vertical delegation)과 수평 상담(horizontal consultation) 규칙을 따라 역할을 분리하고, 갈등 발생 시 상위 권한으로 에스컬레이션하는 방식으로 협업을 구조화한다. 각 에이전트는 질문 단계에서 요구사항을 확인하고 2~4개의 대안과 장단점을 제시한 뒤 사용자가 최종 결정을 내리도록 워크플로를 설계한다. 훅과 경로 기반 규칙이 파일 수준에서 자동 검증을 수행하여 코드 품질과 설계 준수를 강제한다.

해결 문제

단일 대화형 세션에서 발생하는 구조 부재와 편향된 출력, 무검증 산출물 문제를 해소하기 위해 스튜디오 수준의 역할 분담과 검증 파이프라인을 제공한다. 이 템플릿은 전문화된 49개 에이전트와 73개 스킬을 통해 디자인·개발·아트·QA·릴리스 등 단계별 책임과 품질 게이트를 명확히 하여 무계획적 구현과 스파게티 코드 생성을 줄인다. 결과적으로 프로젝트 초기부터 출시까지의 일관성·검증·문서화 과정을 체계화한다.

차별점

• 에이전트 수와 역할 세분화에서 차별화되며 49개 에이전트로 실제 스튜디오 조직을 모사하여 역할별 책임과 검토 절차를 코드화했다.
• 경로 기반 규칙과 훅을 결합해 파일 위치에 따라 서로 다른 코딩·디자인·테스트 규범을 자동으로 적용함으로써 엔진·서브시스템별 품질 요구사항을 강제한다.
• 엔진별 에이전트 세트(Godot, Unity, Unreal)를 제공하여 각 엔진 특유의 워크플로와 기술 스택을 반영한 도메인 특화 지원을 제공한다.

사용 사례

• 인디 개발자가 Claude Code를 활용해 게임 프로토타입을 기획·구현·검증하는 워크플로를 즉시 시작할 때 사용하는 템플릿으로, 에이전트들이 기획서·에픽·스프린트·테스트를 단계별로 생성·검증하여 개발 속도를 높인다. 템플릿은 엔진 선택과 리뷰 강도 조절 옵션을 제공하므로 다양한 개발 규모에 적용 가능하다. 결과적으로 단독 개발자가 구조적 검토를 도입할 수 있게 한다.
• 소규모 스튜디오가 초기 기획 단계에서 디자인 일관성과 코드 품질을 확보하려고 할 때 프로젝트 구조·규칙·템플릿을 표준으로 도입하여 협업 비용을 낮춘다. 훅과 경로 규칙이 자동으로 규약을 적용하므로 인간 리뷰 부담을 줄일 수 있다. 에스컬레이션 체계가 오해를 줄여 의사결정 품질을 향상시킨다.
• 교육용 또는 실습용 환경에서 게임 개발의 전체 파이프라인(기획→아트→코드→QA→릴리스)을 재현하려는 목적에 적합하며, 에이전트를 통해 각 단계의 산출물과 검토 기준을 체계적으로 연습할 수 있다. 템플릿이 제공하는 문서 템플릿과 검증 훅이 학습 커리큘럼을 구조화하는 데 기여한다. 실습 결과는 자동 로그와 감사 트레일로 추적 가능하다.

시작하기

레포를 로컬로 복제한 뒤 Claude Code 세션을 열어 바로 워크플로를 시작할 수 있으며 초기 구성은 `git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game`와 `cd my-game`로 이루어진다. 그 다음 `claude` 명령으로 세션을 시작하고 `/start` 명령을 실행하면 프로젝트 상태 감지 및 적절한 워크플로 모드가 설정된다. 권장 부가 도구(jq, Python)는 훅 검증과 JSON 유효성 검사를 돕도록 권장되며 부재 시 훅은 안전하게 비활성화되어 작업 흐름에 문제가 생기지 않는다.

요구사항

• Git (코드 복제 및 버전 관리)
• Claude Code CLI (`npm install -g @anthropic-ai/claude-code`) 또는 호환 세션
• 권장: jq 및 Python 3 (훅과 JSON 검증을 위한 선택적 도구)