다중 코딩 에이전트 병렬 관리 오픈소스: Untrivial-ai 'Agent Orchestrator'
Untrivial-ai가 Claude Code, Codex 등 25종 이상의 하네스를 연동하고 독립 git worktree에서 계획부터 PR 병합까지 전 과정을 감독하는 오픈소스 Agent Orchestrator를 공개했습니다.
인공지능 기반 소프트웨어 개발 도구를 개발하는 Untrivial-ai가 코딩 에이전트 팀의 작업 계획 수립부터 최종 풀 리퀘스트(PR) 병합(merge)까지의 전 과정을 통합 실행하고 감독하는 오픈소스 오케스트레이션 도구 'Agent Orchestrator'를 공개했습니다. Apache 2.0 라이선스로 배포되는 이 도구는 개발자가 개별 터미널 세션마다 수동으로 에이전트를 구동하던 방식에서 벗어나, 복수의 에이전트가 협력하는 작업 흐름을 체계적으로 조율할 수 있도록 설계되었습니다.
이미지 출처: Tom Dörr (@tom_doerr)
기존 코딩 에이전트 워크플로우가 단일 CLI 세션 내에서 일회성 프롬프트를 입력하고 결과를 확인하는 대화형 구조에 머물렀다면, Agent Orchestrator는 대규모 코드베이스에서 여러 기능과 버그 수정을 동시다발적으로 처리해야 하는 엔지니어링 조직의 요구에 맞춰 에이전트 팀 전체의 실행 상태와 코드 변경 라이프사이클을 단일 제어 화면으로 끌어올렸습니다.
25종 이상의 하네스 연동과 멀티 환경 에이전트 연결
Agent Orchestrator의 주요 기술적 특징 중 하나는 특정 모델 공급자나 단일 CLI 도구에 종속되지 않는 폭넓은 하네스(Harness) 지원 생태계입니다.
Anthropic의 Claude Code와 OpenAI의 Codex를 비롯해 개발 현장에서 널리 쓰이는 25개 이상의 다양한 코딩 에이전트 하네스를 지원합니다. 개발자는 이미 팀이나 개인 환경에 구축된 선호 도구를 교체하지 않고도 오케스트레이션 레이어에 그대로 연결하여 작업 명령을 분배할 수 있습니다.
- 이기종 에이전트 통합: 서로 다른 프롬프트 규약과 실행 방식을 가진 에이전트들을 통일된 감독 계층 아래에서 관리합니다.
- 다양한 실행 환경 연계: 로컬 데스크톱 워크스테이션 환경뿐만 아니라 웹, 모바일, 클라우드 환경에서 구동되는 에이전트 인스턴스를 하나로 묶어 유기적으로 연결합니다.
- 도구 독립적 파이프라인: 특정 CLI 환경의 제약에 갇히지 않고 프로젝트의 요구사항에 맞춰 가장 적합한 에이전트 하네스를 유연하게 배치할 수 있습니다.
독립 Git Worktree 기반 병렬 실행과 전 주기 라이프사이클 감독
여러 에이전트가 동시에 동일한 프로젝트 저장소를 수정할 때 발생하기 쉬운 파일 충돌과 브랜치 오염 문제를 방지하기 위해, Agent Orchestrator는 git의 독립 worktree 메커니즘을 핵심 격리 수단으로 채택했습니다.
각 에이전트는 서로 간섭하지 않는 독립된 git worktree 작업 디렉토리에서 격리되어 코드를 읽고 수정합니다. 이를 통해 여러 에이전트가 각자의 기능 브랜치를 병렬로 빌드하고 테스트할 수 있는 안정적인 실행 환경을 보장합니다.
- 계획부터 병합까지 단일 제어 화면 감독: 초기 태스크 분석 및 작업 계획 수립 단계부터 에이전트별 진행 상태를 시각화하여 단일 대시보드에서 전 과정을 모니터링합니다.
- 풀 리퀘스트(PR) 자동화 및 CI 실패 복구: 에이전트가 수정한 코드를 바탕으로 각각의 풀 리퀘스트를 생성하며, 지속적 통합(CI) 파이프라인에서 테스트나 린트 실패가 감지될 경우 에이전트가 실패 로그를 분석해 자체적인 코드 복구 시도를 진행하도록 조율합니다.
- 코드 리뷰 루프 통합: 변경 사항에 대한 자동화된 코드 리뷰 절차를 감독 파이프라인에 포함하여, 인간 리뷰어가 최종 병합 승인을 내리기 전까지 에이전트가 품질 요건을 충족하도록 반복 검증합니다.
단일 세션 대비 복잡도 트레이드오프와 도입 고려 기준
Agent Orchestrator는 복잡한 병렬 작업을 체계적으로 다룰 수 있는 장점을 제공하지만, 모든 개발 상황에 일률적으로 권장되는 것은 아닙니다.
세션별로 단순한 스크립트를 빠르게 실행하거나 국소적인 버그 하나를 수정하는 단일 작업의 경우, 개별 에이전트 CLI를 직접 실행하는 편이 설정 비용 측면에서 더 간결할 수 있습니다. 반면 다수의 브랜치와 여러 PR을 동시에 발행하고 CI 피드백을 지속적으로 수렴해야 하는 프로젝트에서는 오케스트레이션 레이어가 제공하는 병렬화와 자동 복구 기능이 실질적인 생산성 향상으로 이어집니다.
- 도입 복잡도: 단순 CLI 세션 호출 대비 오케스트레이션 레이어 구축에 따른 사전 설정과 환경 관리 복잡도가 추가로 요구됩니다.
- 최적 활용 규모: 단일 태스크의 즉각적 실행보다는 복수의 브랜치를 동시에 다루고 PR 단위의 엄격한 품질 관리가 필요한 중대형 프로젝트 및 팀 단위 협업에 적합합니다.
- 오픈소스 접근성: 소스 코드와 설정 명세는 Apache 2.0 라이선스 하에 공식 GitHub 저장소(Untrivial-ai/agent-orchestrator)를 통해 공개되어 있어, 개발 조직의 인프라와 워크플로우에 맞춰 자유롭게 점검하고 도입 타당성을 평가할 수 있습니다.