Row-Bot 다중 에이전트 오케스트레이션

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Row-Bot은 부모 에이전트가 전체 작업을 계획하고 자식 에이전트에게 병렬 또는 순차로 작업을 위임하면서도 최종 결과는 부모가 합치는 구조를 사용합니다. Durable Orchestrator와 로컬 체크포인트(SQLite/tasks.db)를 통해 중단 시 상태 복구와 부분 실패 재시도가 가능하며 writer lock과 Git worktree로 파일 변경 충돌을 방지합니다. 이 설계는 다중 에이전트 협업의 병렬 이점을 살리면서도 제어권과 무결성을 유지하려는 실행 아키텍처입니다.

합의점 vs 논쟁점

합의점

부모 에이전트가 계획과 최종 합치기를 담당하면 병렬 자식 실행 중에도 작업 제어권을 잃지 않는다는 점은 이 설계의 핵심 목표로 받아들여집니다.
체크포인팅과 로컬 이벤트 저장을 통해 프로세스 중단 시 재시작하는 복구 메커니즘을 적용하면 부분 실패를 재시도만으로 처리할 수 있어 전체 작업 신뢰도가 올라갑니다.

실용적 조언

리서치나 외부 조회 같은 읽기 중심 태스크는 읽기 전용 권한을 부여한 자식 에이전트로 분리하면 안전하게 병렬 실행할 수 있습니다. 파일을 편집해야 하는 자식에게는 writer lock이나 독립된 Git worktree를 적용해 동시 편집 충돌을 방지해야 하며, 이렇게 하면 편집 중인 상태를 다른 자식이 덮어쓰지 못하게 막을 수 있습니다. 권한별 워크스페이스 분리는 보안과 무결성 측면에서 실무적으로 유용합니다.
체크포인팅과 이벤트 기반 저장을 적용해 중간 상태를 디스크에 남기면 프로세스가 중단돼도 전체를 처음부터 다시 실행할 필요가 없습니다. 실패한 자식만 재시도하거나 중지하는 정책을 운영하면 리소스 낭비를 줄일 수 있으며, 동시 실행 수를 제한해 Provider Runtime의 과부하를 방지하는 것이 좋습니다. 로컬 DB와 이벤트 로그는 복구 동작과 감사 추적에 유용하므로 도입을 권장합니다.

섹션별 상세

Row-Bot은 연구(Research), 코딩(Research/Coding), 검토(Review)를 서로 다른 자식 에이전트에게 병렬로 할당하면서 부모 에이전트가 최종 결과를 책임지는 구조를 채택했습니다. 이 방식은 각 작업을 별도 모델·컨텍스트·권한으로 실행해 역할별 격리를 보장하며, 부모는 필요한 결과가 모일 때까지 대기하고 합치는 역할을 수행합니다. 따라서 대규모 작업을 분할해 처리하되 최종 일관성은 부모가 유지할 수 있게 설계되어 있습니다.

내구성 오케스트레이터는 순서형 이벤트 인박스와 의존성 DAG, 필수 장벽(Required Barrier), 부모 리스(Parent Lease)를 조합해 작업 진행을 관리합니다. 이벤트와 체크포인트를 로컬 DB(SQLite / tasks.db)에 저장하고 재시작 시 해당 체크포인트로부터 복구하는 흐름을 사용해 부분 실패 때 전체를 다시 시작하지 않도록 합니다. 이로 인해 중간에 실패한 자식만 재시도하거나 중단할 수 있어 전체 작업의 효율과 안정성이 높아집니다.

파일 수정 작업은 격리된 워크스페이스와 writer lock 기법으로 충돌을 방지합니다. 읽기 전용 자식은 안전하게 리서치만 수행하도록 권한을 제한하고, 쓰기 권한이 필요한 자식은 락 또는 분리된 Git worktree에서 변경을 적용해 동시 편집 충돌을 막습니다. 이 접근은 병렬 작업 중 파일 무결성을 유지하면서도 병목을 최소화하는 현실적인 방법을 제공합니다.

운영면에서는 동시성 한도와 자원 사용 제한을 두어 과도한 병렬 실행을 통제합니다. Child Dispatcher가 부모별·전역 한도를 지켜 FIFO로 자식을 스케줄하고 Provider Runtime과 Tool Registry를 통해 툴 사용을 정책 필터링합니다. 결과적으로 시스템은 병렬성을 활용하되 리소스 고갈과 권한 남용을 동시에 제어하도록 설계되어 있습니다.

이미지 분석

Diagram
다이어그램은 부모 에이전트가 Plan·Delegate·Continue·Finalisation 단계로 작업을 제어하고 Durable Orchestrator가 이벤트 순서·의존성 DAG·필수 장벽·리스 관리를 담당하는 흐름을 시각적으로 연결합니다. 또한 Child Dispatcher와 연구/검토 스택, Provider Runtime과 Tool Registry, SQLite/tasks.db에 체크포인트와 이벤트를 저장하는 구조를 명확히 표시해 설계의 동작 경로와 복구 메커니즘을 빠르게 파악할 수 있게 합니다.
Row-Bot의 전체 아키텍처 다이어그램으로 부모 에이전트, 내구성 오케스트레이터, 자식 디스패처, 런타임/워크스페이스, 로컬 DB 층을 한눈에 보여줍니다.

용어 해설

부모 ReAct 에이전트(Parent ReAct Agent): — 부모 에이전트는 전체 작업의 계획자이자 최종 책임자로서 작업을 분해하고 병렬·순차로 자식 에이전트에 위임한 뒤 필요한 결과를 수집해 하나의 최종 응답으로 합칩니다. Plan→Delegate→Continue→Finalisation Guard 같은 단계로 동작하며, 최종 응답 전 필수 태스크 완료를 확인하는 보호 장치를 둡니다. 이 구조는 작업 흐름 통제와 결과 합치기를 부모 단일 주체로 유지하면서도 병렬 처리를 허용하도록 설계되어 있습니다.
내구성 오케스트레이터(Durable Orchestrator): — 내구성 오케스트레이터는 Ordered Event Inbox, Dependency DAG, Required Barrier, Parent Lease 같은 구성 요소로 작업 흐름을 관리하며 체크포인팅과 이벤트 기록을 통해 중단 복구를 지원합니다. 실패 시 Retry·Stop·Recovery 루틴을 갖추고 로컬 DB에 runs·events·checkpoints를 저장하여 프로세스 재시작 시 상태를 복원할 수 있게 합니다. 동시성 제한과 자원 제약을 설정해 여러 자식 실행을 안전하게 운영하도록 설계되어 있습니다.
자식 디스패처(Child Dispatcher): — 자식 디스패처는 FIFO 기반 스케줄링을 적용해 부모별·전체 글로벌 한도를 지키며 자식 에이전트를 실행합니다. 각 자식은 별도의 프로필·모델·컨텍스트·툴·권한·워크스페이스를 가질 수 있고 리서치·리뷰처럼 분리된 스택에서 독립 실행되며 최종 응답은 부모에게만 전달됩니다. 실행은 비차단(detached)으로 배경 작업을 계속할 수 있게 하고, 필요시 정확히 한 번만 최종 응답을 생성하도록 보장합니다.

언급된 도구

SQLite / tasks.db중립

로컬에 runs·events·checkpoints와 writer lock, 전달 상태를 저장해 체크포인팅과 이벤트 회복에 사용합니다.

Git worktree중립

편집 작업을 격리된 워크스페이스로 유지해 병렬 편집 시 충돌을 줄이는 수단으로 사용합니다.

언급된 리소스

GitHubsiddsachar/row-bot