Skip to navigation
AI teammates

Product manager

Turn a request into a Brief, Spec, PRD or Discovery, then hand it to engineering
View as Markdown

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.

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

1

Open the product manager

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

Pick what you need

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

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.
4

Answer its questions

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

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
A chat with the product manager, with the doc beside it
DeliverableWhat you getPlans
BriefProblem, goal and acceptance criteria, each with a proposed check.All
SpecA Brief plus user paths, edge cases, affected code, linked issues and sources.All
PRDA Spec plus non-goals, risks, dependencies, migration and rollout, metrics and open questions.Starter and above
DiscoverySourced research: evidence, past decisions, how others solve it, options and a recommendation.Team and above

Hand it to engineering

1

Choose Build it

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

Choose where it goes

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

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.
4

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
Hand off to engineering

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) and choose Approve plan, Request changes or Reject. Once approved, the agent builds it with the Spec’s acceptance criteria among its 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.50foraBrief,0.50 for a Brief, 1 for a Spec, 2foraPRDand2 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.
  • 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.