Spec agent
Shapes one feature into a spec the Execution agent can build.
The Spec agent shapes a single feature into a written specification. It reads your codebase read-only and the context you give it, interviews you about the feature, and writes a spec — requirements, what's out of scope, schema and test notes. It never writes application code; that's Execution's job.
Specs run against your working copy, so the workspace needs a ready Foundation first. See Foundation.
What you share to start
Give the feature a title and describe it (up to 10,000 characters). Nothing is sent to Fragua while you compose — you can edit the request freely, then press Start shaping when you're ready. Along the way you can add supporting context:
-
The request — your title and description of the feature.
-
Attachments — up to 20 files, 10 MB each — PDFs, Markdown, text, HTML, or images. The same limit applies to any files you add later when continuing a build.
-
Knowledge Base documents — optionally pick existing workspace files to stage as reference.
-
Your planning docs — the brief, research, plan, and guides are included automatically when they exist.
How the turns work
Shaping opens with a confirmation question, then a round or two of clarifying questions on the page. When the agent has enough, it writes the spec and puts it in review. You drive the conversation; the rest of the workspace follows read-only.
Not quite right? Send revision notes while it's in review and the agent reworks the spec in the same session — the Accept button waits until the revision is done.
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
Anyone in the workspace can Accept the spec; you or an admin can edit it in place afterward. After a build you can also Start over, which clears the previous attempt and reshapes from a fresh description.
The full lifecycle
You compose a draft, shape it with the agent, and accept it. Execution then builds it and opens a pull request; you merge and mark it shipped. You can revise before accepting, or start over after a build.
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 accepted spec is picked up and implemented automatically.