OpenAPI должен быть источником проверяемого контракта: расхождения схема↔факт — дефекты; генерация тестов/мок из спеки ускоряет регресс, но требует живой спеки в CI.
Разбор
- Lint OpenAPI в PR; breaking change detection.
- Contract tests / schemathesis против running service.
- Запрет «сначала код, спека потом» для публичных API.
- Примеры в спеке = кандидаты в тест-кейсы.
Итог
Если спека врёт — тесты по ней вредны; держите спеку executable.