← 블로그로
Ai약 11 분 읽기

agent 49 개, skill 74 개, 그리고 만들기 전에 묻는 스튜디오

게시일 2026년 11월 8일
agent 49 개, skill 74 개, 그리고 만들기 전에 묻는 스튜디오

이번 달 GitHub 위클리 차트에는 Claude Code 를 더 예쁜 인터페이스로 감싼 저장소가 많다. Donchitos/Claude-Code-Game-Studios 는 덜 유행하는 쪽을 택한다. 세션에 조직도를 준다. 이 저장소는 앱이 아니라 템플릿이다. clone 하고 루트에서 Claude Code 를 열면, 어시스턴트는 문서 정리 규칙과 누가 무엇을 결정할 수 있는지에 대한 규칙, 그리고 74 개의 슬래시 명령을 물려받는다. 일주일 만에 약 5,700 개의 스타를 얻었고 지금은 36,845 개다.

표제 숫자는 agent 49 개, skill 74 개, hook 15 개, 규칙 14 개, 문서 템플릿 62 개다. agent 수는 부풀리기 가장 쉬운 것이라서, 이 숫자가 가장 재미없는 부분이다. 읽을 만한 곳은 속이기 어려운 쪽이다. 에스컬레이션 경로를 가진 위임 모델, 그리고 subagent 가 지시대로 했는지 검사하는 hook.

세 개의 층, 각각의 이유

agent 49 개는 스튜디오가 짜인 방식대로 배치된다.

첫 층은 디렉터 세 명, creative-director, technical-director, producer 다. 둘째 층은 부서 리드로, game-designer, lead-programmer, art-director, audio-director, narrative-director, qa-lead, release-manager, localization-lead 다. 셋째 층은 서른 명 남짓의 전문가로, 게임플레이, 엔진, AI 와 네트워크 프로그래밍, 레벨과 경제 설계, 테크니컬 아트, 사운드 디자인, 글쓰기, 세계관, UX, 프로토타이핑, 퍼포먼스, DevOps, 분석, 보안, QA, 접근성, live ops, 커뮤니티를 맡는다.

서로 어떻게 말하는지에 대한 규칙은 README 에 적혀 있고, 대부분의 멀티 agent 구성보다 엄격하다.

수직 위임만 허용한다. 디렉터에서 리드로, 리드에서 전문가로. 수평 자문은 되지만, 같은 층의 agent 는 영역을 넘어 구속력 있는 결정을 내릴 수 없다. 의견이 갈리면 공통 상위로 에스컬레이션한다. 설계 논쟁은 creative-director, 기술 논쟁은 technical-director 가 맡는다. 부서를 넘는 변경은 producer 를 거친다. 그리고 명시적 위임 없이는 어떤 agent 도 자기 영역 밖의 파일을 고치지 않는다.

실전에서 중요한 건 마지막 규칙이다. 멀티 agent 의 실패는 추론의 실패가 아니라 범위의 실패인 경우가 많다. 조명 버그를 고치라고 부른 agent 가 눈에 거슬리는 걸 발견하고 세이브 시스템을 다시 쓴다. 영역 경계를 문서로 적고, 위임 절차를 밟아야 하는 리드가 집행하게 하는 것. 투박한 처방이지만 실제로 듣는다.

모델 등급은 예산의 문제

각 agent 는 frontmatter 에 모델을 선언한다. 디렉터 세 명은 Opus 를 요구한다. lead-programmer 와 전문가 열다섯 명은 Sonnet 을 지정한다. 나머지 서른 명은 당신 세션이 돌리는 모델을 물려받는다.

README 는 이 점을 드물게 직설적으로 말한다. 이 등급을 역할의 연차로 보라고, 요금제로 보지 말라고. 스튜디오 대부분이 이미 당신이 가진 모델 위에서 돌기 때문이다. agent 프레임워크의 비용 이야기로는 정직한 쪽에 속한다. 실제로 내는 돈은 세션 하나에, 이후 모든 것을 결정하는 판단에 쓰는 몇 번의 Opus 호출이다. 돈을 둘 만한 자리다.

hook 이 실제로 검사하는 것

hook 열다섯 개가 세션 이벤트에서 돈다. 이름을 짚을 만한 건 두 개다.

`log-agent.sh` 와 `log-agent-stop.sh` 는 subagent 가 시작하고 멈출 때 감사 로그를 남긴다. 장부 정리이고 값싸다.

`validate-agent-artifact.sh` 가 재미있는 쪽이다. agent 가 멈출 때 발동해서, 그 subagent 가 지시서에 적힌 파일을 한 번도 쓰지 않았다면 경고한다. 작은 검사이고 겨냥한 것은 구체적인 고장이다. 병렬 agent 를 돌려 본 사람이면 다 겪는다. subagent 는 성공을 보고하고, 오케스트레이터는 다음으로 넘어가고, 파일은 없다. stop 이벤트에서 잡는 게 맞다. 부모가 아직 맥락을 갖고 다시 배정할 수 있는 마지막 순간이기 때문이다.

나머지 hook 은 commit, push, 에셋 변경, 설계 문서 읽기와 쓰기, 레지스트리, 세션 생애주기를 덮는다. 선택 도구가 없으면 hook 은 조용히 성능을 낮추지만, 의도된 예외가 하나 있다. 데이터 JSON 을 스테이징한 commit 은 Python 이 없으면 막힌다. 검증기를 돌릴 수 없기 때문이다.

