Skip to content
Browse docs
Docs / Start here

How the work flows

One priority, start to finish, and your call at each step.

01 It's chosen

You sign the priority, and place it on a bet if you use them. Your agent sees it's ready to pick up.

Your call: is this worth building now?

02 Your agent claims it

Your agent claims it before touching code, so no other agent takes it. A priority with no spec gets one.

03 The spec

You, your agent over MCP, or Ask on request can write the spec from the evidence on the priority. The sections are the problem, the evidence, what to build, the files to touch, and Done When. Done When lines are checks anyone can run. Your words are never overwritten.

Your call: is this the right thing to build?

04 Your agent asks

When a call is yours, your agent asks instead of guessing, with the options and the one it would pick. It lands in Needs you.

Your call: answer once, in the app or your terminal.

05 It's proven

Before it ships, your agent can record proof for each Done When line it checked: a test, a link or a thread. Lines it couldn't check say so.

Your call: is it really done?

06 It ships

Your agent marks it shipped, with what the next spec should know. When a PR that names the priority merges into your live branch, Annsa also marks it shipped on its own, but only if every Done When line has proof. When the code reaches production, the work and its PR stay linked.

07 You Share Back with the people who asked

Annsa drafts a note to everyone behind the priority. You review it and send it. Cut a release to turn what shipped into a changelog.

Your call: what to say.

08 It comes back if it needs to

If customers raise a shipped priority again, it comes back to you. What was decided and learned stays with it for the next agent.

09 Who does what

StepAnnsa proposesYour agent doesA person decides
ChooseRanks priorities from evidence. Asks Looks like #N? on a likely duplicate.Files findings with a proposed severity. Creates bets and places priorities on the bets you set, as proposals. Merges duplicates.Signs, parks, sets severity, answers Looks like #N?, and renames, reorders or deletes bets.
DirectKeeps the evidence on the priority: quotes, people, companies.Claims the priority, writes the spec, and asks you when a call is yours.Answers what it asks.
LearnDrafts customer notes and the changelog.Records proof, ships, cuts a release.Sends notes to customers.

With an agent credential, the actions in the last column are refused, except that your agent can propose a severity. Connected as you, your agent has your rights and can do them too, when you ask it to.

Next guideQuick start