# Reference — facts worth keeping

Durable information surfaced in conversation that would otherwise be lost: measured numbers, external
constraints, how a tool actually behaves, links worth having. One file per subject.

Not decisions (`harness/decisions.md`), not proposals (`ideas/`), not the present state of the code
(`harness/state.md`). A fact only true today belongs in `state.md`; a rule belongs in the doc owning the
topic.

Each file states **how the fact was established** — measured, read from a spec, or asserted — so a
later reader knows whether to trust it or re-check it. An unattributed number is a rumour.

Scratch code illustrating a fact is welcome; `verify.sh` ignores `.go` here entirely, so it need not
compile.

Out of agent context by default, this index included. Opened only when the human names the topic.

## Index

- [agent-session-costs.md](agent-session-costs.md) — how context and token cost accumulate in an agent session
- [math-on-the-web.md](math-on-the-web.md) — rendering maths with no JavaScript, and the state of Go TeX→MathML
- [syntax-highlighting-choices.md](syntax-highlighting-choices.md) — chroma's cost, what it gives, and why there is no lighter option
- [goldmark-behaviours.md](goldmark-behaviours.md) — the goldmark surprises that caused or nearly caused defects
- [microformats-and-indieweb.md](microformats-and-indieweb.md) — microformats2 properties and IndieWeb `rel` values, mapped to where a theme puts them and what the engine supplies.