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:

Filing the work

An item names its lane, its criterion and the spec rows it serves.

~/your-repo
$ pullboard add web "Checkout page pays by card" --specs G1 --criterion "Paying by card takes one step" --after 1

The bar freezes

At the claim, the first move in the AILC, so it can't be lowered.

~/storefront-web-1
$ 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.js

Try it

Claim the next item, then read the bar it froze.

~/your-repo-web-1
$ 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