> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aosplane.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aosplane.io/_mcp/server.

# Product manager

The product manager works through a problem with you and writes the doc as you talk, grounded in the project's code, issues and docs. When it's ready, you hand it to an agent or to Linear in one step.

> **Note**
>
> Every plan includes the product manager. **PRD** needs the Starter plan or above, and **Discovery** needs Team or above. Viewers can read plans and docs but can't chat.

## Write a doc

#### Open the product manager

Choose **PM** in the narrow rail on the far left of the sidebar, then **New doc**.

#### Pick what you need

Choose the deliverable button in the composer and pick **Brief**, **Spec**, **PRD** or **Discovery**. **Spec** is the default.

#### Describe the problem

Say who is stuck and what happens today, then choose **Send**. To point at an issue or a file, choose **Mention an issue or a file**.

#### Answer its questions

It asks about the problem first, reads Linear and the code for evidence, and fills in the doc beside the chat.

#### Edit the doc

Type in the doc, or select text to format it or ask about it. Choose **Open as page** for the full editor.

![Product manager chat on the left and a finished Spec on the right with Show changes, Open as page and Build it](/_fern-files/_img/2f9bf887788a590672ed3e6f2f492324459cd1b552bde3d9ad86d768a1326f24.webp)

| Deliverable   | What you get                                                                                   | Plans             |
| ------------- | ---------------------------------------------------------------------------------------------- | ----------------- |
| **Brief**     | Problem, goal and acceptance criteria, each with a proposed check.                             | All               |
| **Spec**      | A Brief plus user paths, edge cases, affected code, linked issues and sources.                 | All               |
| **PRD**       | A Spec plus non-goals, risks, dependencies, migration and rollout, metrics and open questions. | Starter and above |
| **Discovery** | Sourced research: evidence, past decisions, how others solve it, options and a recommendation. | Team and above    |

## Hand it to engineering

#### Choose Build it

When the doc is done, choose **Build it**. (A Discovery offers **Write the Spec** instead.)

#### Choose where it goes

Pick **Linear, built by an agent**, **Linear only** or **A session now**.

#### Fill in the details

For Linear, check the issue's **Title**, **Team**, **Priority** and labels. For a session, pick the **Agent** and **AI account**. **Brief preview** shows what the engineer gets.

#### Hand off

Choose **Hand off**. You see **Handed off**, with **Open the session** or **Read the brief**.

![Hand off to engineering page with Linear only chosen under Where it goes, the Linear issue fields, the Hand off button and the Brief preview](/_fern-files/_img/a08f40dd6c5cfe24eb919a77166d559ef4ad9a89794c3a1bafdb8b6bf57c98da.webp)

## Approve a plan

A session started with **Plan first, then wait for approval** asks the product manager for a Spec and waits. Open **Plans** in the product manager (or your [Inbox](/inbox)) and choose **Approve plan**, **Request changes** or **Reject**. Once approved, the agent builds it with the Spec's acceptance criteria among its [QA checks](/qa-checks).

## Good to know

* Each reply that changes the doc counts as one spec. Questions, answers and replies that fail or are stopped don't count.
* Monthly allowance: Free 10, Starter 50, Team 200, Enterprise custom. After that, each spec costs $0.50 for a Brief, $1 for a Spec, $2 for a PRD and $4 for a Discovery. Free stops at the allowance.
* **Linear, built by an agent** needs the AOSplane agent installed in Linear, and **A session now** needs an active agent in the project. See [Linear](/linear).
* You can keep editing after a handoff. The next handoff writes a new version of the brief.
* **Specs** lists every doc. **Copy as Markdown** is in the menu beside **Build it** on the doc page.
* The Owner sets house rules and what the product manager reads in **Settings** › **Roles**, and its starting depth in **Settings** › **AI connections** › **Built-in agents**.

## Related

* [QA checks](/qa-checks)
* [Linear](/linear)
* [Start a session](/start-a-session)
* [Billing](/billing)