클로드 코드 오케스트레이터가 유용하기 위해 필요한 4가지

Claude Code로 오케스트레이터 에이전트(다른 에이전트를 관리하는 에이전트)를 구축한다면, 4가지 구성 요소가 유용한 시스템과 혼란스러운 시스템을 가릅니다. 수개월간 직접 구축해본 경험을 바탕으로 알려드립니다.

1. 미션 문서

오케스트레이터가 기본 모델 지능에만 의존하게 두지 마세요. '미션 문서' — 무엇을 할지, 어떻게 할지, 언제 에스컬레이션할지 정의하는 직무 설명서를 작성하세요. 버그 리포트 오케스트레이터의 경우 다음과 같을 수 있습니다:

• 제목에 '고객 피드백'이 포함된 이메일 확인
• 로컬에 티켓 등록
• 하위 에이전트를 생성하여 버그 재현 및 수정(복합 엔지니어링 또는 superpowers, GSD 같은 플러그인 사용)
• QA 준비가 되면 알림

4단계까지는 건드리지 않습니다. 최상의 경우 시간을 절약하고, 최악의 경우 코드가 폐기됩니다.

2. 하트비트 (루프)

루프 없는 오케스트레이터는 단순 일회성 스크립트에 불과합니다. 진정한 힘은 주기성 — 정해진 일정(10분마다, 1시간마다 등)에 따라 미션 문서를 다시 읽는 것입니다. 대부분의 에이전트 CLI는 루프나 크론 프리미티브를 제공합니다. 각 틱마다 오케스트레이터는 새 작업을 확인하고, 기존 작업의 진행 상황을 모니터링하며, 미션이 지시하는 다음 작업을 수행합니다.

3. 에이전트 간 통신

오케스트레이터는 하위 에이전트에 로드하지 않은 컨텍스트를 보유합니다. 하위 에이전트의 질문에 답하고, 에이전트 간 접근 방식을 조정하거나, 한 에이전트가 다른 에이전트의 작업을 검토하는 적대적 검토를 실행할 수 있습니다. 구현은 간단할 수 있습니다: 구조화된 규칙이 있는 공유 마크다운 파일, 메시지 전달 도구, 또는 백채널 시스템. 메커니즘보다 채널이 존재하는 것이 더 중요합니다.

4. 감사 가능한 제어

오케스트레이터가 다음을 기록하도록 구축하세요: 결정한 내용, 생성한 하위 에이전트, 하위 에이전트가 생산한 결과. 모든 하위 에이전트에 접근하여 작업을 검토하고 언제든지 중단할 수 있어야 합니다. 모든 것에 대한 가시성만이 출력에 확신을 가질 수 있는 유일한 방법입니다 — 모든 결과에 대한 책임은 당신에게 있습니다.

이 원칙들은 원본 영상에 나온 도구를 사용하든 다른 에이전트 도구를 사용하든 동일하게 적용됩니다. 이미 사용 중인 도구로 오케스트레이터를 구축할 수 있습니다.