---
icon: 🧠
---

# Brain

Durable context for this repo. Every folder here is a page in Craftspace, and every page here is a file in
the repo, so the team reads the same thing whether they open GitHub or the app.

This page is a **spine**: one line per Area, pointing at the page that holds it. Hard-to-reverse calls live
as Decisions, not here.

## Areas

Add one folder per Area that fits what this project actually holds — an engineering project grows different
ones than a sales project does. `decisions/` is the only one every repo starts with. Replace these examples
with your own and keep the shape: **bold name**, then the one line that says what a reader will find there.

- **Example Area** — what this Area covers, and the one gotcha that bites people in it

## How a page is shaped

One Area owns exactly one page, and that page is a glossary spine: one line per term, defining what the
term IS. A term that outgrows its line graduates to its own file beside the page. Search before you write —
a second page for an Area that already has one is the failure this structure exists to prevent.

## Gotchas

- Craftspace mirrors this folder read-only. Edit the files here and merge, and the pages follow.
- `<area>/index.md` is the page for `<area>`; a file beside it is that page's child.
