7개의 Claude Code 에이전트 팀으로 코드 리뷰와 협업을 자동화하여 기능을 배포하는 방법

저는 SaaS 제품의 기능을 배포하는 7개의 Claude Code 에이전트 시스템을 운영하고 있습니다. 에이전트들은 코드베이스의 서로 다른 부분을 병렬로 작업하고, 내부적으로 서로의 코드를 리뷰하며, 핸드오프를 직접 처리합니다. 저는 최종 PR 단계에서만 개입합니다. 이런 협업이 실제로 어떻게 작동하는지에 대한 글을 많이 보지 못해서 전체 설정을 정리해 보려고 합니다.

문제점
제가 본 대부분의 멀티 에이전트 설정은 두 가지 유형이었습니다. 하나는 단일 에이전트가 복잡한 작업을 처음부터 끝까지 수행하는 경우(리뷰가 없어서 초안 수준의 결과물이 나옴), 다른 하나는 N개의 서브 에이전트가 소통이나 공유 메모리 없이 병렬로 실행되는 경우(규모가 커지면 같은 문제가 발생하고, 사람이 직접 핸드오프를 중재해야 함)입니다.

판단이 필요한 작업(디자인 결정, 엣지 케이스, 아키텍처 트레이드오프 등)에는 위 두 패턴 모두 제대로 작동하지 않습니다. 에이전트끼리 서로 대화하고, 리뷰하고, 핸드오프를 직접 처리하는 에이전트가 필요합니다. 제가 최종적으로 도달한 설정이 바로 이것입니다.

아키텍처:
• 관리를 위한 시각적 UI가 포함된 'pentagon run'이라는 전용 에이전트 워크스페이스를 사용합니다. 각 에이전트에게 고유한 정체성과 목적, 폴더 범위의 권한, 다른 에이전트와의 직접 메시지(DM) 기능을 제공합니다.
• 각 에이전트 하단에는 Claude Code가 실행됩니다.
• 공유 지식 베이스, 코드베이스 컨벤션, 아키텍처 결정 사항, 디자인 패턴을 활용합니다.

팀 구성:
• 오케스트레이터(1명): 작업을 할당하고 핸드오프를 라우팅하며, 리뷰가 필요하거나 막히는 부분이 있으면 저에게 알림을 보냅니다.
• 백엔드 팀(2명): 빌더는 /apps/api에 코드를 작성하고, 크리틱은 아키텍처 및 엣지 케이스 기준에 따라 diff를 리뷰합니다. 크리틱이 빌더에게 피드백을 보내면 빌더가 최종 버전을 빌드합니다.
• 프론트엔드 팀(2명): /apps/web에 대해 동일한 구조로 운영됩니다.
• 인프라 에이전트(1명): /infra와 /scripts를 단독으로 처리합니다. CI 설정, 배포 스크립트 등을 담당합니다. 작업량이 적어 크리틱 루프가 효율적이지 않아, 지식 베이스 패턴을 기준으로 스스로 리뷰하고 위험해 보이면 저에게 알림을 보냅니다.
• 품질 에이전트(1명): 테스트를 작성하고 문서를 업데이트합니다. 인프라 에이전트와 같은 논리로 작동하며, 지식 베이스를 기준으로 검증합니다.

작동을 가능하게 하는 구체적인 요소들
• 직접 에이전트 DM: 제가 메시지를 라우팅할 필요 없이 빌더-크리틱-리파이너 루프가 자동으로 돌아갑니다.
• 에이전트별 지침 문서: 각 에이전트가 고유한 정체성과 목적을 가지고 있어, 리뷰 에이전트가 단순히 동의만 하는 것이 아니라 의미 있는 피드백을 제공합니다.
• 폴더 권한: 구조적으로 소유권을 강제합니다. 한 팀의 빌더는 권한 범위 밖의 코드를 작성할 수 없으므로 다른 팀의 작업을 실수로 덮어쓰지 않습니다.
• 공유 지식 베이스: 모든 에이전트가 동일한 컨벤션과 패턴 저장소에서 정보를 가져올 수 있습니다.
• 캔버스: 7개의 에이전트를 한 화면에 타일 형태로 배치하여 팀별로 시각화합니다. 에이전트가 많아지면 시각적 레이어만이 무슨 일이 일어나고 있는지 파악할 수 있는 유일한 방법입니다.
• 에이전트별 메모리: 특히 크리틱 에이전트들은 이 코드베이스에서 이전에 잡아냈던 문제 패턴을 기억하며 시간이 지날수록 더 날카로워집니다.

에이전트 설정에 대해 궁금한 점이 있으면 답변해 드리겠습니다.