Skip to content

Topic

Spec-Driven Development

Software development approach that encodes requirements and tasks as version-controlled specs for AI coding agents to execute, instead of prompting.

Current stories

product1 publisher

Spec-driven development makes teams write down expected behavior and acceptance criteria before an AI agent edits code

System Design One's newsletter says AI agents on big codebases need written specs, citing a change that passed tests but emailed an opted-out user. Most of its sample spec just records what the old system already does, and a team can write that document before buying any agent platform.

Publishers:newsletter.systemdesign.one

Reality

Evidence30
Adoption
Insufficient
Hype gap+25
Incentives
Insufficient
Confidence45
build1 publisher

A 76,326-word BMAD plan blocked its own implementation on day five

One operator ran spec-driven development at full BMAD weight for four weeks on an autonomous coding repo. The planning stage produced 1,782 files and 16 MB of artifacts, and a single story burned around thirty million tokens.

Publishers:dev.to

Reality

Evidence34
Adoption20
Hype gap+20
Incentives45
Confidence38
build1 publisher

Chrome drops the extension the moment the native host logs to stdout

A dev.to writeup wires CPU and RAM telemetry from a Manifest V3 extension down to a standalone Windows binary. The first of its seven written rules: nothing may print to stdout, where Chrome expects a 4-byte length prefix.

Publishers:dev.to

Reality

Evidence42
Adoption
Insufficient
Hype gap+20
Incentives55
Confidence45
build1 publisher

Freeze the pagination contract before the agent writes the list handler

Offset paging passes a static test suite and then skips rows the moment a merchant inserts a product mid-read. A dev.to case study answers that by freezing the sort key, tie-breaker and error codes in a spec file the agent cannot edit.

Publishers:dev.to

Reality

Evidence45
Adoption
Insufficient
Hype gap+25
Incentives20
Confidence50
build1 publisher

Halving both factors in an agent loop's cost quarters the bill

Signadot's argument is that the bill for an unattended coding loop is the iterations it needs times the cost of each one, and that only feedback precise enough to localize a fault shrinks both of those terms at once.

Publishers:dev.to

Reality

Evidence24
Adoption
Insufficient
Hype gap+34
Incentives80
Confidence60