Why a supervised team beats an autonomous loop: a single agent in a RALF or
goal-driven loop grades its own work and defines its own “done,” so it drifts,
declares victory early, and games its own success criteria — nobody is checking.
A supervisor is an external checker: a different agent that owns the
definition of done, refuses work that games the gates, and holds the board as
the single source of truth. Add parallel lanes (many agents working at once
instead of one loop iterating) and diverse cross-review, and you get both higher
quality and higher throughput than a solo loop.
Set up the team
1
Create a group and spawn the agents
Create a group for the feature and spawn the agents that will build it.
A group keeps the team’s terminals together as one working unit.
2
Create a channel and introduce the goal
Create the team channel, add every agent, and post the goal: the validated
spec, the definition of done, and the quality bar.
3
Assign the supervisor
Name one agent supervisor. The supervisor does not take a build lane —
its job is to run the board and the gates (see below).
The supervisor’s job
The supervisor owns coordination so the builders can focus on building. It:- Owns the GitHub Projects board. It drives the board through Desk’s GitHub
Projects UI — backed by
ghand the GitHub GraphQL API (see GitHub Projects) — so the board, not the chat, is the authoritative state of the work. A workable column set: Spec approved → Worktree ready → Implementation → Tests → Review → Integration → Docs → Human review. - Enforces the gates. Definition of done, anti-gaming checks, quality bars, and any feature-specific gates. Work that games a gate (green tests that don’t test anything, a “done” card with no evidence) is bounced back.
- Keeps the work moving and un-collided. It confirms each builder has a distinct lane, unblocks stalls, and resolves overlap before two agents touch the same surface.
The builders’ job
The other agents pick their lanes and execute:- Each agent claims a lane — a distinct slice of the work with no file overlap with another lane — and takes the matching card on the board.
- Agents do the work, then report progress to the supervisor and the team in the channel, with evidence (tests, output, a driven end-to-end check), not just “done.”
- When lanes must touch the same code, they coordinate in the channel first rather than racing — one owner per contended surface.
Decide when to involve the human
Set the escalation cadence up front so the team knows when to pull you in:- Checkpoint mode — the team pauses for your review after every milestone (a card reaching done, a gate passed). Higher oversight, best for high-stakes or early-trust work.
- Autonomous mode — the team runs to the goal on its own and only surfaces you on a blocker or when the feature is complete. Higher throughput, best once the gates and the supervisor have earned trust.
What you get
- Quality that is enforced, not self-declared. An external supervisor and real gates catch the drift and gate-gaming that unsupervised loops cannot see in themselves.
- Throughput from real parallelism. Independent lanes advance at once instead of one loop iterating sequentially.
- A legible project. The board is the source of truth, so state, ownership, and progress are visible at a glance — to the agents and to you.
Next steps
- Read GitHub Projects for the board the supervisor drives.
- Read Run multiple features in one project to scale this to several features at once.
- Read Review agent work with git for verifying what the team produced.