Claude Code Game Studios: 에이전트 49개 템플릿

Claude Code Game Studios 에이전트 조직도 위에 제목

클로드 코드 창 하나에 게임 회사 하나를 통째로 넣겠다는 저장소가 있어요. 이름은 Claude Code Game Studios. 디렉터 3명 아래로 부서장과 전문가까지, 에이전트(AI 일꾼)만 49개입니다. 오늘 하루에만 깃허브 별이 1,300개 넘게 붙었고, 누적은 3.1만 개예요.

이름만 보면 게임을 뚝딱 만들어 줄 것 같죠. 그런데 받아서 열어 보니 게임 코드는 한 줄도 없습니다. 이게 뭔지, 어떻게 시작하는지, 어디서 시간을 버리기 쉬운지 저장소 문서를 읽고 정리했어요. 클로드 코드로 게임 개발을 해 보고 싶은 분이라면 시작 전에 봐 둘 내용입니다.

Claude-Code-Game-Studios 깃허브 저장소 첫 화면, 별 31.1k 포크 4.3k
별 3.1만 · 포크 4.3천 · 출처: Claude-Code-Game-Studios 깃허브

Claude Code Game Studios가 뭐길래

한 줄로 말하면 게임 프로젝트용 뼈대예요. 프로그램을 설치하는 게 아니라 이 저장소를 복제해서 내 게임 프로젝트의 시작점으로 씁니다. 그 안의 .claude 폴더에 에이전트, 스킬(슬래시 명령), 훅(자동 검사), 규칙 파일이 미리 들어 있어요. MIT 라이선스라 무료로 쓰고 고칠 수 있습니다. 다만 클로드 코드 자체는 따로 필요해요.

README는 이유를 이렇게 설명합니다. 혼자 AI로 게임을 만들면 빠르긴 한데 대화창에는 체계가 없다는 거예요. 숫자를 코드에 박아 넣어도, 설계 문서를 건너뛰어도 말리는 사람이 없다는 얘기죠. 그래서 역할을 나눈 팀 구조를 씌웠다고 합니다.

에이전트 49, 스킬 74, 훅 15, 규칙 14, 템플릿 62가 적힌 README 표
README의 구성표 · 출처: Claude-Code-Game-Studios 깃허브

에이전트 49개는 어떻게 나뉘어 있나

회사 조직도 모양 그대로예요. 맨 위에 크리에이티브 디렉터, 테크니컬 디렉터, 프로듀서 3명. 그 아래 부서장 8명, 다시 그 아래 프로그래머·레벨 디자이너·사운드 디자이너 같은 전문가 23명입니다. 여기에 엔진 전문가 15명을 더해 49명이 돼요. 일은 위에서 아래로 내려보내고, 부서끼리 의견이 갈리면 공통 상급자에게 올려 결정합니다.

디렉터, 부서장, 전문가 3단계로 나뉜 에이전트 조직도
3단 조직도 · 출처: Claude-Code-Game-Studios 깃허브

에이전트 하나는 마크다운 문서 한 장이에요. 예를 들어 크리에이티브 디렉터 파일에는 쓸 모델, 쓸 수 있는 도구, 명령 실행(Bash) 금지가 적혀 있고, 본문에는 “최종 결정은 사용자가 한다”는 규칙이 나옵니다. 프로그램이라기보다 직무 기술서 묶음에 가까워요.

creative-director 에이전트 파일, 모델 opus, Bash 사용 금지
에이전트 하나는 문서 한 장 · 출처: creative-director.md

엔진은 고도(Godot) 4, 유니티, 언리얼 엔진 5 세 가지입니다. 엔진마다 대표 에이전트와 세부 전문가가 따로 있어서, 내 프로젝트에 맞는 세트만 쓰면 돼요.

고도 4, 유니티, 언리얼 엔진 5별 전문 에이전트 표
엔진별 에이전트 · 출처: Claude-Code-Game-Studios 깃허브

직접 받아서 세어 봤어요

저장소 소개 문구에는 스킬이 72개, README에는 74개로 적혀 있어서 라즈베리파이에 저장소를 받아 파일을 세어 봤습니다. 안에 든 스크립트는 돌리지 않았고 ls와 grep으로 세기만 했어요. 실제 스킬 폴더는 README대로 74개였습니다.

