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 AnnsaFrom written to checked, in four steps
Given a dark system, when the app opens, then it shows dark mode
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 specA 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 handoffEverything you'd expect
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.