project-api-validation git:20260902.749d57bA

Immutable. This exact content is served forever at /api/v1/blob/1a434137ca213aaf.

---
name: project-api-validation
description: Apply this repository's request-validation and error-code contract when API acceptance or rejection behavior changes.
metadata:
  job: api-error-code-maintenance
---

# Project API validation

Use this procedure for request-validation changes:

1. Inspect the target handler and its unit tests.
2. Preserve absent, empty, and already accepted inputs.
3. Preserve `errors.problem(field, code)` and reject invalid input before any registry mutation.
4. Add every new error code to `contracts/error-codes.json`; keep it sorted and unique.
5. Run `python3 -m unittest -q`.
6. Run `python3 tools/verify_error_catalog.py`.

Do not use this Skill for internal algorithms or release documentation.