Overview

What this brain is

Where things live

What	Where
Durable facts (purpose, vocabulary, decisions)	memory/facts.md
Session log	memory/log.md
Agent operating manual	CLAUDE.md
Fill conventions, linking, menu sync	agent_docs/how-to-enrich-files.md
Progress map	README.md
Knowledge content	src/content/docs/<section>/

How to contribute

1. Read CLAUDE.md once. It is the contract.
2. Find what to work on in the README.md progress map.
3. Edit the relevant doc under src/content/docs/.
4. Update the three sync surfaces (README.md, src/content/docs/index.mdx, astro.config.ts sidebar) in the same commit if scope, status, title, or path changed.
5. Prepend one line to memory/log.md describing the change.

Linking to other docs

Inside src/content/docs/, use absolute Starlight paths with a trailing slash and no .md:

[Another section](/01-section-name/doc-slug/)

README.md and files under memory/ and agent_docs/ keep .md extensions — they’re not Starlight-rendered. Full mechanics: agent_docs/how-to-enrich-files.md § Linking inside the brain.

Diagrams

Mermaid in fenced code blocks renders client-side, theme-aware:

graph LR
    A[Idea] --> B[Doc]
    B --> C[Review]
    C --> D[Current]