다단계 에이전트 워크플로우를 위한 오케스트레이션 도구 탐색

실용적 조언

상위 에이전트의 컨텍스트 소모를 줄이기 위해 서브 에이전트의 작업 결과를 핵심만 요약하여 전달하는 중간 레이어를 구현하라.
CLI 호출 제약을 해결하기 위해 Python의 subprocess 또는 Pexpect 라이브러리를 사용하여 Claude Code CLI의 입출력을 자동화하는 래퍼를 작성하라.

섹션별 상세

사용자는 '계획(Plan) - 계획 검토(Review Plan) - 계획 반복(Iterate on Plan) - 구현(Implement) - 검토(Review) - 피드백 반복(Iterate on Feedback)'으로 구성된 고도로 구조화된 루프를 제어할 도구를 필요로 한다. 특히 각 피드백 항목별로 세밀하게 반복 작업을 수행하는 기능이 핵심 요구사항이다.

기존에 Claude Code 내에서 프롬프팅을 통해 서브 에이전트를 활용하는 방식을 시도했으나 기술적 한계에 직면했다. 서브 에이전트가 생성하는 데이터가 상위 에이전트의 컨텍스트 윈도우를 과도하게 점유하여 전체적인 작업 효율과 기억력이 저하되는 문제가 발생했다.

Anthropic의 구독 서비스 약관(TOS)을 준수하기 위해 외부 도구가 API를 직접 호출하는 대신 CLI 기반의 Claude Code를 호출하여 실행해야 하는 특수한 제약이 존재한다. 이는 일반적인 API 중심의 오케스트레이션 프레임워크를 그대로 적용하기 어렵게 만드는 요인이다.

사용자는 현재 이러한 요구사항을 모두 충족하는 기성 도구를 찾지 못해 직접 '하네스(Harness)'를 구축하고 있다. 커뮤니티에 이미 존재하는 유사한 솔루션이 있는지 확인하여 중복 개발을 방지하고 최적의 아키텍처를 설계하고자 한다.

용어 해설

오케스트레이터(Orchestrator): — 여러 AI 에이전트의 실행 순서, 데이터 흐름, 상호작용을 관리하는 시스템이다. 복잡한 작업을 작은 단위로 분할하여 적절한 에이전트에게 할당하고 결과를 취합하는 지휘자 역할을 수행하여 워크플로우의 효율성을 높인다.
컨텍스트 윈도우(Context Window): — LLM이 한 번에 처리하고 기억할 수 있는 텍스트의 최대 범위이다. 서브 에이전트가 생성한 방대한 데이터가 상위 에이전트의 메모리를 차지하면 중요한 정보를 잊거나 성능이 저하되는 문제가 발생할 수 있다.
서브 에이전트(Sub-agent): — 주 에이전트의 지시를 받아 특정 하위 작업을 수행하는 독립적인 AI 개체이다. 작업을 모듈화하여 복잡성을 줄일 수 있지만, 에이전트 간 통신 과정에서 발생하는 데이터가 전체 시스템의 자원을 소모하는 단점이 있다.
서비스 이용 약관(TOS): — Terms of Service의 약자로, 서비스 제공자와 사용자 간의 법적 계약이다. 여기서는 Anthropic 구독 정책에 따라 API를 직접 호출하는 대신 특정 CLI 도구를 경유해야 하는 기술적/법적 제약 조건을 의미한다.

언급된 도구

Claude Code추천

CLI 기반의 자율 코딩 에이전트 도구