Sigao
A crisp cyan holographic blueprint hovering over a drafting table in a sunlit studio.
All posts
Cadence·3 min read

Why spec-driven AI development beats vibe coding

AI agents are unforgiving readers of ambiguous requirements. The teams winning with AI write specs first, ship second.

By Carter Musick

The first year of agentic coding produced a generation of developers who type a prompt, accept what comes back, and call it shipped. It works fine until the work gets serious. Once the code touches money, customers, or compliance, vibe-coding produces the same thing it always has: a tower of plausible-looking work that nobody can defend.

The failure mode has data now

If vibe coding worked, the numbers would show it. They show the opposite. In a 2025 randomized controlled trial by METR, experienced open-source developers using early-2025 AI tools took 19% longer to complete real tasks from their own repositories while estimating, even after finishing, that the AI had sped them up by about 20%. And GitClear's analysis of 153 million changed lines found code churn, where lines are reverted or reworked within two weeks of being written, on track to double against the pre-AI baseline, with copy-paste rising and refactoring falling.

Neither study is an argument against AI coding. Both are measurements of what happens when generation gets faster while intent and verification stay informal. The METR developers weren't slowed down by the model's typing; they were slowed down by reviewing, correcting, and re-prompting output that didn't match what they actually needed. That is precisely the cost a spec pays down in advance. And churned code is, almost by definition, code that shipped before anyone wrote down what done meant.

What spec-driven actually means

A spec doesn't have to be a 30-page PRD. At minimum it's three things written down:

  • The user-visible behavior you're trying to produce
  • The constraints the change must respect, like security, performance, data, and compatibility
  • A definition of done that lets a second person verify the work without re-deriving the intent

Write those three things and the work holds up to review, whether it came from an AI agent, a junior engineer, or you in six months.

Here's the whole loop in one picture: the spec sits in the middle, and everything else reads from it or writes back to it:

  1. Nº 01

    Intent

    The value the product must create: the brief, the goals, the constraints.

  2. Nº 02

    The spec

    Living, machine-readable, in source control. Behavior, constraints, and definition of done become the system of record.

  3. Nº 03

    Build

    EngineersAI agents

    Both build from the same spec, with no retelling and no drift.

  4. Nº 04

    Quality gates

    Tests, evals, and review verify the work against the spec, not against memory.

  5. Nº 05

    Ship

    A production increment traceable back to the intent it came from.

What ships feeds back: learnings update the spec, not just the code, so the system of record never goes stale.

The spec-driven loop, as we run it in Cadence: one living spec that engineers and agents both build from, gates that verify against it, and learnings that flow back into it.

Why it matters more with AI in the loop

People fill in ambiguity from context. Agents fill it in from training data. That difference is load-bearing. If the spec doesn't say "all timestamps are UTC and we never trust the client clock," the agent will guess. Sometimes its guess matches yours. Sometimes it doesn't, and you find the bug in production three sprints later.

Spec-driven development is how you stop relying on lucky guesses.

It also changes what review is for. When the intent is written down, a reviewer, whether human or automated, checks the work against the spec instead of re-deriving the requirements from the diff. That's the difference between review as verification and review as archaeology, and at agent volume, archaeology doesn't scale. The teams drowning in AI-generated pull requests aren't drowning in code; they're drowning in unstated intent.

The Sigao take

We built Cadence on this. A spec is what makes speed safe, so a team serious about agentic development invests in writing specs the way it once invested in CI. The payoff lands exactly where the studies say the cost lives: less churn, less re-prompting, and review that verifies instead of excavates.

Sources