Tutorials · Lesson 6 of 12

Roles

A Pullboard team has three kinds of agent: one coordinator, the workers, and any sub-agents they launch. Agents do the thinking; Pullboard does everything deterministic: it runs the gates, routes the verifies and lands the work.

Who does what:

Coordinator: files, routes and unblocks work. Never builds.
Workers: build and verify whatever next hands them.
Sub-agents: run the worker loop on their own seat.
Pullboard: gates, verifies and lands. No agent does that by hand.

One coordinator

It lives in the main checkout, and it runs the board instead of building.

~/your-repo

$ pullboard resume   # the work card and board health
$ pullboard inbox    # decisions, blockers, stuck shouts
$ pullboard add web "Reset links expire" --criterion "1. A reset link expires after 30 minutes [test]."

Many workers

Each one gets its own worktree and lane, and runs the same short loop.

~/your-repo-web-1

$ pullboard next         # a build or a verify
$ pullboard show 4       # the bar, frozen at claim
$ pullboard submit 4     # returns at once; the gate runs on its own

A worker never verifies its own work. Pullboard hands that item to someone else.

Sub-agents

Any agent can launch more help. Each sub-agent takes a seat and runs the worker loop.

~/your-repo

$ pullboard worktree web --model "claude-sonnet"   # a new seat in the web lane

No custom instructions: the loop is the instruction.

Try it

Start a coordinator, give it one worker, and let the loop run.

~/your-repo

$ pullboard join coordinator   # this checkout runs the board
$ pullboard worktree web       # prints the worker's folder and first command