## Commands

- Install: `uv sync`
- Run app: `uv run python -m your_app`
- Run tests: `uv run pytest`
- Lint: `uv run ruff check .`
- Format: `uv run ruff format .`

## Engineering rules

- Write tests before implementation
- Prefer small PR-sized tasks
- Keep business logic out of widgets where possible
- Every screen must have empty/loading/error coverage
- Every interactive feature needs at least one Pilot test
- Visual changes should be covered by snapshot tests