liveBook · Manning

Specification bypass

As explained in Spec-Driven Development

A change made directly to code without first being represented in the governing specification.

A specification bypass is a code change made without first changing the governing specification. Occasional bypasses may be acceptable early in specification-driven development; repeated bypasses suggest the specification process is too slow or features are too large to specify cleanly. section 3.4.2

Treat bypasses as a qualitative signal that the specification has stopped being where change happens. Revise the specification and regenerate the implementation; then check whether the same kind of intent gap recurs. section 3.4.2

Figure 3.4 The SDD governance operating loop involves observing gaps between intent and implementation and correcting them by revising the specification and regenerating the implementation. We then attribute the gap in the specification to where the intent was lost in the SDD workflow to improve it, and we confirm the improvement is working when the same class of gap stops recurring.

The governance loop shows how to trace gaps between intent and implementation back to the point where intent was lost. section 3.4.2

How Spec-Driven Development covers it

How deep it goes
Defines bypasses and interprets repeated instances as upstream process friction, while treating early adoption exceptions as potentially acceptable.
Examples
Contrasts occasional direct code edits during early adoption with repeated bypasses caused by slow specification or oversized features.
What you can do after
Evaluate specification health by observing bypasses and identifying process friction that may be pushing changes outside the specification.
How it connects
Connects specification-driven development with alignment regression, time-to-aligned implementation, and false-positive completions.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Spec-Driven Development. The section links point to the parts of the book it draws on.