Chapter 6. The SDD Workflow
Chapter 5 made the case for why writing specifications matters. This chapter covers the full workflow that takes a specification from intent to production-ready code, then keeps that code aligned with the spec over time. Along the way, it also covers what makes a spec agent-friendly in practice, so that the workflow has good inputs to work with at every phase.
The SDD workflow is a set of named phases with durable artifacts, human checkpoints at the transitions between phases, and clear rules for when to continue and stop. Once you’ve run the loop a few times, the structure becomes lightweight.
This chapter also addresses one of the most common questions engineers raise when they start exploring SDD: “This sounds great for greenfield projects, but what about the codebase I’m already maintaining?” The final section covers SDD in brownfield projects, with a practical strategy for introducing specs into systems that were never specified to begin with.
The Canonical Loop: ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access