Working with agents

Brand Guide agent

Defines colors, type, and voice — even on an empty workspace.

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 Brand Guide agent writes a visual identity and voice: a color palette, typography, tone-of-voice principles, and a sample CSS block. It's the most independent of the planning agents — it can run before anything else exists. On an existing codebase with a clear design system, Foundation also drafts this for you automatically from the code.

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

Describe the feel you're after (up to 1,500 characters) and add any notes. There's no prerequisite: the agent uses your brief and plan when they exist and works from your description alone when they don't.

Already have a brand guide? 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 asks a round or two of questions on the page, then writes the guide. You drive it; the workspace watches 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 guide lands in review for the workspace to accept, and stays editable by you or an admin afterward.

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.