15% weight · Owner: API Platform
Specification and data-contract quality
Makes the machine-readable API specification the authoritative build and release contract.
GREEN≥ 90%
AMBER≥ 70%
REDBelow threshold or blocker
| Gate | Requirement | Severity | Blocking | Evaluator | Evidence path |
|---|---|---|---|---|---|
SPEC-001 | OpenAPI file exists | CRITICAL | Yes | file_exists | contracts.openapi |
SPEC-002 | OpenAPI structure is valid | CRITICAL | Yes | openapi_structural | Derived evidence |
SPEC-003 | Backward compatibility is declared | HIGH | No | truthy | contracts.backward_compatibility |
SPEC-004 | Standard error model is declared | HIGH | No | truthy | contracts.error_model |
SPEC-005 | Security scheme is declared | CRITICAL | Yes | openapi_security | Derived evidence |