개발자가 Claude Code 에이전트를 사용하여 단일 세션에서 42종의 보드 게임에 걸친 635개 이슈를 해결했습니다.

무료 멀티플레이어 보드 게임 플랫폼을 구축하는 한 명의 개발자가 Claude Code 에이전트를 사용하여 42개의 다양한 게임에서 수백 개의 UI/UX 문제를 단일 개발 세션 동안 체계적으로 해결했습니다.

설정

개발자는 로컬 SQLite 기반 트래커에 약 800개의 이슈를 관리했으며, 백엔드 Rust 버그(예: Rust와 TypeScript 간 필드 이름 불일치)와 프론트엔드 개선 작업을 모두 포함했습니다. 예시로는 "백개먼에 드래그 앤 드롭 기능 필요", "하트 게임에 유효하지 않은 플레이를 위한 카드 흐림 효과 필요", "쇼기에 핸디캡 지원 필요", "스카트에 람슈 모드 필요" 등이 있었습니다.

설정 파일에는 다음이 포함되었습니다:

• CLAUDE.md - 아키텍처 규칙 포함
• .claude/rules/ 파일 - 액터 모델, 게임 엔진 패턴, E2E 테스트 규칙 포함

이러한 규칙은 Claude가 작업을 시작할 때마다 자동으로 로드되었습니다.

워크플로우

개발자는 네 개의 에이전트를 동시에 실행하여 각각 다른 게임의 단일 이슈를 처리함으로써 파일 충돌을 방지했습니다. 에이전트 할당 예시:

• 에이전트 1: 백개먼 드래그 앤 드롭 수정 (#407)
• 에이전트 2: 벨로트 코인셰 입찰 UI 수정 (#417)
• 에이전트 3: 브리스콜라 필드 불일치 수정 (#454-457)
• 에이전트 4: 체스 포획 기물 표시 수정 (#494)

각 에이전트는 관련 파일을 읽고, 수정 사항을 구현하고, svelte-check를 실행하고, 이슈를 해결된 것으로 표시한 후 커밋했습니다. 이 네 개의 에이전트가 백그라운드에서 실행되는 동안, 개발자는 완료된 수정 사항을 검토하고 빌드 오류를 해결한 다음 다음 배치를 시작했습니다.

잘된 점

• "한 에이전트당 한 이슈, 절대 배치 처리 안 함" 접근 방식이 한 에이전트에 여러 이슈를 할당하는 것보다 효과적이었음
• CLAUDE.md의 엄격한 규칙(any 타입 사용 금지, data-ui 속성 사용, 필드 이름에 대한 백엔드를 진리의 원천으로 사용)이 일관된 코드를 보장함
• Claude가 Rust 게임 엔진 코드와 SvelteKit Canvas 렌더링을 동등하게 잘 이해함
• 에이전트가 Rust build_state_message() 함수를 읽고 해당 TypeScript 핸들러를 수정할 수 있었음
• 사운드 효과 구현이 성공적이었음—Claude가 오디오 파일 없이 Web Audio API 사운드(바둑의 나무 탭 소리, 하트 게임의 카드 스냅 소리, 백개먼의 주사위 굴림 소리)를 합성함

문제점

• 에이전트가 Rust에서 새로운 GameRule 열거형 변형을 추가할 때, judge.rs의 완전한 매치를 업데이트하는 것을 잊음
• 두 에이전트가 동일한 game.svelte.ts 저장소 파일을 수정할 때 간혹 병합 충돌 발생
• 일부 에이전트가 솔루션을 과도하게 설계함—20줄이면 충분한데 200줄을 추가하는 경우
• 트레인 도미노 테스트가 세 번 깨짐—에이전트가 round_scores를 Vec<u32>에서 Vec<Vec<u32>>로 변경하면서 모든 테스트 어설션을 업데이트하지 않음

결과

• 한 세션 동안 325개의 커밋
• 635개의 이슈 해결(총 약 800개 중 모든 중요 및 고우선순위 이슈 제거)
• 42개의 다른 게임 수정
• 전체 과정 동안 빌드 오류 0개 유지(Rust + 프론트엔드)
• 모든 게임에 다음 추가: 사운드 효과, 보드 테마, 이동 기록, 결과 화면, 해당 경우 드래그 앤 드롭

배운 점

• 매 배치 후 cargo check뿐만 아니라 cargo test도 실행했어야 함—일부 컴파일 타임에 정확한 변경 사항이 런타임 동작을 깨뜨림
• 각 에이전트가 바퀴를 재발명하는 대신 유사한 패턴을 가진 게임(트릭 테이킹 카드 게임, 4인용 NESW 레이아웃)에 대해 먼저 공유 컴포넌트를 생성했어야 함