Working with agents

Product Brief agent

Turns a rough idea into a clear product brief through a short interview.

First, set up a host machine

Every agent runs on your own computer through the command-line tool, so set it up before you start any work here. See The command-line tool.

The Product Brief agent is usually where a workspace begins. It interviews you about your idea — who it's for, what it does, what makes it different — and writes a structured brief the later agents read for context.

This step is optional — a Foundation and an accepted Spec are all you need to build. When you do create one, what you save becomes context later agents read on their own. See Greenfield and brownfield.

What you share to start

Open the Product Brief and describe your idea in your own words (up to 1,500 characters). That short description is all the agent needs to begin; there's nothing to set up first.

Already have a product brief? You don't have to generate it — paste what you have and save it, and it goes straight to review. See Greenfield and brownfield.

How the turns work

The agent replies with a small batch of questions — single-choice, multi-choice, or free text — shown as a form right on the page. You answer, it may ask one more round to close gaps, then it writes the brief. Only you, as the person who started it, can answer; others in the workspace follow along read-only.

How a turn cycle goes

You describe it Agent asks You answer Draft Review Accept

The ask-and-answer step repeats until the agent has enough to write the draft. After the draft, sending revision notes reopens the same conversation.

Accepting the result

The finished brief lands in review. Anyone in the workspace can read it and press Accept; you or an admin can edit the text in place afterward. Once it's accepted, the Research and MVP Plan agents can build on it.

Good to know

While a run is going, only the person who started it can answer — everyone else in the workspace follows along read-only.
If a run stalls or you change your mind, you can cancel it, then restart or resume from where it left off.
Fragua lets you know when a draft is ready or a run fails, so you don't have to sit and watch it.
An admin can undo an acceptance to send a document back to review.