프로젝트 소개

Repo Agent Orchestration은 멀티 에이전트 저장소 전달 컨벤션을 중앙 서비스가 아닌 저장소 내부에 유지하는 비공식 커뮤니티 Codex Skill(MIT 라이선스)입니다. 이 프로젝트의 목표는 명확한 소유권, 비례적 검증 및 복구 가능한 핸드오프를 통해 적절한 컨텍스트에서 저장소 작업을 완료하는 것입니다. 프로젝트는 어떠한 권한도 부여하지 않으며, 제품 기능을 잠금 해제하지 않고, 독점적인 오케스트레이션 시스템을 재현하지 않는다고 명시하고 있습니다. 문서에서는 세 가지 소유권 모드(direct, delivery, architected)를 대화의 고정된 횟수가 아닌 의사결정 소유자에 대한 설명으로 정의합니다. 가이드라인에는 분리 가능한 작업의 위임, 변경되지 않은 상태를 폴링하는 대신 종속성이 준비된 작업을 계속 진행하는 방법, 구현과 검토 판단을 독립적으로 유지하는 방법, 실제 Git ID 및 배타적 경로를 검증하는 방법 등이 포함됩니다. 내부 작성자(Internal writers)는 소유자의 트리를 서로 다른 범위로 공유하는 것으로 설명되며, 독립적으로 실행되는 App 작성자는 등록된 저장소 로컬 worktree를 별도로 사용합니다. 독립적인 디자인 검토는 사용자 또는 저장소 요구사항에 의해 명시적으로 요청되거나, 중대한 교차 영향 또는 되돌릴 수 없는 리스크가 있는 경우에 필수적으로 요구됩니다. 설치는 소스 체크아웃에서 scripts/install_repository.py를 저장소 경로로 지정하여 수행합니다. 이 스크립트는 Skill을 .agents/skills/repo-agent-orchestration에 복사하고, 저장소 루트의 AGENTS.md에 표시된 블록을 멱등적으로 업데이트하며, 해당 블록 외부의 규칙은 보존합니다. --dry-run 플래그는 쓰기 작업을 미리 보여주며, --check는 대상을 수정하지 않고 설치된 파일이나 프로필의 드리프트를 감지합니다. 설치 프로그램은 메인 브랜치, worktree 루트, 브랜치 접두사, 루트 worktree 정책, 작업 호스트 정책, 컨트롤러 모델 정책, 역할별 모델 설정, 공유 통합 경로, 연속성 정책 및 외부 게이트를 포함하는 옵션을 수용합니다. 모델 기본값은 app_default이며, 이는 모델 및 사고(thinking) 오버라이드를 생략합니다. 업그레이드는 기존의 명시적 바인딩을 보존하되, app_default로 마이그레이션되는 일부 폐지된 설치 프로그램 기본값은 제외됩니다. 선택적 구조화 어댑터는 호스트가 저장된 프로젝트(saved-project) 로컬 경로를 지원하는 경우 명시적으로 요청된 App 작업을 지원합니다. 어댑터의 생성자와 검증기는 binding, write, review, update, design_handoff, delivery_update, design_reopen, design_decision의 8가지 패킷 종류를 처리하며 스키마를 공유합니다. 문서에 따르면 어댑터는 경로 포함 여부, 저장된 프로젝트 ID, 현재 Git 브랜치 및 커밋, 읽기 전용 검토 및 보존된 보고서 설정을 확인하지만, 작업 권한, 실제 전달, 검토 품질 또는 수락 여부를 증명하지는 않으며, 보고서의 DELIVERY 필드는 영수증이 아닌 의도된 경로임을 명시합니다. 검증은 Python 표준 라이브러리의 unittest 검색, 예제 검증기 및 로컬 데모에 의존하며, CI는 Python 3.11 및 3.13을 대상으로 합니다. 설치 프로그램 및 worktree 테스트에는 Git이 필요합니다. 데모는 임시 Git 저장소와 격리된 작성자 트리를 생성하여 로컬 Git 및 계약 확인만 증명하며, App 생성, 메시지 전달, 유효한 모델 또는 실제 에이전트 동작을 증명하지는 않습니다. 문자열 단언(assertion)으로 증명할 수 없는 사례들에 대해서는 행동 사례(behavioral cases)가 연습용으로 제공됩니다. 정리 가이드라인은 소유한 모든 worktree와 브랜치에 대해 명시적인 결정이 필요하며, Git의 worktree 흐름을 통해 검증된 깨끗한 상태, 통합된 상태 또는 명시적으로 포기된 잔여물만 제거하고, 안전하지 않거나 유용한 잔여물은 정확한 좌표와 함께 유지하도록 합니다. 기간 기반 정리, 복구 가능한 작업의 강제 삭제, 원격 브랜치 삭제, 백그라운드 데몬 또는 자동 권한 상승은 포함되지 않습니다. 레이아웃은 설치 가능한 Skill, 설치 프로그램, 예제 검증기, 로컬 데모, 행동 입력값, 선택적 데스크톱 런북 및 결정론적 테스트로 구분됩니다.