design-first

Writing and reviewing an API’s contract, such as an OpenAPI document, before writing the code that implements it.

In more detail

Review at the design stage catches ambiguous names, missing errors and incompatible assumptions while they are cheap to fix. It does not freeze the design; it gives the implementation a visible promise to keep.

Related terms

Taught in

References