← 블로그로
Ai약 12 분 읽기

에이전트 49명, 게임 하나

게시일 2026년 11월 9일
에이전트 49명, 게임 하나

Claude Code Game Studios는 Claude Code 세션 하나를 49명짜리 게임 스튜디오로 바꾸는 GitHub 템플릿이다. 별 3만 6824개, MIT 라이선스, 에이전트 49개, 슬래시 명령 스킬 74개, 훅 15개, 경로 범위 규칙 14개, 문서 템플릿 62개.

그 문단이 공유되는 버전이다. 읽을 가치가 있는 버전은 README 네 줄 아래, '게임을 만드나, 문서를 만드나'라는 절에 있다.

저자는 같은 브리프로 프로세스 설정을 달리해 네 개의 게임을 만들고, 첫 게임 코드 한 줄이 나오기 전까지 각각 문서를 몇 장 썼는지 세었다.

minimal에서는 그 숫자가 하나, 한 장짜리 브리프였고 시간은 0분이었다. standard에서는 문서 30장에 58분이었다. 네 빌드 모두 실행되고 테스트된 게임을 내놨다.

그다음 블라인드 평가자 두 명과 사람 플레이테스트가 standard 빌드를 최하위로 매겼다.

문서 30장을 더 쓴 대가는 추적 가능성이었다. 더 나은 게임은 아니었다. 전체 가치 제안이 프로세스인 프로젝트가 자기 README에 그 결과를 공개하는 것은 예상하지 못한 수준의 정직이고, 이 글이 존재하는 이유다.

상자 안에 실제로 든 것

구조는 실제 스튜디오 조직도이고, 나머지 모든 설계 결정이 거기서 따라온다.

1층은 디렉터다. 크리에이티브 디렉터, 테크니컬 디렉터, 프로듀서. 2층은 부서 리드다. 게임 디자인, 프로그래밍, 아트, 오디오, 내러티브, QA, 릴리스, 현지화. 3층은 스무 명 남짓의 전문가다. 게임플레이 프로그래머, 엔진 프로그래머, AI 프로그래머, 네트워크 프로그래머, 툴 프로그래머, UI 프로그래머, 시스템 디자이너, 레벨 디자이너, 경제 디자이너, 테크니컬 아티스트, 사운드 디자이너, 라이터, 월드 빌더, UX 디자이너, 프로토타이퍼, 퍼포먼스 분석가, 데브옵스 엔지니어, 애널리틱스 엔지니어, 보안 엔지니어, QA 테스터, 접근성 전문가, 라이브옵스 디자이너.

각자 정해진 책임과 에스컬레이션 경로, 품질 게이트가 있다. README의 표현대로 결정은 여전히 당신이 내리지만, 이제 스튜디오가 물을 법한 질문을 누군가 던진다. 비전에 맞는가, 이 숫자는 매직 상수인가, 이 시스템의 설계 문서는 어디 있는가.

스킬은 워크플로다. /start, /brainstorm, /setup-engine godot 4.7, /project-stage-detect, /design-system, /create-epics, /create-stories, /dev-story, /story-done. 훅은 커밋, 푸시, 에셋 변경, 설계 문서 읽기, 세션 수명주기에 발동하는 검증이다. 규칙은 게임플레이 코드를 편집할 때와 네트워크 코드, 씬 파일을 편집할 때 각각 적용되는 경로 단위 코딩 표준이다.

A long meeting table surrounded by empty chairs, one document at the head

설치는 1분쯤 걸린다

준비물은 Git, Claude Code, Python 3, Bash, 그리고 훅 검증을 원하면 jq다. 윈도에서는 Bash가 Git for Windows에 포함돼 있다.

그다음은 이렇다.

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

CLAUDE.md와 project.yaml이 있는 폴더에서 세션을 시작하라. src/에서 시작하면 프로젝트의 훅, 거부 규칙, 먼저 묻는 권한 모드가 건너뛰어지고, 시스템 대부분이 조용히 꺼진다.

그다음 /start를 실행한다. 지금 어디에 있는지 묻는다. 감도 안 잡힘, 막연한 콘셉트, 명확한 설계, 기존 작업. 그리고 경로를 잡아준다. 원하는 것이 이미 분명하면 /brainstorm이나 /setup-engine godot 4.7로 바로 가면 된다.

중요한 설정 결정은 modes.rigor 하나다. minimal, standard, full. 여섯 개의 별도 손잡이 앞에 놓인 스위치 하나다. 어떤 GDD 절이 필수인지, 문서 밀도, QA 수준, 스토리 세분화, 리뷰 모드. /start가 알아서 써준다.

정말 잘 설계됐다고 느낀 부분

두 가지 메커니즘이 눈에 띈다.

Python이 구조를 떠받치고, README도 그걸 인정한다. 모든 스킬과 훅이 Python으로 project.yaml을 읽는다. Python이 없으면 모든 설정이 조용히 기본값으로 돌아간다. 훅은 그 밖에는 얌전히 실패하고, 검증을 잃을 뿐 아무것도 깨지지 않는다. 딱 하나 하드 스톱이 있다. 데이터 JSON을 스테이징한 커밋은 검증할 Python이 없으면 차단된다. 이상하고 구체적이고 믿을 만한 디테일이다. 1년쯤 실제로 쓰인 시스템의 모습이다.

