Review: API Contract

Overview

This skill defines the review process for REST API changes — new endpoints, modified response shapes, versioning decisions, and breaking change assessment. Use it alongside review-code-quality-process when a PR exposes or modifies an HTTP API surface. Where code quality questions arise (auth middleware, error handling, testing), defer to that skill; this one focuses on the contract itself.

When to Use

• Reviewing a PR that adds, modifies, or removes API endpoints
• Evaluating a proposed API design before implementation begins
• Assessing whether a change is breaking before it ships
• Auditing an existing API for consistency and correctness

Dimension 1: Resource Naming

Goal: Verify that endpoint paths follow REST conventions and are consistent with existing routes.