# 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. Its documentation map says which
of the project's other documents 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.