Reference
Reference is for lookup, not for first-pass reading.
Use this part of the docs when you already understand the system shape and need an exact term, path, or protocol detail without rereading the narrative pages.
When to use reference
| If you need to answer | Read |
|---|---|
| what a project term means right now | Glossary |
which local files clumsies writes under ~/.clumsies | Runtime surfaces and Workspace |
| how runtime evidence is buffered and uploaded | Attestation |
| which MCP tools are part of the current implementation | MCP |
| which commands and flags exist today | CLI reference |
| which directories in the repository own which responsibilities | Codebase map |
What belongs here
Reference pages should do one of two jobs.
First, they can stabilize terminology. That is the role of Glossary. It exists so the rest of the docs do not need to keep redefining rule, workspace, manifest, attestation, or adapter.
Second, they can answer exact lookup questions that are easy to forget but expensive to rediscover in code. Runtime paths, MCP tool names, and command flags belong in that class of material.
Reference should not try to mirror the whole docs site. If a page only repeats the main navigation or recommended reading order, it is noise rather than reference.