What I learned:
The honest answer to "what do teams report" is that almost nobody is reporting, and the star counts are hiding it - github/spec-kit sits at 124,743 stars and 11,140 forks with 318 open issues as of today, ranked #79 on GitHub globally by star-history, with Fission-AI/OpenSpec at 63,289 stars and 327 open issues and gsd-build/get-shit-done at 64,785. Against a quarter of a million stars across three repos, Augment Code's brownfield guide states flatly that "DORA has acknowledged the topic but published no SDD-specific findings, and peer-reviewed literature offers no standardized metrics yet," that "rigorous brownfield before-and-after data has not been published," and that "teams adopting brownfield SDD in 2026 are establishing baselines rather than following mature standards." The engagement gap shows up inside the window too: an Ask HN on what people think of spec-driven development posted 24 July drew 4 points and 2 comments. If you are deciding whether to adopt this, you are deciding on anecdote, and the anecdotes skew solo and greenfield.
The single best field report in the window is about the absence of a standard rather than the merits of specs - @mardehaym describes a healthcare data company with AI coding tools on every engineering team where "adoption looked great in the seat count," then asked four engineers across three teams how they actually used it and got four different answers: "One team wrote specs first. Another pasted whole files into a chat window and hoped. A third kept a review checklist that no lead ever enforced. The fourth had built something good and told no one." The line that matters for anyone about to roll out a spec workflow is the last one: "None of the four could name the org standard, because their org did not have one." Spec-driven development as a team practice fails at the enforcement layer long before it fails on methodology, and buying seats does not touch that layer.
The waterfall objection has a precise form, a precise rebuttal, and most people are arguing past both - the strongest version is Kent Beck's, carried in Martin Fowler's 8 January Fragments: the descriptions of SDD he has seen "emphasize writing the whole specification before implementation," which "encodes the (to me bizarre) assumption that you aren't going to learn anything during implementation that would change the specification." The blunter version landed on X on 3 July from @PawelHuryn: "Spec-Driven Development was always BS. It never worked for humans. Waterfall lost to agile because you discover what you actually need while building, not in a spec written up front." The rebuttal from AWS's Marc Brooker is that "you don't need to, and probably shouldn't, develop the entire specification upfront." Both are right about different things, which is the tell: the real objection is to freezing a spec, not to writing one, and the tools ship phase gates whether or not the methodology asked for them.
The clearest account of how it actually goes wrong describes a bind with no exit inside the workflow - sudoish's waterfall-trap writeup names it: "Trust the spec and risk building on wrong assumptions. Question the spec and risk destabilizing it further." The mechanism is that an agent-authored spec reads as authoritative, since "the AI makes everything look correct... It reads like something a senior architect wrote after careful deliberation," and challenging one makes it worse, because "hallucination risk actually goes up when you question it, because now it's reconciling your objection with a position it never truly held." What came out the other end was "thousands of lines of specification documents. Documents that were incredibly hard to review." The closing diagnosis is the practical one to steal: "nothing in the workflow guided me toward 'that's enough, go build and come back.'" IBM draws the same line more mildly, warning that three weeks spent debating the name of a single JSON key for a feature that might be deleted in a month defeats the purpose entirely.
Spec drift is the cost every guide names and nobody has fixed, and the most honest version says the fix is not process - Augment Code puts it plainly: engineers write the doc, ship the feature and move on, and "the updating part is invisible work that competes with everything else on a given day, and it loses that competition almost every time." Then the sentence worth quoting back at anyone proposing a spec policy: "We've tried process. We've tried tooling. We've tried making it a team value. None of it has worked because we keep asking humans to do a thing that humans reliably won't do." Agents change the shape of that cost rather than shrinking it, because "a stale spec misleads agents that don't know any better. They'll execute a plan that no longer matches reality, confidently, and they won't flag that anything is wrong." The same piece cites InfoQ on the structural limit for teams specifically: current tools "typically keep specs co-located with code in a single repository" while "modern architectures span microservices, shared libraries and infrastructure repositories."
Nobody agrees what the term means, which is why the argument never resolves and the tooling keeps forking - the sharpest thing said on X all month came from @wangleineo replying into a thread with Gergely Orosz and Dex Horthy: "You have to define spec-driven development. I believe everyone is using some kind of specs with AI coding. Specs go out of sync with code, sure, that is a problem to solve, but how else do you communicate with agents if not through specs?" That is the strongest available defense, and it is a defense of markdown files rather than of a methodology. Meanwhile the label keeps splitting under load: @0xJeyx compresses the whole method into Karpathy's Sequoia AI Ascent 2026 line, "You have to work with your agent to design a spec that is very detailed," which is prompt advice and not a process; OpenSpec shipped v1.7.0 rebuilt around an artifact-guided workflow that replaces its own prior shape; and July's Show HN crop includes Kastor pitching Terraform-style specs for agents at 33 points and 21 comments, and Speck modelling itself on compilers and build tools at 5. Choosing a spec tool right now means choosing between incompatible definitions of the word.
KEY PATTERNS from the research: 1. Adoption is measured in stars and nothing else - 124,743 on spec-kit against no published before-and-after data and no standardized metrics, per Augment Code 2. The failure teams actually hit is the lack of an enforced org standard rather than a bad methodology, with four engineers at one company giving four different answers, per @mardehaym 3. The waterfall objection is about freezing a spec, not writing one - Beck's form is that SDD assumes you learn nothing during implementation, per Martin Fowler 4. Agent-authored specs read like senior-architect work, are incredibly hard to review, and get more dangerous when challenged because hallucination risk rises, per sudoish 5. Drift has resisted process, tooling and culture alike, and a stale spec now misleads an agent that executes it confidently without flagging anything, per Augment Code 6. There is no shared definition of the term, and the best defense on offer reduces to "how else do you communicate with agents if not through specs?", per @wangleineo