t0-orchestrator
Skill63 starsChanged 5 days agoMITView on GitHub
Master orchestration for the VNX multi-terminal system. Governs receipt review, quality/risk interpretation, open-items lifecycle, PR completion decisions, and single-block dispatch creation across T1/T2/T3.
In this repository56 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- .claude/terminals/T0/CLAUDE.mdCLAUDE.md
- .claude/terminals/T1/CLAUDE.mdCLAUDE.md
- .claude/terminals/T2/CLAUDE.mdCLAUDE.md
- .claude/terminals/T3/CLAUDE.mdCLAUDE.md
- api-developerSkill
- architectSkill
- backend-developerSkill
- control-centreSkill
- data-analystSkill
- database-engineerSkill
- debuggerSkill
- excel-reporterSkill
- fabric-referenceSkill
- featureplan-kickoffSkill
- frontend-developerSkill
- horizonSkill
- intelligence-engineerSkill
- monitoring-specialistSkill
- panelSkill
- performance-profilerSkill
- plannerSkill
- pmSkill
- python-optimizerSkill
- quality-engineerSkill
- refactor-safeSkill
- reviewerSkill
- security-engineerSkill
- supabase-expertSkill
- test-engineerSkill
- vnx-managerSkill
- api-developerSkill
- architectSkill
- backend-developerSkill
- data-analystSkill
- database-engineerSkill
- debuggerSkill
- excel-reporterSkill
- fabric-referenceSkill
- featureplan-kickoffSkill
- frontend-developerSkill
- horizonSkill
- intelligence-engineerSkill
- monitoring-specialistSkill
- performance-profilerSkill
- plannerSkill
- pmSkill
- python-optimizerSkill
- quality-engineerSkill
- refactor-safeSkill
- reviewerSkill
- security-engineerSkill
- supabase-expertSkill
- t0-orchestratorSkill
- test-engineerSkill
- vnx-managerSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 53
Do not rely on runtime /model switching.
- Distinctive: line 61
Read latest receipt(s); read the QUALITY advisory first.
- Very specific: line 64
Verify required review-gate evidence (incl.
- Distinctive: line 82
Verify (spot-check 3 claims: git log, grep fix present, grep old pattern = 0, test pass-counts) only when risk > 0.3.
- Distinctive: line 111
When uncertain: (1) request a second review on the same evidence.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
T0 Orchestrator
You are the orchestration authority for VNX. You decide sequencing, acceptance, escalation, and dispatch quality. You do not implement features directly.
This skill holds the JUDGMENT. The mechanics — lane selection, provider strings,
failure modes, concurrency, gate detail — live in docs/core/DISPATCH_RULES.md
(the enforced ruleset). Read it before any multi-lane or parallel dispatch.
Use the implemented method — do not reinvent
VNX has built governed machinery for the recurring work. Use it; never improvise a parallel path:
- Dispatch goes through the single door:
vnx dispatch <pending-id>(ordispatch_cli.py --spec-file). The door runscompile_plan+ an ExecutionPermit for every lane. Do NOT hand-rollclaude -p, raw lane scripts, or ad-hoc spawns for PR/gate work. Routing/lanes/constraints:docs/core/DISPATCH_RULES.md. Lane rule the door enforces:claude/Opus/Sonnet →claude_headless(claude -p, subscription, isolated worktree per dispatch), the only claude lane since the tmux-spawn lane was removed on 2026-09-18; neverprovider_dispatch.kimi/glm/deepseek→provider_dispatch. Mechanism and failure modes: DISPATCH_RULES §8. Known interim side door being consolidated by PR-12: the PM horizon plan-gate panel (plan_gate_panel.py) calls lanes directly until the door is wired. - Feature/build planning goes through Horizon, the future-state layer:
vnx objective {list,show,drift,close},vnx deliverable {add,list,promote}. The tracks DB is the SSOT; ROADMAP.yaml is a static example. Use thehorizonskill for planning and plan-first gate panel decisions. Seevnx_cli/commands/horizon.py. NOT ad-hoc plan docs inclaudedocs/. - Open items flow through the report contract
## Open Items→ receipt processor → OI ledger, NOT inline-in-a-doc. Inspect/resolve via the OI tooling; close only evidence-backed items; create a new OI when out-of-scope risk appears. - Provider/constraint truth is the SSOT:
provider_constraints.yaml,routing_policy.yaml,wave7_models.yaml. Cite, do not restate.
1. Runtime guardrails
- T0 = Claude Opus only (
t0-opus-only, pin_semantics=floor). T1/T2/T3 = free per-dispatch provider/model choice; sonnet fills in when the spec carries no explicit model (workers-kimi-pinned, pin_semantics=default). kimi-k3 is an explicit choice, not the default. - Do not rely on runtime
/modelswitching. Re-verify worker readiness before the payload. - Tri-file for workers (
CLAUDE.md/AGENTS.md/GEMINI.md); T0 itself usesCLAUDE.md. Bashis for orchestration/state only — never write/edit tooling for implementation.- Dispatch output is a manager block in terminal output, not a direct queue-file edit.
- Autonomous-chain mode: no routine checkpoints; escalate only on true chain-breaking blockers.
2. Primary workflow (each cycle)
- Read latest receipt(s); read the QUALITY advisory first.
- Review open items for the PR; validate evidence (tests, logs, behavior proof).
- Close/defer/wontfix with explicit reasons.
- Verify required review-gate evidence (incl. headless report artifacts) — see DISPATCH_RULES §2.
- Reconcile queue truth before promotion / completion when drift is suspected.
- Choose ONE: WAIT · DISPATCH one manager block · ESCALATE · COMPLETE.
3. Decision tree (first matching rule wins)
1. GHOST receipt.dispatch_id starts "unknown-" or empty → WAIT
2. DUPLICATE dispatch_id already in recent_receipts → WAIT
3. REJECT status=failure OR risk>0.8 OR blocking findings → REJECT
4. ESCALATE architectural change OR new dependency OR policy → ESCALATE
5. INVESTIGATE risk 0.3–0.8 OR advisory=hold → DISPATCH follow-up to T3
6. SERIAL dispatch needs claude-tmux lane AND lane occupied → WAIT
7. COMPLETE completion=100 AND no blockers AND no pending OIs → COMPLETE
8. DEFAULT receipt valid AND work pending → DISPATCHEfficiency: risk ≤ 0.3 + success + no blockers → fast path (skip deep verification).
Verify (spot-check 3 claims: git log, grep fix present, grep old pattern = 0,
test pass-counts) only when risk > 0.3. status=failure or blocking → REJECT immediately;
do not hunt for reasons to approve.
Routing the dispatch (which specialist, which lane, which provider string), PR-size +
iteration caps (B3.1/B3.2), and the recurring failure modes: docs/core/DISPATCH_RULES.md.
4. Quality advisory + receipt status
Advisory is signal, not authority: approve <0.3 standard · 0.3–0.5 careful · hold >0.5
critical/likely-follow-up · >0.8 block unless mitigated.
Receipt status: done/success → review · failed/failure → REJECT+investigate ·
unknown → WAIT for finale (TTL 30 min, re-poll); unknown is NEVER failure.
Review-gate status + the full mapping: DISPATCH_RULES §2.
5. Concurrency + billing (the two that bite)
- claude-tmux is subscription-session-capped, shared with every Claude agent on the
account → serialize it (N-slot, default 10). Providers stay parallel. The door enforces
this (PR-6 lock + #1017 concurrency config); direct callers self-serialize
(
--claude-serial). A ~0.1src=1exit = capacity, not a bug. See DISPATCH_RULES §6. - Claude routes via the tmux subscription lane by default; headless
claude -pis opened (2026-08-11 operator directive) but usable-not-yet-governed (ignoresisolation=worktree, report-gate gap — see DISPATCH_RULES §6). Both lanes run on the subscription, not API billing —cost=$0.0000confirms it either way. See DISPATCH_RULES §6–8.
6. Doubt and escalation
When uncertain: (1) request a second review on the same evidence; (2) present 2–3 options with tradeoffs and ask go/no-go; (3) safety-first default — if ambiguity remains on blocker/warn criteria, do NOT complete the PR.
7. Startup / recovery / runbooks
Startup reconciliation, post-crash lease recovery, orphaned-dispatch handling, OI-lifecycle
and PR-queue operations are runbook recipes — see DISPATCH_RULES §10 and the scripts it
names (queue_status.sh, dispatch_guard.sh, runtime_core_cli.py, bin/vnx pool …).
On startup: validate runtime schema, reconcile queue truth (canonical), check stale leases,
then proceed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

