liveBook · Manning

Underspecified specification

As explained in Spec-Driven Development

An underspecified specification is a specification that governs changes but omits enough intent or detail to constrain implementation reliably.

An underspecified specification drives changes but omits enough intent to constrain implementation reliably. It has high control authority and low fidelity, unlike an Authoritative Specification, which combines both. section 3.5.3

Figure 3.5 How alive a specification is depends on the control authority and fidelity.

The four-state matrix locates underspecified specifications and contrasts them with authoritative, reconciled, and decorative specifications. section 3.5.3

How Spec-Driven Development covers it

How deep it goes
Classifies the state by control authority and fidelity, contrasting it with three other states and naming the authoritative state as the goal.
What you can do after
Evaluate a specification by whether it drives change and faithfully captures enough intent to constrain implementation.
How it connects
Connects specification fidelity and control authority with authoritative, reconciled, and decorative specifications.

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.