Skip to content

Reference#

This section is the lookup-by-fact corner of the documentation. Pages here are stable, dense, and short on narrative — the kind of material you scan for a definition or check before a release.

What you will find here#

  • Architecture decisions (ADRs) — the foundational decisions that shape the system, each with context, decision, and consequences.
  • Spec manifest — the numbered specs in spec/, what each covers, and the reading order for a contributor coming in cold.
  • Release checklist — the manual smoke pass to run after any deploy that touches main. About ten minutes end to end.
  • Glossary — every domain term used in the codebase and the docs, with one-line definitions and pointers to the deeper explanation.

For longer narrative explanations, see the other sections:

  • Architecture — system overview, data model, auth, observability.
  • API and MCP — the two transports and their conventions.
  • Operator guide — running the system day to day.
  • Deployment — getting the system onto a host and keeping it there.

The numbered specs in spec/ and the source ADRs in adr/ in the repository are the canonical sources for these pages. When something here disagrees with a spec, the spec wins; please open an issue so the doc can be corrected.