# CLAUDE.md

**Read [AGENTS.md](AGENTS.md) before making any non-trivial change to this repository.**

It is the agent-context file for this project, and it is not optional reading: it records design
decisions that are *locked* rather than defaults to re-derive, and several of them have already
been broken once by someone who reasoned from the code alone. It also names which of
`ARCHITECTURE.md`, `ROADMAP.md`, `ROADMAP_v2.md`, `DEVLOG.md` and `tests/BREAKING_CHANGES.md` to
read for what.

This file is a pointer so that the guidance has exactly one copy. `QWEN.md` points at the same
place, for the same reason.