# Agent instructions

## Orientation

- `docs/` contains product context, working plans, and architecture decisions.
- `specs/` contains canonical feature specifications.

On conflict, accepted ADRs prevail, then `specs/`, then derived `docs/`.

## Change discipline

- Update affected specs, ADRs, and docs in the same change as the code.