함정은 요구 사항 목록에 있다

설치는 README 의 네 줄이고, 그중 한 줄이 경고다.

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

그다음 `/start` 를 입력한다. 시스템은 당신이 어느 단계인지 묻고, 아무 생각 없는 상태부터 기존 프로젝트까지 분류해 워크플로로 보낸다. `/setup-engine godot 4.7`, `/brainstorm`, `/project-stage-detect` 로 바로 뛰어도 된다.

경고는 이렇다. `CLAUDE.md` 와 `project.yaml` 이 있는 폴더에서 Claude Code 를 시작하라. `src/` 에서 시작하면 프로젝트의 hook, deny 규칙, 먼저 묻는 권한 모드가 전부 건너뛰어진다. 구조가 하나도 없는 어시스턴트를 받게 되고, 아무것도 알려 주지 않는다.

의존성은 Git, Claude Code(네이티브 설치 프로그램을 권한다. `npm install -g @anthropic-ai/claude-code` 는 Node 22+ 에서 된다), Python 3, Bash 다. Python 3 은 보이는 것만큼 선택 사항이 아니다. 모든 skill 과 hook 이 이걸 통해 `project.yaml` 을 읽고, Python 이 없으면 모든 설정이 조용히 기본값으로 돌아간다. 조용한 폴백은 크래시보다 나쁘다. 스튜디오는 잘못된 설정으로 계속 돌고, 규칙이 발동하지 않을 때까지 아무도 모른다. jq 는 hook 검증용으로 권장된다.

주 개발 환경은 Windows 10 과 Git Bash 이고, hook 은 macOS 기본 bash 3.2 와 Linux 에서도 시험했다. `notify.sh` 는 Windows 에서 PowerShell 로 토스트 알림을 띄우고 다른 플랫폼에서는 아무것도 하지 않는다. 데스크톱 알림은 당분간 Windows 전용이다.

엔진 전문가 아홉 명, 필요한 건 한 명

템플릿에는 Godot 4, Unity, Unreal Engine 5 용 agent 세트가 들어 있다. 각각 리드 하나에 하위 전문가가 붙는다. Godot 은 GDScript, 셰이더, GDExtension. Unity 는 DOTS/ECS, 셰이더와 VFX, Addressables, UI Toolkit. Unreal 은 GAS, Blueprints, 리플리케이션, UMG/CommonUI.

셋을 한 저장소에 두는 건 합리적인 헤지이고, 대신 영원히 읽지 않을 텍스트를 잔뜩 안고 간다. README 의 커스터마이즈 절은 필요 없는 agent 파일은 지우라고 말한다. 맞는 조언이고 아무도 하지 않는 일이다.

자율성이 아닌 부분

README 는 이것이 오토파일럿이 아니라고 분명히 말하고, 협업 프로토콜이 그 말을 받쳐 준다. agent 는 제안 전에 묻는다. 두 개에서 네 개의 선택지를 트레이드오프와 함께 낸다. 결정은 사용자가 한다. 확정 전에 초안을 보여 준다. 승인 없이는 아무것도 쓰지 않는다. `guided` 와 `autonomous` 모드는 확인 일부를 속도와 맞바꾸고, README 는 자동 모드로 들어가는 경로를 자체 설치 문서로 안내한다.

프레임워크 자체를 위한 테스트 하네스도 있다. `studio-tests/` 는 skill 74 개와 agent 49 개를 범주별 평가 기준과 행동 명세와 함께 목록화하고, `/skill-test` 는 일곱 항목의 준수 검사를 가진 정적 린터, 범주 평가 기준, 명세 단언을 돌린다. `/skill-improve` 는 테스트, 수정, 재테스트 루프를 돌리고 점수가 오르지 않으면 되돌린다. 게임과 별개로 프레임워크를 시험하는 것이 이걸 고칠 수 있게 유지하는 규율이다.

이게 실제로 무엇을 위한 것인가

README 는 한 소제목에서 스스로에게 어색한 질문을 던진다. 이건 게임을 만드는가, 문서를 만드는가. 문서 템플릿 62 개와 모든 마일스톤의 게이트를 갖춘 템플릿은, 1인 개발이 코드에서가 아니라 과정에서 죽는다는 쪽에 건다. 그 판단은 방어 가능하다. AI 지원 1인 프로젝트가 무너지는 방식은 대개 기록되지 않은 하드코딩된 매직 넘버, 세 번의 개정 전 게임을 설명하는 설계 문서, 스모크 체크를 아무도 돌리지 않아 망가진 튜토리얼을 안고 나간 빌드다.

agent 49 개가 그걸 고치지는 않는다. 게임플레이 코드가 수정될 때 발동하는 경로 범위 규칙, 빌드 전에 반드시 돌아야 하는 `/smoke-check`, 검증기를 돌릴 수 없을 때 commit 을 막는 hook 이 더 나을 가능성이 있다. 여기서 진짜 흥미로운 것은 누군가 조직도를 적어 두었다는 사실이다. 전문가가 에스컬레이션하고 기다려야 하는 부분까지 포함해서.

관련 글