Go OpenAPI

The spec is the source of truth. Types, routes, and clients are generated from it — never hand-written alongside it, because two hand-maintained copies of a contract diverge within one sprint.

Operating Modes

• Adopt — the project has hand-written handlers and no spec, or a spec nobody generates from. Introduce generation without a rewrite.
• Extend — the pipeline exists. Change the spec, regenerate, implement.
• Review — check that handlers, spec, and published client agree, and that the change is not silently breaking.

1. Choose the Generator Once