Skip to main content

AI glossary Strategy & Business

What is spec-driven development (SDD)?

Spec-Driven Development (SDD)

← All glossary terms
In short

A way of building software in which an explicit, reviewable specification is written first and code, tests and docs are derived from it.

Explained

Spec-driven development (SDD) treats the specification as the source of truth: requirements, acceptance criteria, API contracts and event schemas are written and reviewed before the code. Teams then generate or write stubs, tests and documentation from the spec, which reduces drift between what was agreed and what was built. With AI coding agents the idea has gained weight, because a precise spec gives the model a bounded contract to work to instead of a vague request. The spec is a living document that is updated as understanding improves, and the code follows it.

How it works

A typical spec-driven flow moves through phases, and each one is checked before the next starts:

  • Specify: describe what is being built and why, for whom and with which acceptance criteria.
  • Plan: turn the spec into a technical plan with architecture, contracts and constraints.
  • Break down: split the plan into small, testable tasks.
  • Implement: write or generate the code for each task and check it against the spec and its tests.

Machine-readable parts of the spec, such as OpenAPI documents or JSON schemas, can be used directly to generate clients, mocks and contract tests.

Why it matters with AI coding agents

AI agents write code quickly, but they fill gaps with guesses. A short prompt leaves many decisions open; a reviewed spec closes most of them. The spec also gives people something concrete to review before any code exists, which is cheaper than reviewing large changes afterwards.

Tools such as GitHub's open-source Spec Kit, and others built around the same idea, structure this flow for coding agents.

SDD vs TDD and API-first

Test-driven development writes a failing test before each piece of code; spec-driven development starts one level higher, with the behaviour and contracts of the whole feature. API-first is a form of spec-driven work focused on interfaces: the API contract is agreed before the services are built. In practice the three combine well: the spec defines the behaviour and contracts, and tests derived from it keep the code honest.

When it makes sense

  • Several teams or agents must build parts that fit together.
  • Requirements need sign-off from business, legal or a client before building.
  • AI agents generate a large share of the code.
  • The system has public or long-lived interfaces.

For small experiments or throwaway prototypes, a full spec can be more overhead than help.

Frequently asked questions

What does SDD stand for in software?

SDD stands for spec-driven development: building software from an explicit, reviewed specification that leads the implementation. The spec, not the code, is treated as the source of truth.

Is spec-driven development the same as waterfall?

No. Waterfall fixes a large specification up front and rarely revisits it. In spec-driven development the spec is a living artefact, kept small per feature and updated as the team learns, and code is generated or written from it in short cycles.

How does spec-driven development help with AI coding?

It gives the AI agent a precise, bounded description of what to build, so it guesses less. People review the spec before the code exists, and tests derived from the spec check that the generated code does what was agreed.

What is GitHub Spec Kit?

Spec Kit is an open-source toolkit published by GitHub to try spec-driven development with coding agents. It structures the work into phases, from the spec to a technical plan, tasks and implementation.

What goes into a good spec?

The goal and the users, the expected behaviour with acceptance criteria, the interfaces and data contracts, constraints such as security and performance, and what is out of scope. It should be short enough to review and precise enough to test.

Decision guides that use this term

How to put it to work

Where it shows up at Thinkia

Further reading

Sources

Updated: 2026-10-21

Want to see how this applies to your organisation?

Talk to an AI Expert