Skip to content

Done When

Know when your agent's work is really done.

Every spec ends with Done When lines. Your agent checks each one and leaves a receipt: a test, a URL or a thread you can follow. A line it couldn't check is labeled on the spec.

Try Annsa
Priorities
Improve retention
1Add dark modeShipped · 2 of 3 lines verified
2Fix mobile checkoutBuilding · Cursor
3Dark mode chartsOpen
#12 Add dark mode2 of 3 verified
✓Dark mode follows the system settingVerified on staging · open link
✓Every screen passes contrast checksVerified by a test
!Charts stay readable in dark modeNot checked. The agent says so here.

From written to checked, in four steps

Given a dark system,
when the app opens,
then it shows dark mode
1Write each line to be checkedA state, an act, and something you can check.Done When
Claude CodeChecking line 1 of 3
2The agent checks each lineEach line gets its own check.Verify
Verified on stagingOpen link
3It leaves a receiptA test, a URL or a thread you can follow.Receipts
1 line not checkedSaid on the spec
4You see what wasn't checkedWhat that means is your call.Your call

Each line is checked on its own

Write what done means before the work starts. Each line says: given a state, when an act, then something you can check. Whoever holds the job writes it, you or your agent.

Learn about the spec
Done when · line 1 of 3
Giventhe system is set to dark
Whenthe app opens
Thenit shows the dark theme
Two more lines below it, each checked on its own.

A receipt for every line

Your agent records how it checked each line: a test, staging, production or by hand. A line it couldn't check is labeled on the spec, so you decide: fine for now, or worth doing before you tell anyone.

Learn about handoff
#12 Add dark mode2 of 3 verified
✓Dark mode follows the system settingVerified on staging · open link
✓Every screen passes contrast checksVerified by a test
!Charts stay readable in dark modeNot checked. The agent says so here.
Merged→Live for customersYou released it

Everything you'd expect

Given, When, ThenEach line reads as a check you can run.
A receipt per lineSaved with annsa.work verify.
Test, staging, production or by handEach receipt says which.
Unchecked lines are labeledThe spec says what the agent couldn't check.
Merged is not liveA priority shows when it merged and when it is live.
Annsa never deploysYou release to production.

Questions people ask.

What is a Done When line?

One line at the end of a spec in the form: given a state, when an act, then something you can check. Whoever holds the job writes it, you or your agent.

What is a receipt?

A record of how one line was checked, saved with annsa.work verify. It says whether the check was a test, on staging, in production or done by hand.

Does an unchecked line stop a ship?

Not when an agent marks it shipped: it says which line it couldn't check, and what that means is your call. A merged pull request ships it on its own only when it reaches your live branch and every Done When line has a receipt.

Does a merged PR mean it is live?

No. Annsa never deploys. A merged pull request that names the priority marks it shipped once it reaches your live branch and every Done When line has a receipt, and deploying stays yours.

The source of direction for agent teams.

Begin with one agent and the work that matters next.