라즈베리파이 터미널에서 에이전트 49, 스킬 74, 훅 파일 18개를 센 결과
라즈베리파이에서 센 결과 · 출처: 부컴 직접 실행

훅 폴더에는 파일이 18개인데 README 숫자는 15개예요. 설정 파일에 훅으로 등록된 것도 15개였고, 폴더에는 yaml-helper.sh나 update-check.sh 같은 보조 스크립트가 섞여 있습니다. 숫자가 틀린 건 아니에요.

모델 줄도 눈여겨볼 만합니다. 디렉터 3명만 Opus, 16명은 Sonnet, 나머지 30명은 내가 지금 쓰는 모델을 그대로 따라가요. src 폴더에는 .gitkeep과 안내 문서뿐이고요. README도 예시 게임은 일부러 넣지 않았다고 밝힙니다.

시작하는 법: 클로드 코드 게임 개발 세 단계

필요한 건 Git, 클로드 코드, Python 3, Bash입니다. jq는 있으면 좋은 정도예요. Python 3가 없으면 설정이 조용히 기본값으로 돌아간다고 하니 먼저 확인해 두세요. 윈도우는 Git for Windows를 깔면 Bash가 같이 들어옵니다.

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
claude

클로드 코드가 열리면 /start를 입력합니다. 아이디어가 없는지, 대강 구상이 있는지, 설계가 끝났는지, 만들던 게 있는지 물어보고 거기에 맞는 경로로 안내해 준다고 해요. 엔진이 정해져 있으면 /setup-engine godot 4.7처럼 바로 지정할 수도 있습니다.

git clone, claude 실행, /start 입력으로 이어지는 설치 안내
시작 세 단계 · 출처: Claude-Code-Game-Studios 깃허브

여기서 하나만 기억해 두세요. 반드시 프로젝트 맨 위 폴더에서 claude를 실행해야 합니다. src 같은 하위 폴더에서 시작하면 훅, 금지 규칙, 먼저 묻는 권한 모드가 전부 빠진다고 README에 적혀 있어요.

문서만 쌓이는 건 아닐까?

이런 템플릿을 보면 저는 이 걱정부터 듭니다. 게임은 안 나오고 기획서만 늘어나는 거요. 재밌게도 README가 같은 질문을 직접 다뤄요. 제목부터 “게임을 만드나, 문서를 만드나”입니다.

개발자가 같은 기획으로 게임 4개를 절차 수준만 바꿔 만들어 본 결과를 공개했는데, 표에는 두 줄이 나와 있어요.

modes.rigor게임 코드 전에 쓴 문서시간
minimal1개 (한 쪽짜리 기획)0분
standard30개58분

전부 돌아가는 게임이 나왔지만, 블라인드 평가자 2명과 사람의 플레이 테스트에서 standard 쪽이 꼴찌였다고 해요. 문서 29개가 추적하기는 좋게 해 줘도 더 나은 게임을 만들어 주진 않았다는 결론입니다. 그래서 기본값도 가장 가벼운 minimal이에요. 다만 개발자 본인의 측정이고 그 게임들은 저장소에 없어서, 제3자가 확인한 수치는 아닙니다.

게임 코드 전 문서 수를 minimal 1개, standard 30개로 비교한 README 표
개발자가 공개한 측정 · 출처: Claude-Code-Game-Studios 깃허브

설정 이름은 modes.rigor이고 단계는 셋입니다. minimal은 게임잼 속도, standard는 설계 문서 필수 항목 5개, full은 8개 전부에 디렉터 검토까지 붙어요. 전투 시스템처럼 한 부분만 엄격하게 올리는 설정도 따로 있습니다.

modes.rigor 의 minimal, standard, full 설명
기본값은 minimal · 출처: Claude-Code-Game-Studios 깃허브

minimal 기본 흐름은 /start → /setup-engine → /brainstorm → /create-stories → /dev-story ↔ /story-done이에요. 슬래시 명령이 74개나 되지만 처음부터 다 외울 필요는 없습니다.

분야별로 나뉜 슬래시 명령 목록
분야별 슬래시 명령 · 출처: Claude-Code-Game-Studios 깃허브

