An OpenAPI / Swagger spec is a contract you write once and trust forever — until the first silent rename blows up three downstream clients. This field guide shows you how to lint the spec structurally before the codegen step runs.