# mogui-ADE-orchestrator 문서

> Orca ADE 위에서 장기 마스터 세션, 워커 디스패치, 승계, 라인지를 운영하는 워크스페이스 오케스트레이션 런타임의 공개 표면, 설치, CLI, 설정, 운영 절차를 정리한 기술 문서입니다. 설치·운영자, 마스터 에이전트, 기여자가 스크립트·스키마·가드 경계를 그대로 참조할 때 사용합니다.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac)

## Repository

- Repository: local/mogui-ADE-orchestrator

- Generated: 2026-08-07T07:09:27.222Z
- Updated: 2026-08-07T08:06:25.549Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 22

## Pages

- [Overview](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/01-overview.md): 공개 표면, Orca 런타임 전제, 마스터/워커 역할, 네트워크·API 키 없음 제약, 그리고 다음에 읽어야 할 문서 경로.
- [Installation](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/02-installation.md): Orca·에이전트 CLI·git·gh·python3·bd·skills 전제조건, preflight FAIL/WARN, 셸 명령 등록, 클론 후 측정 신호.
- [Quickstart](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/03-quickstart.md): 클론 → Orca 준비 → wake-up 온보딩 → Generation 1 부트 → 첫 supervised worker까지 최단 성공 경로와 검증 신호.
- [런타임 유닛](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/04-page-4.md): U1–U12 책임 경계, L0/L1 컨텍스트, 부분 구현 유닛, bootstrap·dispatch·succession·lineage 모듈 대응표.
- [Orca 객체 모델](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/05-orca.md): project·folder workspace·worktree·terminal·Run, 마스터 좌석 규칙, 검증된 selector 형식, 오해하기 쉬운 UI 라벨.
- [마스터 라이프사이클](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/06-page-6.md): founding spawn → boot measurement → steady state → clean succession → lineage 기록 루프와 Role State·compaction 규칙.
- [증거와 수락](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/07-page-7.md): 워커 self-report와 독립 검증 구분, 계약 필드, 리뷰 렌즈, acceptance 판정 규칙과 측정 가능한 증거 형태.
- [프로그레시브 온보딩](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/08-page-8.md): ONBOARDING 라우터, 단계 파일 1회 1로드·Verify 후 진행, Stage 1/2, founding spawn, 템플릿 치환 경계.
- [Supervised dispatch](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/09-supervised-dispatch.md): check → dispatch → register 흐름, 계약 해시·ledger, model probe, Codex/Cursor pretrust, 완료 채널 orchestration.
- [Clean succession](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/10-clean-succession.md): handoff 작성, placement 검증 spawn, successor 검증, predecessor retire, revival 측정, lineage 스키마 필드.
- [인스턴스 설정](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/11-page-11.md): instance-runtime·model-tier-policy 작성, env 우선순위, transcript glob, master host runtime, 티어×fan-out 캡.
- [Workspace descriptor](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/12-workspace-descriptor.md): sibling 저장소 인벤토리, role·capabilities·prohibited, master_seat, workspace-descriptor-check 액션과 해석 순서.
- [Redaction gates](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/13-redaction-gates.md): redaction-scan 범위·exit, REDACTION_REQUIRE_EXTRA, inventory 역검사, gitleaks 설정, 스테이징 전제와 pre-push 훅.
- [CLI 레퍼런스](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/14-cli.md): scripts/ 공개 명령 표, 하위 명령 목적, 주요 옵션, --help 동기화 테스트 계약과 비공개 표면 경계.
- [Configuration reference](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/15-configuration-reference.md): JSON 키·기본값·필수/선택, INSTANCE_RUNTIME_CONFIG·DISPATCH_TIER_POLICY·WORKSPACE_DESCRIPTOR·MOGUI_* 환경 변수 해석 순서.
- [dispatch-gate 레퍼런스](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/16-dispatch-gate.md): check·register·watch·report 플래그, ledger 스키마, reason code, 티어 정책 해석, 티켓 TTL, 기본 문자 한도.
- [master-succeed 레퍼런스](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/17-master-succeed.md): detect·handoff·verify-successor·check-duplicates·retire·spawn 옵션, exit 코드, SPAWN_PLACEMENT_MISMATCH, JSON 출력.
- [acceptance-loop 레퍼런스](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/18-acceptance-loop.md): validate·split·run·inspect 하위 명령, 스위트 구조, holdout, max-iterations, baseline/restore, 판정 산출물.
- [방어 인벤토리](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/19-page-19.md): 디스패치 게이트, 모델 신원 프로브, placement·empty-seat·duplicate, redaction, revival, progressive onboarding 가드 표.
- [Worker reap](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/20-worker-reap.md): lease 상태 issued→reaped, settled 검증, terminal close, worktree 정리, --dry-run·--ledger, 거부 exit 코드.
- [Troubleshooting](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/21-troubleshooting.md): preflight BLOCKED, placement mismatch, MODEL_PROBE_FAILED, undecidable exit 2, seat 중복, revival, 복구 프로브.
- [Contributing](https://grok-wiki.com/public/docs/local-mogui-ade-orchestrator-97afe791d5ac/pages/22-contributing.md): 5문항 스택 기준, pytest 실행, exit 코드 규약, redaction 게이트, master-ops 템플릿 경계, 릴리스 cut·CHANGELOG.

## Source Files

- `.github/workflows/gates.yml`
- `AGENTS.md`
- `CHANGELOG.md`
- `config/gitleaks.toml`
- `config/instance-runtime.example.json`
- `config/model-tier-policy.example.json`
- `config/workspace-descriptor.example.json`
- `CONTRIBUTING.md`
- `docs/internal/release-runbook.md`
- `docs/internal/tooling/redaction-scan.md`
- `docs/public/concepts.md`
- `docs/public/defense-inventory.md`
- `docs/public/delegation-and-review.md`
- `docs/public/getting-started.md`
- `docs/public/master-lifecycle.md`
- `docs/public/orca-concepts.md`
- `docs/public/overview.md`
- `docs/public/reference.md`
- `docs/README.md`
- `docs/runbooks/worker-reap.md`
- `hooks/pre-push`
- `INSTALL-PROMPT.txt`
- `master-ops/docs/charter/04-worker-routing-review.md`
- `master-ops/docs/charter/05-dispatch-gate.md`
- `master-ops/docs/charter/06-succession.md`
- `master-ops/docs/MASTER-OPERATIONS.md`
- `master-ops/docs/runbooks/contract-conventions.md`
- `master-ops/docs/runbooks/error-and-logging.md`
- `master-ops/docs/runbooks/role-state.md`
- `master-ops/docs/runbooks/succession-boot-card.md`
- `master-ops/MANIFEST.json`
- `master-ops/model-tier-policy.json`
- `master-ops/ONBOARDING.md`
- `master-ops/onboarding/00-orientation.md`
- `master-ops/onboarding/01-preflight.md`
- `master-ops/onboarding/02-workspace-facts.md`
- `master-ops/onboarding/04-seat.md`
- `master-ops/onboarding/09-spawn.md`
- `master-ops/onboarding/10-card-and-retire.md`
- `master-ops/scripts/dispatch`
- `README.md`
- `scripts/acceptance-loop`
- `scripts/adapter`
- `scripts/codex-worker-pretrust`
- `scripts/cursor-worker-pretrust`
- `scripts/dispatch-gate`
- `scripts/generate-manifest`
- `scripts/l1-digest`
- `scripts/master-bootstrap`
- `scripts/master-bootstrap-live`
- `scripts/master-recover`
- `scripts/master-succeed`
- `scripts/model-drift-audit`
- `scripts/model-identity-probe`
- `scripts/next-version`
- `scripts/onboarding-preflight.sh`
- `scripts/redaction-allowlist.txt`
- `scripts/redaction-inventory`
- `scripts/redaction-scan.sh`
- `scripts/worker-reap`
- `scripts/workspace-descriptor-check`
- `SECURITY.md`
- `src/master_runtime/core/__init__.py`
- `src/master_runtime/core/acceptance/casebook.py`
- `src/master_runtime/core/acceptance/config.py`
- `src/master_runtime/core/acceptance/loop.py`
- `src/master_runtime/core/acceptance/verdict.py`
- `src/master_runtime/core/adapter/doctor.py`
- `src/master_runtime/core/approval/gates.py`
- `src/master_runtime/core/bootstrap_live.py`
- `src/master_runtime/core/bootstrap.py`
- `src/master_runtime/core/context/resolver.py`
- `src/master_runtime/core/dispatch_gate.py`
- `src/master_runtime/core/instance_runtime_config.py`
- `src/master_runtime/core/lineage.py`
- `src/master_runtime/core/recovery.py`
- `src/master_runtime/core/succession.py`
- `src/master_runtime/core/work_ledger.py`
- `src/master_runtime/core/worker_reap.py`
- `src/master_runtime/core/workspace_descriptor.py`
- `tests/conftest.py`
- `tests/test_acceptance_loop.py`
- `tests/test_dispatch_gate.py`
- `tests/test_documented_reason_codes.py`
- `tests/test_instance_runtime_config.py`
- `tests/test_onboarding_preflight.py`
- `tests/test_onboarding_structure.py`
- `tests/test_recovery.py`
- `tests/test_redaction_scan_native_script.py`
- `tests/test_reference_command_table.py`
- `tests/test_succession.py`
- `tests/test_worker_reap.py`
- `tests/test_workspace_descriptor.py`