화면에 보이는 걸 바꾼 작업은 게임을 실제로 띄워 스크린샷을 남겨야 끝난 걸로 칩니다. minimal에서도 이 절차는 빠지지 않아요. 테스트만 통과하고 메뉴가 화면 밖에 그려지는 사고를 막으려는 거죠.

쓰기 전에 확인할 것

훅은 커밋과 푸시, 파일 쓰기 때 자동으로 돌아갑니다. 코드에 박힌 값이나 JSON 오류를 잡고, 보호된 브랜치로 푸시할 때 경고해 줘요. 다만 validate-write.sh처럼 막지 않고 경고만 하는 것도 있으니 안전장치로 다 믿으면 안 됩니다.

validate-commit 등 훅 이름과 동작을 적은 표
자동 검사 훅 · 출처: Claude-Code-Game-Studios 깃허브

권한 설정에는 rm -rf 계열과 강제 푸시, git reset --hard 같은 명령이 금지 목록으로 들어 있어요. 일을 시키는 AI에게 지우는 권한을 먼저 막아 둔 건 마음에 듭니다.

settings.json 의 allow 목록과 rm -rf 를 막는 deny 목록
권한 설정 일부 · 출처: settings.json
  • 토큰 사용량: 에이전트가 많은 만큼 사용량이 늘 수 있어요. 저장소 문서도 스킬 74개 목록이 작지 않다고 밝히고 줄이는 설정을 안내합니다. 실제 소모량은 저장소에서 확인하지 못했어요.
  • 자동 조종이 아님: 기본 상태에서는 묻고, 선택지를 보여 주고, 승인을 받은 뒤에야 파일을 씁니다. 맡겨 두고 자러 가는 도구는 아니에요.
  • 업데이트 확인: 하루 한 번까지 깃허브에 최신 버전을 물어봅니다. 프로젝트 내용은 보내지 않는다고 하고, /settings --local updates.check=false로 끌 수 있어요.
  • 맥·리눅스 알림: 알림 훅은 윈도우 전용입니다. 나머지 훅은 맥과 리눅스에서도 시험했다고 해요.
  • 만들던 게임에 적용: 처음부터 쓰는 템플릿이지만 기존 프로젝트용 /adopt, /project-stage-detect도 있습니다. 먼저 브랜치를 나눠서 시도하는 게 안전해요.

최신 버전은 2026년 10월 19일에 나온 1.2.0입니다. 큰 설계 문서를 통째로 읽지 못하게 막는 훅이 들어갔고, 엔진 참고 자료는 고도 4.7과 언리얼 엔진 5.8로 올라갔어요. 첫 커밋이 올해 2월이니 아직 젊은 프로젝트입니다.

릴리스 v1.2.0 페이지의 주요 변경점
v1.2.0 릴리스 · 출처: 저장소 릴리스 페이지

그래서 써 볼 만한가요?

제 생각엔 처음 게임을 만드는 분보다, 작은 게임을 끝까지 못 내고 자꾸 멈췄던 분에게 맞을 것 같아요. 범위 점검이나 출시 체크리스트 같은 명령은 혼자 일할 때 빠뜨리기 쉬운 것들이니까요. 반대로 주말에 가볍게 만들어 볼 생각이면 에이전트 49개는 과할 수 있습니다. 그럴 땐 카파시 스킬처럼 작은 지침 하나로 시작해도 충분해요.

비슷한 구조가 궁금하면 superpowers나 ECC도 함께 비교해 보세요. 게임 전용 조직도까지 갖춘 쪽은 이번 템플릿입니다.

저는 이번엔 파일을 세고 문서를 읽기만 했고, /start는 돌려 보지 않았어요. 고도로 아주 작은 게임 하나를 minimal 설정으로 만들어 보고, 정말 문서 없이 끝까지 가는지 후기로 정리해 볼 생각입니다. 여러분이라면 AI 스튜디오에 어떤 게임부터 맡겨 보고 싶으세요?


출처
· Donchitos/Claude-Code-Game-Studios 깃허브 저장소·README
· 릴리스 페이지(v1.2.0)
· CHANGELOG
· setup-requirements 문서
· settings.json
(2026년 11월 1일 확인)

컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.

함께 보면 좋은 글

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다