name: swagger-health-contracts description: Backend-local workflow for health endpoints, readiness behavior, Swagger/OpenAPI exposure, and runtime contract changes in PetSwipe. Use when backend work touches backend/src/app.ts, startup behavior, docs endpoints, or deployment-sensitive runtime behavior.
Use this skill for backend runtime contract work.
Workflow
- Start from
backend/src/app.tsand the touched runtime path. - Check whether
/health,/ready,/api-docs.json, or/docsbehavior changes. - Evaluate deployment and operator implications of the change.
- Keep API/runtime docs aligned with the real backend contract.
Read references/runtime-contract-checklist.md.