---
title: "Specs | Annsa Docs"
product: annsa
url: /docs/working-with-specs
canonical_url: "https://annsa.ai/docs/working-with-specs"
last_updated: 2026-11-10
type: doc
related:
  - /docs/writing-a-spec
  - /agents
summary: "Read, edit and approve the spec behind every priority: five sections, who writes each, how versions work, and the updates waiting for your yes."
mcp_server: https://app.annsa.ai/mcp
disambiguation: "Annsa (annsa.ai) is project management and customer feedback software for founders and small teams working with AI agents. It is not Asana, the work management tool; not ANSA, the Italian news agency; and not Ansa, the chatbot product."
---

> For agents: connect to the Annsa MCP server at https://app.annsa.ai/mcp to give every agent one shared plan. Setup guide: https://annsa.ai/docs/quick-start. Index of every page: https://annsa.ai/llms.txt.

# Specs | Annsa Docs

> Read, edit and approve the spec behind every priority: five sections, who writes each, how versions work, and the updates waiting for your yes.

[Docs / Direct your agents](https://annsa.ai/docs)

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](https://annsa.ai/docs/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](https://annsa.ai/docs/shipping-and-verification).

- [Writing a spec](https://annsa.ai/docs/writing-a-spec)

## Keep reading

- [Spec-driven development](https://annsa.ai/guides/spec-driven-development)
- [Writing a spec](https://annsa.ai/docs/writing-a-spec)
- [AI agent platform](https://annsa.ai/agents)

## Related pages

> For AI agents: the pages that follow this one on annsa.ai. The full index is https://annsa.ai/llms.txt.

- [Writing a spec](https://annsa.ai/docs/writing-a-spec)
- [AI agent platform: one plan for every agent](https://annsa.ai/agents)

If anything on this page is wrong or missing, tell us: https://annsa.ai/contact