---
status: generated
---
# Adepts

This directory holds domain knowledge accumulated by adept agents. Each
subfolder is one domain — a subsystem, a library, a cross-cutting concern —
named with a short kebab-case slug.

## Structure

```
adepts/
  CLAUDE.md              ← you are here
  _template/             ← starter template; copied on founding
    CLAUDE.md
    handoff.md
  <domain-slug>/
    CLAUDE.md            ← INDEX — frontmatter + tiered reading list. Short. Auto-loaded.
    handoff.md           ← rolling state for the successor. Overwritten, not appended.
    key-files.md         ← solid knowledge docs — as many as the domain needs
    conventions.md
    architecture.md
    gotchas.md
    ...                  ← any other doc, provided it is listed in CLAUDE.md
    journal/
      YYYY-MM-DD-HH-genesis.md
      YYYY-MM-DD-HH-<topic>.md
```

## Conventions

- **One domain per folder.** Overlap → pick the stricter scope. Broad names are gravity wells.
- **CLAUDE.md is an index, not a document.** Frontmatter + tiered reading list + open questions. Under ~60 lines. It is auto-loaded whenever anything in the folder is read — keep it cheap.
- **Every file in the domain root is listed in CLAUDE.md.** Unlisted files do not exist.
- **handoff.md is overwritten, never appended.** Write it early, refresh it after anything significant. `verified-at` is the commit the solid docs were last checked against.
- **journal/ is append-only.** One file per topic or session, `YYYY-MM-DD-HH-<topic>.md`. Recency and session counts are derived from these names — keep the prefix exact.
- **Solid knowledge goes in docs; experiences go in the journal.** Branch observations stay in the journal (and handoff.md's "In flight") until the code is on main.
- **Don't hoard.** Findings that belong in the project's docs or a workpad report go there; link from here.
- **Metadata is derived.** Never hand-maintain counts, dates, or an index file. Declare `domain`, `summary`, `covers`, `related`, `status` once in frontmatter; the roster does the rest.