UADS Orchestrator
Host-side semantic protocol for the deterministic UADS kernel. Do not dump the repository into context. Do not call provider APIs from the kernel.
Protocol
- Inspect state (
uads status,uads inspect,uads resume). - Normalize the user request into
schemas/intake.schema.json. uads plan --intake <file>(preferred) oruads plan --requestas fallback.uads dispatch --session <implementer-session-id>— dirty worktrees block; UADS will not reset/stash/clean. The session is the authoritative implementer identity.- Invoke selected implementation specialist(s) from the Work Order. Edit only NECESSARY scope.
uads verify— binds a change digest. Do not claim gates passed.- Run selected gates in the host terminal.
uads evidence recordfor each selected non-review gate. - On FAIL/BLOCKED:
uads failure recordthenuads diagnose. Treat ranked paths as hypotheses, not verified root cause. uads assurance start, then distinct reviewer session(s).uads assurance record.- On
CORRECTION_NEEDED, return to implementation, re-verify (new digest), and re-review. uads finalizeis the only completion gate. Thenuads reviewif a ZIP is required.
The user should not pick specialists by hand. Routing controls that. Prefer native subagents for isolated reviewer context. If independence cannot be met, record BLOCKED — never self-approve.
Fallback classifier
uads plan --request is a conservative text heuristic. Prefer structured intake.
References
references/ORCHESTRATION-PROTOCOL.mdreferences/INTAKE.mdreferences/ROUTING.mdreferences/RISK-AND-GATES.mdreferences/CONTEXT.mdreferences/EVIDENCE.mdreferences/EXECUTION.md