# Swagger Health Contracts

> 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.

- Skill: `hoangsonww/swagger-health-contracts` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add hoangsonww/swagger-health-contracts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangsonww/swagger-health-contracts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: hoangsonww (https://skillmd.com/u/hoangsonww)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangsonww/swagger-health-contracts

---


Use this skill for backend runtime contract work.

## Workflow

1. Start from `backend/src/app.ts` and the touched runtime path.
2. Check whether `/health`, `/ready`, `/api-docs.json`, or `/docs` behavior changes.
3. Evaluate deployment and operator implications of the change.
4. Keep API/runtime docs aligned with the real backend contract.

Read `references/runtime-contract-checklist.md`.