These instructions apply repository-wide.
Canonical AI-facing engineering skills live under docs/engineering/skills/.
Use those files as the source of truth across Codex, Claude, Copilot, and other
AI tools.
When changing API v2 migration contracts, route-group migration metadata, PR
cutover plans, generated migration docs, or migration guard scripts, read
docs/engineering/skills/migration_contracts.md.
When adding, moving, or reviewing tests, read
docs/engineering/skills/testing.md.
Read docs/engineering/skills/github-prs.md before opening, replacing, or
sharing any pull request.
Before creating or sharing a migration PR, run the focused migration guards:
python scripts/run_quality_guards.py
python scripts/export_migration_contracts.py