Skip to content

Glossary

Every mage term in one place. Each links to the page where it is explained in full.

TermMeaning
memorywhat your agent remembers across sessions. In mage, a memory is a note — there is no separate store. mage is the agent’s memory, made durable, curated, portable, and shareable. See The loop.
noteone such memory: a committed markdown unit of hard-earned knowledge under notes/ — insight + procedure + pointers, never a copy of a source (not a fact you can re-derive in seconds). See Notes.
compact-chapterone stretch of work between context compactions. mage counts chapters, not session ids — so one long, continuously-compacted chat still accrues recurrence. See Promote and graduate.
wing / roomhow the index is organised: a wing is a top-level grouping (by tag); a room is a sub-group within a wing. See The graph.
learnings (.mage/learnings/)the raw, auto-pruned trail of session events — git-ignored, not knowledge yet. See Capture and The .mage/ layout.
staging (.mage/staging/)drafts awaiting your accept/reject — scrubbed and deduped, git-ignored. See Stage and groom.
INDEX.md / MEMORY.mdthe generated recall index. MEMORY.md is the Claude-Code-named twin of the portable INDEX.md — identical content, a host-specific filename the auto-load looks for. See The graph.
hub / projecta hub is a shared knowledge base; a project is one repo’s slice of it, at <hub>/projects/<name>/. See Modes and storage.
in-repo / external / hybridthe three storage modes = where a repo’s notes live: in the repo · in the hub · in the repo but registered to a hub. See Modes and storage.
K / Mrecurrence gates: a pattern becomes a note candidate after K chapters; a proven procedural note graduates to a skill after M. One sensitivity dial scales both. See Thresholds and the dial.
redaction gatessecrets are scrubbed before they can persist — at stage and again at git commit (the two gates); on Claude Code a capture-time scrub (Gate-0) is added too. Secrets block; PII warns. See Redaction.
autonomy ladderhow much grooming the agent may do unattended: operator (propose only) → approver (write notes) → overseer (write + graduate). Set per knowledge base. See Autonomy levels.

For the verbs and skills themselves, see Commands; for the loop those terms move through, see The self-grooming loop.