# Project: <name>

## What this is
One paragraph: what the system does and who uses it.

## Commands
- Install: `...`
- Dev server: `...`
- Tests: `...` (run a single test: `...`)
- Lint / typecheck: `...`

## Architecture
- `src/api/` — ...
- `src/domain/` — ...
Key boundaries and where new code should go.

## Conventions
- Naming, error handling, logging patterns to follow.
- Libraries to prefer, and ones to avoid.

## Guardrails
- Never edit: generated files, migrations already applied, ...
- Ask before: adding dependencies, changing public APIs, ...

## Definition of done
- Tests added or updated and passing.
- Lint and typecheck clean.