The README had grown to 254 lines covering an overview, every command,
the Fold/SARIF and p4c import contracts, the P4 pilot, per-language
resolution rules, limits, schema history, development and the agent
skill. It is now a 70-line overview (what Brick is, evidence lanes,
languages, quick start, commands, limits, links), and the rest lives in:
- docs/usage.md: every command (build, render, check with diff and
policy gates, mcp, setup), Fold/SARIF and p4c layering, the P4 pilot,
and what the model contains.
- docs/resolution.md: per-language name resolution as the code now
implements it, what is not handled, P4 limits, the regression corpus
and schema version 4.
- docs/development.md: build and test commands, the quality gate, the
toolchain pin, and the brick-sast skill.
Architecture docs are linked, not repeated. "What v0.1 provides" and
the milestone note are folded into usage.md and the roadmap pointer.
Every relative link and anchor resolves.
