name: backend-api-change description: Safe PetSwipe backend workflow for Express route changes, TypeORM entity updates, service changes, migrations, auth adjustments, and API docs updates. Use when work changes backend behavior or data flow and needs route/controller/service/entity coherence.
Use this skill for backend/API changes in PetSwipe.
Workflow
- Identify the route, controller, service, entity, and migration impact.
- Keep request and response behavior explicit.
- Check whether Swagger/OpenAPI exposure needs to change.
- Check whether health, readiness, or startup behavior is affected.
- Validate with build/tests appropriate to the touched area.
Repo-Specific Guidance
backend/src/app.tsis the central runtime and docs surface.- Health endpoints at
/healthand/readymatter for deployment. - Swagger is exposed at
/api-docs.jsonand/docs. - Route/controller/service/entity drift is a common source of regressions.
Read references/api-checklist.md before finishing.