Claude Code로 병렬 게임 개발을 굴린 협업 구조

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

세 명의 팀원이 Design, Art, Playtesting을 맡고 Claude Code가 구현·테스트·문서화를 담당하는 게임 제작 협업 구조이다. Claude Code는 저장소의 14개 Design Spec을 기준으로 작업하며, WORKLOG.md에서 사람과 에이전트가 수정 영역을 선점하고 해제해 병렬 작업을 조정한다. Ship Script는 Fetch, Rebase, 테스트 Gate, Push를 순서대로 실행하고 약 3,200개 테스트와 230개 Spec File을 통과한 변경만 Main에 반영한다. Art는 독립적인 HTML/WebGL Study를 원본으로 삼고 Geometry Extractor로 게임에 반영해 시각 자산의 Drift를 막는다.

실용적 조언

AI Coding Agent에 모든 요구사항을 매번 다시 전달하지 말고, 저장소에 갱신 가능한 Design Spec을 두고 작업의 기준으로 사용한다. 이 게시물의 팀은 14개 문서를 Claude Code가 읽게 해 구현, 테스트, 문서화 작업을 연결했다. 기능 변경이 생기면 대화 기록보다 저장소의 명세를 먼저 갱신하는 방식이 재현 가능한 협업 흐름에 가깝다.
병렬 작업의 충돌을 줄이려면 작업 시작 전에 수정 대상을 기록하고, 작업이 끝나는 Push에서 그 기록을 함께 해제한다. WORKLOG.md처럼 모든 사람과 에이전트가 공유하는 조정 파일을 두면 누가 어떤 영역을 점유했는지 확인할 수 있다. 다만 이 글에서 확인된 수치는 약 3,200개 테스트와 230개 Spec File이므로, 동일한 규모나 효과가 다른 프로젝트에서도 보장된다고 확대할 근거는 없다.
자동화된 반영 게이트를 두고 Fetch, Rebase, 테스트 실행, Push를 정해진 순서로 묶는다. 테스트가 실패하면 Main 브랜치에 Push하지 못하게 만들어 에이전트가 만든 Broken Main을 차단하는 것이 핵심이다. 게시물의 사례에서는 이 방식이 세 명의 사람과 여러 병렬 에이전트의 동시 작업을 지탱하는 안전장치로 쓰였다.

섹션별 상세

세 명의 팀원은 Design, Art, Playtesting을 맡고 Claude Code는 구현, 테스트, 문서화를 맡는 역할 분담으로 게임을 제작했다. Claude Code는 단순한 일회성 Prompt가 아니라 저장소에 있는 14개 Design Spec을 읽고, 작업이 진행될 때 갱신된 문서를 기준으로 코드를 작성했다. 이 구조는 자연어 지시와 구현 결과 사이의 기준을 저장소 안에 고정해 반복 작업의 일관성을 확보하는 방식이다.

여러 사람이 여러 에이전트와 병렬로 작업할 때의 조정 수단은 WORKLOG.md 하나로 통일했다. 사람과 에이전트가 작업 시작 전에 자신이 수정할 대상을 평이한 영어로 선점하고, 변경사항을 반영한 동일한 Push에서 선점을 해제하므로 작업 영역 충돌을 추적할 수 있다. 작성자는 이 절차 덕분에 세 명의 사람과 여러 병렬 에이전트를 운용하면서 Merge Hell을 피했다고 설명했다.

깨진 코드가 Main 브랜치에 들어가지 않도록 Ship Script가 Fetch, Rebase, Gate 실행, Push 순서를 강제했다. 프로젝트에는 230개 Spec File에 걸쳐 약 3,200개의 테스트가 있으며, 에이전트는 이 검증을 통과하지 못하면 Broken Main을 Push할 수 없다. 작성자는 병렬 개발을 확장하게 만든 단일 요인이 이 차단 장치였다고 평가했다.

Art Pipeline에서는 Voxel 캐릭터 리그, 조각한 바위, Toon Shader 스타일을 독립적인 HTML/WebGL Study로 만들고, Claude Code가 각 Study의 Geometry를 게임용 데이터로 추출하는 Extractor를 작성했다. 게임 안에서 Art를 다시 구현하는 대신 Study 자체를 Source of Truth로 유지해 원본과 게임 결과의 Drift를 막는 흐름이다. 따라서 시각 자산을 수정할 때 별도 구현이 원본과 달라지는 문제를 줄이는 협업 구조가 마련된다.

용어 해설

설계 명세서(Design Spec): — 게임의 기능과 구현 요구사항을 문서로 정리해 저장한 기준 문서이다. Claude Code가 저장소에 있는 14개 문서를 읽고 작업하므로, 사람의 지시가 대화마다 흩어지지 않고 프로젝트의 최신 설계와 연결된다.
WORKLOG.md 협업 기록(WORKLOG.md): — 사람과 에이전트가 작업 전에 담당 영역을 영어로 기록하고, 작업이 반영된 동일한 Push에서 담당 상태를 해제하는 조정 문서이다. 여러 작업이 병렬로 진행될 때 변경 영역을 공유하는 단일 협업 계층으로 쓰인다.
Ship Script: — 변경사항을 가져오고 Rebase한 뒤 테스트 게이트를 통과했을 때만 Push하는 자동화 스크립트이다. 이 절차가 깨진 Main 브랜치의 반영을 차단해 여러 에이전트가 동시에 작업할 때 병합 안정성을 유지한다.
HTML/WebGL 스터디(HTML/WebGL): — Voxel 캐릭터 리그와 조각한 바위, Toon Shader 같은 시각 요소를 독립적인 HTML/WebGL 실험으로 제작하는 방식이다. Claude Code가 스터디의 Geometry를 추출해 게임에 구워 넣으므로 원본 스터디와 게임 속 결과가 어긋나는 문제를 줄인다.

언급된 도구

Claude Code추천

저장소의 Design Spec을 읽고 게임의 코드, 테스트, 문서를 작성하는 Coding Agent

언급된 리소스

문서WORKLOG.md