Files

T

g4borg dcb765a760 🤖 Add Zathras agent and initialize Spire for reliquary

Scaffold .claude/spire/project.md with reliquary-specific facts,
create adept templates at docs/workpad/adepts/, build the Zathras
agent and skill (Spire's self-maintenance coordinator), and wire
/assistant as a local alias for spire:zathras.

2026-09-21 14:05:32 +02:00

2.0 KiB

Raw Blame History

status

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.

2.0 KiB Raw Blame History

Adepts

Structure

Conventions

2.0 KiB

Raw Blame History