Codex Orchestration Skills · field note

I cut the system back to two skills.

I had built a fairly elaborate delivery system around named roles, hooks, state, and handoffs. I am now trying a much smaller surface: one skill for working as a team and one for the moments when repository delivery really needs formal custody.

In-progress v2 experiment
Observed July 25, 2026 github.com/dylanmccavitt/skills ↗

The shape changed

The old system encoded the workflow as a cast of constrained roles. The new experiment keeps the useful boundaries, but asks two broader skills to activate only when the work earns them.

Previous package

Named orchestration roles

gepetto painter vigil checkpoint orchestrate

A voice-directed runtime, registry, hooks, capabilities, transitions, and role-specific contracts carried work through the delivery graph.

Current experiment

Two skills, loaded when useful

teamwork governed-delivery

Codex handles ordinary work directly. Coordination and formal delivery become explicit, progressive-disclosure layers rather than the default shape of every task.

What the two skills do

This is less about removing safety than deciding where the safety belongs.

01 / teamwork

Coordinate only when parallelism helps

Teamwork gives the coordinator a small set of rules for bounded, non-overlapping agent lanes while keeping one person responsible for synthesis and approval gates.

  • Delegate genuinely independent work
  • Give every lane clear ownership and non-goals
  • Keep reviewers read-only and writers separate
  • Return one coherent outcome
02 / governed-delivery

Add custody when the external action matters

Governed Delivery is the narrower gate for tracked repository work: issue, branch, worktree, pull request, exact-head review, merge, deploy, migration, and post-delivery proof.

  • One independently reviewable leaf
  • One writer with explicit custody
  • Evidence bound to the exact current head
  • External effects stay approval-scoped

The working rule: do ordinary work directly; use Teamwork when multiple agents will materially help; use Governed Delivery when tracked custody, independent review, or an external delivery gate is actually required.

What I am trying to learn

The point of this pass is not to prove that two is the perfect number. It is to see whether a smaller instruction surface gives the agents more room to do good work without losing the boundaries I care about.

Context

Do fewer always-available roles and runtime rules reduce hidden instruction noise?

Proportionality

Can ordinary work stay light while risky delivery still gets a real custody trail?

Predictability

Is it easier to understand why Codex delegated, reviewed, paused, or asked for authority?

Maintenance

Can the durable invariants be tested without maintaining a full orchestration runtime?

Evidence boundary

live branch
issue-41…
base f853648

This visual reflects the current working tree on the issue-41-release-teamwork-govern-evals branch. The package manifest proposes v2.0.0 and the new README describes the two-skill model, but these changes are still uncommitted in the inspected checkout. The canonical remote main remains the released v1.0.0 state. This is a field note about what I am trying, not a claim that v2 has shipped.

I am testing whether the smallest setup that preserves the important gates is also the one that makes the work feel the most legible.