Claude Code Game Studios는 게임 개발 작업을 director, lead, specialist 역할과 품질 gate로 나누려는 구성입니다. 48이라는 숫자 자체가 품질을 보장하지 않으며, 역할별 context가 실제로 분리되는지와 추가 호출이 단일 Agent보다 오류, review 시간을 줄이는지 확인해야 합니다. 전체를 한 번에 적용하기보다 한 workflow와 필요한 역할만 골라 평가하는 편이 안전합니다.
프로젝트 저장소의 조직도는 기획, engine, code review, QA 책임을 명시적으로 나누려는 시도입니다. 이는 사람 조직과 동일한 책임, 판단 능력을 뜻하지 않고 prompt, artifact와 실행 규칙을 분리한 workflow로 이해해야 합니다.
평가할 핵심은 Agent 숫자가 아니라 context isolation과 hierarchical escalation입니다. 연결된 기사나 사건을 framework 기능의 증거로 삼을 수 없으며, “완벽한 orchestration” 같은 표현도 실제 call trace와 test 없이 확정할 수 없습니다.
단일 세션에 기획, art, sound와 engine 설정을 모두 넣으면 관련 없는 정보가 섞일 수 있습니다. 역할별 지침 파일은 읽을 범위를 좁힐 수 있지만 물리적 격리를 자동으로 만들지는 않습니다. 각 호출의 실제 prompt, 공유 memory와 tool 권한이 분리돼 있는지 확인해야 합니다.
이들은 철저한 조직 계층 구조를 가집니다. 최상단에는 ‘비전(Vision) 디렉터’가 존재하고, 그 아래 Unity, Unreal, Godot 엔진별 테크 리드, 그리고 가장 밑단에 실제 스크립트를 작성하는 스페셜리스트가 있습니다. 코드를 작성하는 스페셜리스트는 기획을 바꿀 권한이 없습니다. 기획적 판단이 필요하면 상위 디렉터에게 에스컬레이션해야 합니다.
| 비교 항목 | 기존 단일 Claude Code 세션 | Claude Code Game Studios |
|---|---|---|
| 의사결정 구조 | 유저 1 : AI 1의 선형적 핑퐁 (컨텍스트 혼재) | 디렉터 -> 리드 -> 스페셜리스트 (수직적 계층 분리) |
| 품질 통제 (QA) | 유저가 직접 코드 실행 후 에러 메시지 복붙 | 자체 QA 에이전트가 자동화된 품질 게이트 및 테스트 실행 |
| 컨텍스트 관리 | 모든 대화가 누적되어 토큰 낭비 및 환각(Hallucination) 발생 | 에이전트별 독립된 CLAUDE.md로 컨텍스트 오염 원천 차단 |
| 작업 시작 방식 | “이런 게임 만들어줘” (무계획 프롬프트) | /start 커맨드를 통한 프로젝트 상태 진단 및 워크플로우 강제 |
각 역할의 폴더와 설정은 책임을 문서화하는 데 도움을 줄 수 있습니다. 아래 JSON은 품질 gate의 개념을 보여 주는 예시이며, 실제 repository가 같은 schema를 실행하거나 require_approval을 기술적으로 강제하는지는 code와 선택한 version에서 확인해야 합니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"agent_profile": "Lead_Gameplay_Programmer",
"engine_target": "Godot_4.6",
"capabilities": ["read_files", "execute_scripts", "git_commit"],
"quality_gates": {
"pre_commit_checks": [
{
"step": "magic_number_audit",
"description": "Ensure no hardcoded physics values. Must reference GlobalConfig.gd",
"action_on_fail": "escalate_to_director"
},
{
"step": "peer_review",
"agent": "Code_Review_Specialist",
"require_approval": true
}
]
}
}
설정 문구만으로 commit이 차단되는 것은 아닙니다. hook exit code, branch protection과 CI가 실제 gate를 집행하고 우회, timeout 때 fail closed하는지 확인해야 합니다. “magic number 없음” 같은 규칙도 모든 상수가 나쁜 것은 아니므로 project의 허용 기준과 검사 결과를 사람이 검토합니다.
role handoff에는 자유 형식 결론보다 입력 artifact, 근거 file, commit, 결정된 제약과 미해결 질문을 구조화해 넣습니다. 하위 Agent가 기획을 바꿀 수 없게 하려면 prompt 지시뿐 아니라 write 가능한 artifact와 승인 workflow를 분리해야 합니다. escalation이 순환하면 최대 hop와 owner를 정해 deadlock을 막습니다.
/project-stage-detect 같은 명령과 architecture.md 생성 흐름은 실제 version에서 존재, 작동하는지 먼저 확인합니다. 구조 지도는 원본 code를 대체하는 헌법이 아니라 특정 commit의 색인입니다. file, dependency 근거와 생성 commit을 붙이고 code가 바뀌면 오래된 문서를 감지해야 합니다.
하위 역할이 문서를 그대로 믿으면 초기 분석 Agent의 오해가 전체에 전파됩니다. network module처럼 위험한 변경에서는 static 구조, test와 runtime trace를 함께 확인하고 한 module의 작은 diff부터 시작합니다. “side effect 없음”은 실제 regression, load test로만 판단할 수 있습니다.
매 frame object 생성과 pooling 중 어느 쪽이 나은지는 Agent들의 논쟁이 아니라 목표 device의 profiler 결과로 정합니다. Performance 역할은 allocation, frame time과 GC spike의 측정 command와 결과를 artifact로 제출해야 합니다. threshold를 넘으면 merge를 막는 것은 CI가 집행하고, pooling 자체가 만드는 복잡성과 memory도 함께 비교합니다.
두 Agent가 같은 추측을 반복해서 합의할 수 있으므로 의견 수를 근거로 세지 않습니다. build, test, profiler 같은 결정적 검증기를 최종 gate로 두고, 성능 개선이 gameplay correctness를 깨뜨리지 않는지 regression을 봅니다.
texture size, compression과 FBX metadata처럼 규칙으로 판정할 항목은 LLM보다 deterministic hook이 먼저입니다. Agent는 예외 사유와 수정 제안을 설명할 수 있지만 원본 asset을 자동 변환해 덮어쓰기 전에는 artist 승인과 visual 비교가 필요합니다. UI의 4K PNG가 항상 오류라는 단일 규칙 대신 platform, folder별 budget을 version으로 관리합니다.
첫째, 역할마다 model call과 handoff context가 추가됩니다. 전체 역할을 항상 호출하지 말고 task type별 최소 graph를 정합니다. Agent, 단계별 input, output token, p95 완료 시간과 실제로 발견한 고유 오류를 기록해 비용만 쓰는 역할을 제거합니다.
둘째, hook, JSON, Git과 각 역할의 승인 관계를 운영할 학습 비용이 있습니다. A가 B 승인을 기다리고 B가 A의 artifact를 요구하는 cycle을 graph validation으로 탐지하고, 최대 escalation hop와 timeout 뒤 사람 owner를 둡니다. 모든 역할을 복구하려고 전체 workflow를 재시작하면 중복 변경이 생길 수 있어 성공 artifact와 실패 상태를 분리합니다.
셋째, 역할 이름이 권한을 대신할 수 없습니다. QA Agent라고 해서 test 삭제 권한까지 주거나 specialist가 project 전체를 쓸 수 있게 하면 분리의 의미가 없습니다. 역할별 read/write path, 실행 command와 network를 최소화하고 write 결과는 격리 branch에 남깁니다.
작은 gameplay 변경 10~20개를 골라 단일 Agent, 필요한 lead, specialist, QA 세 역할, 더 큰 graph를 같은 test에서 비교합니다. 성공률, 무관 diff, 고유하게 잡은 오류, 총 호출, review 수정과 deadlock을 기록합니다. 역할 하나를 뺐을 때 결과가 나빠지지 않으면 조직도에서 제거합니다.
첫 적용은 결정적 gate가 이미 있는 비핵심 project가 적합합니다. hook이 실제로 commit을 막는지, context와 tool 권한이 역할별로 달라지는지, 중단 후 어느 artifact부터 복구하는지 확인합니다. architecture 문서와 Agent 합의는 원본 code, profiler, test를 대체하지 않습니다.
Claude Code Game Studios의 의미 있는 아이디어는 사람 조직을 48개 이름으로 흉내 내는 데 있지 않습니다. 큰 작업을 검증 가능한 handoff로 나누고 책임을 넘을 때 명시적으로 escalation하자는 것입니다. 그 이득이 비용과 운영 복잡성을 넘어서는 역할만 남겨야 합니다.
아닙니다. 각 역할이 독립적으로 검증 가능한 오류를 줄이는지 ablation으로 확인하고 기여가 없는 역할은 제거해야 합니다.
파일을 나누는 것만으로 실행 context 격리가 보장되지는 않습니다. 실제 호출 입력, 공유 artifact, tool 권한과 로그를 확인해야 합니다.
안 됩니다. 검토 Agent도 같은 오해를 공유할 수 있으므로 compiler, test, asset 검사와 사람의 diff review가 최종 gate로 남아야 합니다.
←→ 키와 좌우 스와이프를 지원합니다. 읽던 페이지는 이 기기에 저장됩니다.