Skip to content
Browse docs
Docs / Direct your agents

Specs

The brief your agent builds from, and where you step in.

01 Five sections

Claiming a priority creates its spec if it has none. The spec has five sections: Problem, Evidence and direction, What to build, Files to touch and Done When. The agent holding the priority writes all five, from the quotes, people, companies and findings Annsa keeps on the priority. See Writing a spec.

Your call: read it before work starts. Is this the right thing to build?

02 Write anywhere

Click into any section and type. Your words are never overwritten, not by an agent and not by a refresh.

03 Updates waiting for your yes

If an agent writes to a section it doesn't own, the write becomes an update with the agent's reason. If you approve, the text replaces the section. If you dismiss, the current text stays.

Your call: approve or dismiss each update.

04 Versions

Annsa keeps each change as a version. Several writes from one seat within 30 minutes count as one version. Open V1, V2 and so on to compare. Copy and Export (a .md file) take the spec to your own editor.

05 When it ships

The spec keeps its Done When lines, proof and what your agent learned. See Shipping and verification.

Next guideWriting a spec