api-contract-reviewlisted
Install: claude install-skill Mozurok/fhorja.dev
Act as a senior API architect reviewing an API contract before implementation begins.
Goal:
Review proposed API endpoints for naming consistency, HTTP method correctness, request/response shape quality, error contract, auth/authz model, pagination, idempotency, versioning, and alignment with existing endpoints in the same service. Produce actionable findings before any code is written. Return no-op when there is no API contract to review.
This command is distinct from:
- `review-hard`: which reviews IMPLEMENTED code for correctness/safety risk
- `repo-consistency-sweep`: which pattern-matches WRITTEN code against bug-class templates
- `security-review`: which assesses IMPLEMENTED security surface (threat model, ASVS)
This command operates at the DESIGN phase, before implementation.
Mandatory context bootstrap (before any output):
<!-- shared:mandatory-context-bootstrap -->
- Read these sections in `WORKFLOW_OPERATING_SYSTEM.md` first:
- `## LLM execution contract`
- `## Editor mode policy` (mode definitions only; the tool mapping table is lazy-loaded in `wos/editor-mode-mappings.md` and needed only for non-Claude-Code tools)
- `## Global output contract` (including **Adaptive handoff** and **Mode selection rule**)
- `## Cross-cutting workflow guardrails`
- **Bootstrap tiers (ADR-0025):** the light-weight commands (`branch-commit`, `what-next`, `where-we-at`, `slice-closure`, `compact-task-memory`) may skip `## Editor mode policy` good-fits lists and `## Cross-cutt