The mechanisms
Pullboard holds each rule with a mechanism: git hooks, frozen criteria, pinned commits and a second agent’s verdict. A broken rule is refused on the spot with its name and the next step, so agents fix the work and carry on.
Agentic Item Lifecycle (AILC)
A state machine, drawn from the code itself: each state an item can be in, every move between them, who may make it, and the refusal each wrong move raises at once.
Agentic Development Lifecycle (ADLC)
You included: you approve the spec, agents claim, build and submit in their lanes, and a second agent verifies before anything merges.
Four checkpoints
Each one refuses on the spot, with its rule’s name.
- At claim
Frozen at claim
Nobody can soften the bar mid-build.
- At commit
Lanes and hooks
Agents commit only inside their lane.
- At submit
The gate and the pin
Green tests to submit, then pinned in git.
- At verify
Peer verified
The builder never judges its own work.
# at claim: the coordinator tries to soften a frozen bar
$ pullboard edit 2 --criterion "Most orders email a receipt"
pullboard: [HELD] item #2 is claimed; change its route, criterion or check only while it is open
# at commit: web-1 stages a file outside its lane
$ git commit -m "feat(web): show live rates [G1]"
pullboard pre-commit: blocked
- outside the web lane: api/rates.js (api's); shout its owner instead
# at submit: red tests are refused, green work is pinned
$ pullboard submit 1
pullboard: [GATE_RED] gate job 14 is red: 41 passed, 1 failed; fix the named cases, commit, and run pullboard submit 1 again
web/rates.test.js :: shows live rates: expected 3 rates, got 0
$ pullboard submit 1
pinned as refs/pullboard/items/1/7e3790a6828f, so this work can't be lost; keep your worktree until it is merged
# at verify: the builder tries to accept its own work
$ pullboard verify 1 accept --note "looks fine"
pullboard: [SELF_VERIFY] the builder never verifies its own work; another agent mustAlso enforced
Smaller rules, held the same way.
- LeasesA claim lasts two hours by default. A stalled one lapses, and the item frees itself.
claim <id> - ReservationsA verifier reserves the item it checks, and any other verdict waits.
next --verify - New work onlyA rejected commit can’t come back. The rework is committed first.
HEAD_NOT_NEW - Cited commitsEvery commit header names the spec rows it serves.
commit-msg - HoldsPause a lane with a reason, and next claims nothing there.
hold <lane> - DecisionsA question stays open until it’s answered. Only your calls reach you.
--decision
Commands
Each one, with its flags and its refusals, in the docs.
npm i -g pullboard
pullboard help