ONEDEV

agent-orchestrator

AI Agent OrchestrationskillGo

★ 12,094주당 +298조회 5

무엇인가

작업을 단일 에이전트의 컨텍스트 안에서 처리하지 않고, 과제 단위로 분해해 각기 다른 실행 주체에 배정하는 절차를 규율한다. 규율 대상은 세 가지다. 어떤 작업을 어느 수준에서 계획할지, 각 작업에 어떤 격리 공간과 소유권을 줄지, 그리고 PR·CI·리뷰에서 발생한 실패와 변경 요청을 어느 에이전트에게 되돌릴지.

어떻게 동작하나

규칙 파일 한 장으로 주입되는 방식이 아니라 데스크톱 앱과 로컬 데몬으로 동작한다. 데스크톱 앱이 데몬을 대신 실행하고, 데몬이 에이전트 활동과 소스 관리 상태를 감시한다. 실행 단위는 워커 세션이다. 하나의 과제, 하나의 코딩 에이전트, 하나의 격리된 워크스페이스로 구성되며 과제 설명·에이전트·모델·인터페이스를 지정해 만든다. Git 기반 작업에는 전용 브랜치와 워크트리가 부여되고, 저장소가 없는 독립 에이전트에는 브랜치 없는 AO 관리 디렉터리가 부여된다. 프로젝트 오케스트레이터는 개별 과제 위 계층에서 방향·전략·우선순위·작업 순서를 다루는 상주 계획 에이전트로, 프로젝트 범위 대화에 목표·결정·제약·이전 추론을 보존하고 활성 워커·소유권·PR·CI·리뷰 상태를 함께 참조한다. 칸반 보드는 세션·PR·CI·리뷰 사실로부터 카드 위치를 도출하며 Working, Needs you, In review, Ready to merge 네 구간으로 나뉜다.

무엇과 다른가

프롬프트를 직접 작성하거나 CLAUDE.md·AGENTS.md 같은 정적 규칙 파일을 두는 방식과 구조가 다르다. 정적 규칙 파일은 한 에이전트의 컨텍스트에 텍스트를 적재하는 데 그치고, 브랜치 배정·워크트리 생성·PR 상태 추적은 그 바깥에서 사람이 처리해야 한다. AO는 격리 실행 공간과 상태 추적을 런타임이 담당하고, 에이전트는 구현·테스트·커밋·PR 작성에 집중하도록 역할을 분리한다. 여러 터미널과 브라우저 탭을 병렬로 띄워 두는 운용과도 다르다. 각 워커의 과제·대화·터미널·변경 파일·브라우저 프리뷰·PR·CI·리뷰 상태가 하나의 세션에 붙어 있어 병렬 작업이 하나의 공유 컨텍스트로 뭉개지지 않는다.

어떻게 쓰나

플랫폼에 맞는 AO 데스크톱 앱을 내려받아 실행하고, 관리할 저장소를 지정한다. 데스크톱 앱이 데몬을 함께 실행하므로 CLI는 필요하지 않다. 저장소를 추가한 뒤 New task로 과제를 서술하고 에이전트·모델을 고르고 관련 파일을 첨부하면 워커가 생성된다. 워커는 구조화된 Chat 또는 에이전트의 네이티브 터미널 UI에서 이어서 작업한다. 개별 과제보다 큰 결과물을 다룰 때는 프로젝트 오케스트레이터로 계획을 세우고, 계획이 실행 가능해지면 오케스트레이터가 과제를 분해해 워커를 생성하거나 재지정하고 각 워커에 관련 컨텍스트를 전달한다.

전제와 한계

Claude Code, Codex를 포함한 25개 이상의 하네스를 대상으로 하며, 데스크톱 앱과 로컬 데몬 실행이 전제다. Git 기반 격리는 저장소가 있어야 성립하고, 저장소 없는 독립 에이전트는 브랜치 없는 디렉터리로 동작한다. 오케스트레이터는 계획과 위임을, 워커는 구현·테스트·커밋·PR을 소유하는 분업이므로 한 에이전트 안에서 전 과정을 처리하는 방식은 지원하지 않는다. README에 CLI 설치 명령은 제시되지 않으며, 에이전트 CLI 설정과 문제 해결은 별도 설치 안내를 따른다.

유사 도구