Spec-Driven Development

Spec-driven development isn't waterfall with markdown. It's not a productivity trap. It's also not a silver bullet. The honest version is more useful than either the evangelist or the cynic gets credit for — and it's why your AI coding agent stops shipping the wrong thing.

25 of 26 pages published · written for solo founders and small teams shipping with Cursor, Claude Code, Codex, and Gemini.

Read in order

The pages below assume the prior ones were read. The arc runs from the ground up: why SDD exists, how to author your first spec, how it compares to practices you already know, how to choose a framework, and how to run it solo. Specs are half the picture: a spec is the stop condition, and a loop is what keeps running until it's met — see loop engineering. Want a full spec to build an agent yourself? See the free agent specs library.

Part 2

Authoring your first spec

Anatomy, sizing, acceptance criteria, mindset, substrate, lifecycle, longevity.

  1. 6. The minimal spec format Chapter
  2. 7. How granular should a spec be? Q&A
  3. 8. Acceptance criteria agents can actually execute Chapter
  4. 9. Treating AI prompts like functions Chapter
  5. 10. Stop debugging AI output — start writing better specs instead Chapter
  6. 11. Is markdown the right substrate for AI specs? Q&A
  7. 12. Living specs vs frozen specs Chapter
  8. 13. How to build specs today that won't become tomorrow's refactor Chapter
Part 4

Choosing your framework

Landscape, multi-framework comparisons, head-to-heads, decision tree.

  1. 17. The framework landscape: where SDD tooling stands in 2026 Listicle
  2. 18. Lightweight SDD frameworks compared Roundup
  3. 19. GitHub Spec Kit vs. Tekk.coach vs. ChatPRD Comparison
  4. 20. Tekk.coach vs BMAD vs Get Shit Done (GSD) Comparison
  5. 21. Tekk.coach vs Traycer vs OpenSpec Comparison
  6. 22. Choosing your SDD framework — a decision tree Chapter
  7. 23. Kiro vs Tekk.coach vs Cursor 2.0: IDE-coupled, platform, and agentic IDE compared Comparison

Let your product improve itself.

Connect your repo. Twelve loops start watching your code and bring you proposals — you greenlight them, your coding agent builds them.