API Contract-First Development

Use When

• Designing or changing REST, GraphQL, or event contracts between UI and services
• Backward compatibility or versioning decisions are required

Workflow

1. Capture consumer needs and edge cases.
2. Draft contract schema and examples.
3. Define versioning and compatibility guarantees.
4. Implement provider and consumer validation.
5. Release with deprecation timeline when needed.

Required Checks