Claude Code Game Studios: 기획·아트·QA 역할을 넣는 게임 개발 템플릿
Claude Code 프로젝트에 기획·프로그래밍·아트·QA 역할과 작업 규칙을 넣는 게임 개발 템플릿이에요. 완성 게임이나 자체 게임 엔진은 포함하지 않습니다.
주요 기능
- README 기준 49개 역할 에이전트·74개 스킬·15개 훅·14개 규칙·62개 문서 템플릿을 제공해요.
- Godot·Unity·Unreal 담당 역할과 기획→스토리→구현→검증→출시 절차를 구성해요.
- project.yaml의 rigor 수준으로 문서·검증 강도를 조절하며 화면 변경에는 실제 실행·관찰·스크린샷 증거를 요구하는 흐름을 설명해요.
구조
주로 .claude 아래 Markdown 에이전트·스킬·규칙, Bash 훅, Python 설정 처리와 project.yaml로 구성된 저장소 템플릿이에요. settings.json이 Claude Code의 권한·세션·도구 훅을 연결해요. 프레임워크 버전은 project.yaml 기준 1.2.0예요.
누구에게 쓸모 있나요
Claude Code로 게임을 만들면서 기획·구현·검토의 구조가 필요한 1인 또는 소규모 개발자. 엔진·코딩·테스트를 대체하는 완전 자율 제작 제품은 아니에요.
설치 전 준비
- Git·Claude Code·Python 3·Bash. Windows는 Git for Windows의 Bash 경로를 설명해요.
- jq는 검증용 권장 도구예요. 선택 도구가 없으면 일부 검증이 생략되고 Python 없는 데이터 JSON 커밋은 차단된다고 설명해요.
- 실제 게임 개발에는 선택한 엔진·SDK·빌드 도구와 AI 이용 권한이 별도로 필요해요.
- Windows 10 + Git Bash 중심 개발
- README상 macOS bash 3.2·BSD 도구 및 Linux 테스트
- Windows 알림 훅 외 macOS·Linux 데스크톱 알림은 미연결
설치 방법
프로젝트 템플릿 준비
새 폴더로 복제하거나 GitHub 템플릿을 사용해요. 기존 프로젝트에 덮어쓰지 말고 설정·훅을 검토해요.
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
claude사용 방법
- CLAUDE.md와 project.yaml이 있는 프로젝트 루트에서 Claude Code를 시작하고 /start를 실행해요.
- /setup-engine과 /brainstorm 등으로 엔진·범위를 정한 뒤 /create-stories → /dev-story → /story-done으로 진행해요.
- 작은 프로젝트는 기본 minimal부터 시작하고 성장에 따라 /settings에서 검증 수준을 조정해요.
- 실제 게임 테스트와 템플릿 자체의 /skill-test를 구분해요.
비용과 API 키
MIT 템플릿 자체는 무료예요. Claude 이용량·구독, 모델별 토큰, 엔진·에셋·배포 비용은 별도예요. 여러 역할 검토와 높은 rigor는 작업량을 늘릴 수 있어요.
라이선스
루트 LICENSE는 MIT예요. 게임 엔진·구입 에셋·생성 결과에 포함되는 제3자 자료의 라이선스까지 대신 허가하지는 않습니다.
주의사항과 알려진 이슈
- 기존 .claude 설정·훅·권한 규칙과 충돌할 수 있으므로 복사 전에 비교해야 해요.
- 프로젝트 하위 폴더에서 시작하면 루트의 훅·deny 규칙·기본 승인 모드를 놓칠 수 있다고 README가 경고해요.
- 일부 훅은 경고만 하거나 도구 부재 시 검증을 생략해요. 안전한 실행이나 게임 품질 보증으로 받아들이면 안 돼요.
- 역할별 Opus·Sonnet 지정 또는 세션 모델 상속이 있어 모델 비용이 균일하지 않습니다. README의 자체 게임 평가 수치는 독립 재현하지 않았어요.
확인 범위
확인 날짜: 2026-11-02
확인 커밋: 05ad7c8a5b8aa2aa86bbd3439ae7cf7295cac418
확인한 범위: 공식 GitHub main 커밋을 조회하고 해당 커밋에 고정된 README.md, LICENSE, project.yaml, .claude/settings.json를 정적으로 확인했어요. 공개 이슈 개별 재현·상태 전수 조사는 하지 않았어요.
확인 한계: 저장소 코드·의존성을 설치하거나 실행하지 않았어요. 계정 연결·모델 호출·과금·빌드·기기별 동작·성능·전체 보안 감사는 미검증이며 안내는 공식 문서 기준이에요.