시각적 변화는 누군가 눈으로 보기 전엔 끝나지 않는다. 플레이어가 보는 것을 바꾸는 스토리는 게임을 실행하고, 관찰하고, 스크린샷을 production/qa/evidence/에 저장하기 전까지 닫을 수 없다. 테스트 통과는 실행이 아니다. 파스 체크도 실행이 아니다. 이 규칙은 모든 리거 수준에 적용되고, 자동 테스트를 면제하는 minimal에서도 겉모습은 면제되지 않는다.

이 규칙 하나가 문서 40장보다 결과물 품질에 더 기여한다. 게임은 테스트가 볼 수 없는 방식으로 시각적으로 실패한다. 화면 밖에 그려진 메뉴, 피벗이 틀린 스프라이트, 두 번째 턴에 바닥을 뚫는 카메라. 스크린샷을 요구하는 것은 가장 흔한 실패 유형에 대한 가장 싼 방어이고, 희망이 아니라 훅으로 강제된다.

템플릿 62개의 용도

게임 디자인 문서, UX 스펙, 아키텍처 결정 기록, 스프린트 계획, HUD 설계, 접근성 리뷰. 그것만 놓고 보면 아무도 쓰고 싶지 않은 서류 작업이다. 이런 시스템 안에서는 에이전트가 행동하기 전에 읽는 것이 된다.

그게 실제 기능이다. 여기서 문서는 납품물이 아니라, 전문가 에이전트가 전투 시스템의 데미지 곡선을 몰라서 매직 넘버를 지어내지 않게 막는 맥락이다. 아트 디렉터 에이전트가 게임이 스타일라이즈드인지 포토리얼인지 알아야 할 때 누군가 채워 넣은 아트 바이블 템플릿을 읽는다. 그 파일이 없으면 추측한다.

그러면 앞의 측정이 다시 읽힌다. 첫 코드 전에 문서 30장은 문서 30장의 가치가 아니다. 그 문서가 나중 작업에서 에이전트에게 반복해서 읽힐 것이라는 베팅이다. 베팅이 맞으면 일관성이 생긴다. 틀리면 58분의 집필과 블라인드 평가 최하위 빌드가 남는다.

내 판단으로는 보상이 프로젝트가 일주일을 넘기느냐에 전적으로 달려 있다. 주말 프로젝트라면 한 장 써라. 석 달짜리라면 서른 장을 써라.

아무도 말하지 않는 업그레이드 경로

템플릿을 클론하는 건 쉽다. 두 달 동안 커스터마이즈한 저장소에 업스트림 변경을 당겨오는 게 아픈 부분이다. 에이전트는 편집되고, 규칙은 당신의 엔진에 맞춰 조정되고, 다음 릴리스는 디렉터리를 재편한다.

README에는 업그레이드 절이 있는데, 대부분 템플릿이 주지 않는 것이다. 중요한 조언은 자기 변경을 규칙 파일과 project.yaml처럼 예측 가능한 몇 군데에만 두라는 것이다. 그러면 나머지는 통째로 교체할 수 있다. 에이전트 자체를 포크하면 업데이트를 받을 수 없고, 프로젝트가 빠르게 움직이는 만큼 한두 릴리스 안에 문제가 된다.

이 패턴이 향하는 곳

게임 특유의 어휘를 벗기면 남는 것은 일반적인 레시피다. 역할을 정의하고, 각 역할에 좁은 권한을 주고, 단계 사이에 게이트를 두고, 디렉터 에이전트가 비전을 들고 전문가들이 실행하게 한다. 실제 엔지니어링 조직과 같은 모양이고, 여러 팀이 다른 영역에 지금 만들고 있는 것과 같은 모양이다. 영화 촬영팀, 마케팅 부서, 연구실.

정직한 단서는 저자가 이미 공개한 것이다. 프로세스가 많다고 결과가 좋아지지는 않는다. 적어도 이 규모, 브리프 하나와 빌드 네 개에서는 그렇다. 상관이 있는 것은 3주 뒤에 왜 그런 결정을 했는지 설명할 수 있다는 점이다. 팀에는 값어치가 있고, 혼자 하는 게임잼 출품에는 거의 없다.

써야 할까

혼자 게임을 만들면서 계속 부딪히는 실패가 '시스템은 서른 개인데 일관된 비전이 없다'라면 standard에서 시작해 그 질문들이 도움이 되는지 보라. 계속 부딪히는 실패가 '문서 쓰는 데 시간을 다 쓴다'라면 minimal에서 시작하라. 그리고 그 설정에서도 스토리를 끝냈다고 하기 전에 에이전트가 화면을 보게 만든다는 점을 기억하라.

이 템플릿이 게임을 대신 만들어주지는 않는다. 세션이 한 번이라도 출시해본 사람들로 가득한 방처럼 행동하게 만든다. 그게 58분의 값어치가 있는지는 이제 느낌이 아니라 측정으로 답할 수 있는 질문이다. 대부분의 AI 도구가 주지 못하는 것이다.

관련 글