- Sync from master.
- Create a focused branch.
- Implement changes with tests.
- Run lint, format, and tests.
- Open PR with clear scope and validation notes.
- Keep changes layer-aligned and minimal.
- Prefer explicit typing for public functions.
- Keep endpoint logic thin.
- Do not place business logic in middleware or routers.
- Scope is focused and documented
- Tests added or updated
- uv run pytest passes
- uv run ruff check . passes
- uv run ruff format . applied
- Docs updated (including docs/llms.txt when relevant)
- Breaking API changes called out clearly