These instructions apply repository-wide.
Repository-wide AI-facing engineering guidance lives in AGENTS.md.
Canonical skills live under docs/engineering/skills/.
Use those files as the source of truth. This file is a Claude adapter and should stay thin; do not duplicate detailed testing, CI, formatting, or architecture rules here.
Before adding an HTTP route or changing an existing route's query-parameter
contract, read docs/engineering/skills/api-routes.md.
Before opening, replacing, or sharing a PR, read
docs/engineering/skills/github-prs.md.
When changing API v2 migration contracts, route-group migration metadata,
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.
When changing SQLAlchemy models, Alembic configuration, database schemas, or
migration revisions, read
docs/engineering/skills/alembic-migrations.md.
When adding or moving API v2 route, service, or database-access modules, read
docs/engineering/skills/v2-code-organization.md.
When modifying the Makefile, read
docs/engineering/skills/repository-maintenance.md.
Do not claim a route, database table, compute path, or deployment surface has migrated unless the relevant contract tests, migration flags, and generated migration docs identify that state.