Anvil CoderLog in

Specify first · Then implement

Spec-driven development with AI agents

The longer the chat with the coding agent, the further the result drifts from the goal, because the goal was never written down. Spec-driven development reverses the order: you describe what should exist, Spec Studio turns it into epics and stories, and every review has a yardstick to check against.

From idea to assessable work

  1. Clarify requirements

    Audience, goals, non-goals, behaviour. Spec Studio asks the questions that otherwise surface mid-sprint, and takes notes.

  2. Set the frame

    Stack, interfaces, quality rules, check commands. They become the stack profile and the guardrails that later stand in every prompt.

  3. Curate tickets

    The studio proposes epics and stories; you cut, add and decide which story runs first.

  4. Review against the spec

    Every draft PR can be measured against the specification. What you learn flows back into the spec, not into a chat transcript.

One sentence becomes a specification

Example

Invite new team members

Monday, 09:00, product sync. “We need invitations,” someone says, and everyone nods. Ten minutes in Spec Studio later, the decisions the first developer would otherwise have made alone are on the table:

The spec becomes two stories. The first one runs the same afternoon; the draft PR that evening reads sentence by sentence against the four criteria.

The specification becomes the working context

Spec Studio guides you through vision, goals and non-goals, functional requirements, stack and constraints, quality rules and epic slicing. Every section has its own follow-up chat that names gaps instead of papering over them.

At the end the studio creates real tickets in your tracker, with a freshly created repository if you want one. It writes no code; the first run starts when you drag a story.

From Spec Studio to pull request

Requirements stay your work

A specification does not make bad requirements good; it makes them visible before code exists. Contradictions and missing decisions surface in the studio, not in review.

Keep the spec current as you learn. Agents and reviewers then work against the same reference.

The method in the foundations article

Questions before your first run

Do we need a complete specification first?
No, the studio helps you develop it. For the first story, a goal, boundaries and assessable acceptance criteria are enough.
Does generating epics already start implementation?
No. The studio writes tickets, and you decide story by story which one runs.
Is this GitHub Spec Kit?
No. Spec Studio is our own entry point; the method is the same. The foundations article puts both in context.