Agent-readable docs
Mogui ADE Orchestrator 문서
Mogui ADE Orchestrator와 master-ops 운영 템플릿이 제공하는 Orca 기반 마스터 세션, 작업자 위임, 승계, 게이트, 설정, 검증 표면을 다루는 기술 문서입니다. 런타임 구현 저장소와 설치 후 운영 저장소의 관계를 함께 설명합니다.
Pages
- 개요워크스페이스 오케스트레이터가 노출하는 공개 진입점, 두 저장소의 역할, 가장 짧은 성공 경로, 주요 문서 라우트를 정리합니다.
- 설치Orca, agent CLI, git, gh, python3, bd, redaction rules, 선택 skill stack을 설치 전 측정하는 경로와 실패 신호를 설명합니다.
- Quickstart저장소 clone, Orca 프로젝트 등록, 에이전트 시작, wake-up 문장, 첫 작은 작업까지의 최소 실행 경로를 문서화합니다.
- 온보딩 모드Founding, Reverify, Upgrade, Template improve 모드의 진입 조건, 금지된 spawn 경로, 단계별 파일 라우팅을 설명합니다.
- 워크스페이스와 제품 저장소 관계오케스트레이터 저장소, 설치 후 생성되는 ops 저장소, 제품 저장소, sibling checkout 모델, 단일 저장소 예외를 구분합니다.
- Orca 객체 모델Project, workspace, worktree, terminal, Run, selector 형식, folder workspace의 정상 라벨과 misplacement 실패 조건을 설명합니다.
- 런타임 유닛Bootstrap, Context Resolver, Workspace Runtime, Worker Scheduler, Approval Manager, Recovery, Succession, Lineage, Adapter Layer의 구현 상태와 경계를 정리합니다.
- 증거 라벨Configured, Intended, Observed, Unknown 라벨과 테스트, 로그, ledger, self-report의 증거 강도를 운영 문서 규칙으로 정리합니다.
- 워크스페이스 Foundingworkspace root 선택, ops 저장소 생성, seat 기록, placeholder 치환, tracker 연결, Gen-1 spawn, boot smoke 검증 절차를 다룹니다.
- 작업자 위임contract 파일, `dispatch-gate check`, Orca task-create와 dispatch, register probe, completion channel, acceptance 전 재검증 흐름을 설명합니다.
- 마스터 승계trigger 감지, role freeze, thin handoff, successor verify, predecessor retirement, lineage append, revival check의 실행 순서를 설명합니다.
- Acceptance loop 실행acceptance suite 구조, train과 holdout 분리, proposer runtime, 반복 실행, scorecard, regression log를 다룹니다.
- 작업자 정리settled dispatch 확인, terminal close, worktree clean과 merge 포함 여부 검사, dry-run, reap ledger 기록을 설명합니다.
- 방어 인벤토리dispatch gate, ledgered decisions, model verification, placement, duplicate master, redaction, revival, progressive onboarding guard를 표로 정리합니다.
- 모델 식별과 drift 감사`model-identity-probe`, `model-drift-audit`, transcript glob 해석, expected model, undecidable 상태와 register-time 검증을 설명합니다.
- Redaction 게이트`redaction-scan.sh`, `redaction-inventory`, 조직 규칙 파일, commit message scan, pre-push hook, release gate의 범위와 exit code를 정리합니다.
- 문제 해결preflight BLOCKED, Orca CLI 미등록, misplacement, duplicate master, Unavailable worktree, model probe undecidable, redaction cannot decide를 증상별로 다룹니다.
- CLI 참조공개 `scripts/` 명령, subcommand, 주요 option, exit code 차이, 문서 표와 실제 실행 파일 surface를 검증하는 테스트를 정리합니다.
- 설정 참조`instance-runtime.json`, `workspace-descriptor.json`, `model-tier-policy.json`, 환경 변수 override, schema field, default, fail-closed 동작을 정리합니다.
- master-ops 템플릿 참조템플릿 manifest, template version, placeholder, workspace card, charter, runbook, hook, upgrade와 template-check surface를 정리합니다.
- 기여와 릴리스stdlib-only runtime, pytest gate, redaction scan, pre-push hook, version 산출, changelog, tag owner approval, Conventional Commits를 설명합니다.
Complete Markdown
The complete agent-readable Markdown files are published separately from this HTML page.