Design REST APIs with strong resource modeling, pagination, filtering, error model, and versioning; produce an OpenAPI draft and controller/service contracts. Use when adding new endpoints or redesigning existing APIs.
In scope:
Out of scope:
Model resources
Define endpoints + semantics
Pagination and filtering
Error model (Problem Details)
Versioning & compatibility
Produce OpenAPI draft
Define implementation contracts
templates/openapi/ for starter OAS files.templates/errors/ for Problem Details examples.references/ for detailed REST checklists and versioning guidance.