Most teams write the API, then write the OpenAPI spec, then watch them diverge until the docs are useless. The fix is to make the spec the source of truth — generate types, validation, mocks, and clients from it. Here is the workflow that survives, and the tools that make it tractable.