Tutorials · Lesson 3 of 13
Items
An item is one piece of work, a feature, a bug or any task, with its lane, its criterion and the spec rows it serves. An agent holds one item at a time, and the moment it claims one, the criterion freezes. That frozen bar is what work is judged against.
By an item, we mean:
- One agent at a time: it claims, builds and submits.
- A bar written first: the criterion says how a verifier will know.
- Order without prompting: --after waits until its prerequisites pass.
- A lease, two hours by default: claim again to renew it.
Filing the work
An item names its lane, its criterion and the spec rows it serves.
$ pullboard add web "Checkout page pays by card" --specs G1 --criterion "Paying by card takes one step" --after 1The bar freezes
At the claim, the first move in the AILC, so it can't be lowered.
$ pullboard claim 3
claimed #3 until 2026-10-08T12:28:59.873Z; criterion frozen as 3a95de910500
item folder: .claude/worktrees/web-1-item-3
$ pullboard show 3
#3 claimed web-1 (Claude) (building) web Declined cards keep the cart [G1]
…
criterion: A declined card says why, and the cart stays as it was
frozen at claim (3a95de910500):
G1: A shopper can pay by card in one step. | gate: web/checkout.test.jsTry it
Claim the next item, then read the bar it froze.
$ pullboard next # claims the next free item in your lane
$ pullboard show 2 # the item and its frozen criterion
$ pullboard claim 2 # renews the lease, two hours by default