Agent-readable docs
mogui-ADE-orchestrator 문서
Orca ADE 위에서 장기 마스터 세션, 워커 디스패치, 승계, 라인지를 운영하는 워크스페이스 오케스트레이션 런타임의 공개 표면, 설치, CLI, 설정, 운영 절차를 정리한 기술 문서입니다. 설치·운영자, 마스터 에이전트, 기여자가 스크립트·스키마·가드 경계를 그대로 참조할 때 사용합니다.
Pages
- Overview공개 표면, Orca 런타임 전제, 마스터/워커 역할, 네트워크·API 키 없음 제약, 그리고 다음에 읽어야 할 문서 경로.
- InstallationOrca·에이전트 CLI·git·gh·python3·bd·skills 전제조건, preflight FAIL/WARN, 셸 명령 등록, 클론 후 측정 신호.
- Quickstart클론 → Orca 준비 → wake-up 온보딩 → Generation 1 부트 → 첫 supervised worker까지 최단 성공 경로와 검증 신호.
- 런타임 유닛U1–U12 책임 경계, L0/L1 컨텍스트, 부분 구현 유닛, bootstrap·dispatch·succession·lineage 모듈 대응표.
- Orca 객체 모델project·folder workspace·worktree·terminal·Run, 마스터 좌석 규칙, 검증된 selector 형식, 오해하기 쉬운 UI 라벨.
- 마스터 라이프사이클founding spawn → boot measurement → steady state → clean succession → lineage 기록 루프와 Role State·compaction 규칙.
- 증거와 수락워커 self-report와 독립 검증 구분, 계약 필드, 리뷰 렌즈, acceptance 판정 규칙과 측정 가능한 증거 형태.
- 프로그레시브 온보딩ONBOARDING 라우터, 단계 파일 1회 1로드·Verify 후 진행, Stage 1/2, founding spawn, 템플릿 치환 경계.
- Supervised dispatchcheck → dispatch → register 흐름, 계약 해시·ledger, model probe, Codex/Cursor pretrust, 완료 채널 orchestration.
- Clean successionhandoff 작성, placement 검증 spawn, successor 검증, predecessor retire, revival 측정, lineage 스키마 필드.
- 인스턴스 설정instance-runtime·model-tier-policy 작성, env 우선순위, transcript glob, master host runtime, 티어×fan-out 캡.
- Workspace descriptorsibling 저장소 인벤토리, role·capabilities·prohibited, master_seat, workspace-descriptor-check 액션과 해석 순서.
- Redaction gatesredaction-scan 범위·exit, REDACTION_REQUIRE_EXTRA, inventory 역검사, gitleaks 설정, 스테이징 전제와 pre-push 훅.
- CLI 레퍼런스scripts/ 공개 명령 표, 하위 명령 목적, 주요 옵션, --help 동기화 테스트 계약과 비공개 표면 경계.
- Configuration referenceJSON 키·기본값·필수/선택, INSTANCE_RUNTIME_CONFIG·DISPATCH_TIER_POLICY·WORKSPACE_DESCRIPTOR·MOGUI_* 환경 변수 해석 순서.
- dispatch-gate 레퍼런스check·register·watch·report 플래그, ledger 스키마, reason code, 티어 정책 해석, 티켓 TTL, 기본 문자 한도.
- master-succeed 레퍼런스detect·handoff·verify-successor·check-duplicates·retire·spawn 옵션, exit 코드, SPAWN_PLACEMENT_MISMATCH, JSON 출력.
- acceptance-loop 레퍼런스validate·split·run·inspect 하위 명령, 스위트 구조, holdout, max-iterations, baseline/restore, 판정 산출물.
- 방어 인벤토리디스패치 게이트, 모델 신원 프로브, placement·empty-seat·duplicate, redaction, revival, progressive onboarding 가드 표.
- Worker reaplease 상태 issued→reaped, settled 검증, terminal close, worktree 정리, --dry-run·--ledger, 거부 exit 코드.
- Troubleshootingpreflight BLOCKED, placement mismatch, MODEL_PROBE_FAILED, undecidable exit 2, seat 중복, revival, 복구 프로브.
- Contributing5문항 스택 기준, pytest 실행, exit 코드 규약, redaction 게이트, master-ops 템플릿 경계, 릴리스 cut·CHANGELOG.
Complete Markdown
The complete agent-readable Markdown files are published separately from this HTML page.