Designs

Designs

The high-level design docs behind Agent M — its memory layer and the harness tooling around it — the full HLDs for what shipped and what's in flight, where the design started and where it's going. The Architecture pillar overviews link down into these for the deep detail.

MemoryVault

The permanent agent-memory store and its six implementation parts.

• MemoryVault — the design for durable, file-based agent memory.
  • write-primitives — how entries are captured and shaped.
  • recall-loop — how the right entries surface within a token budget.
  • reflection-and-recovery — self-maintenance + crash recovery.
  • idea-ledger — the incubator for not-yet-acted-on ideas.
  • seed-pass — the co-created first pass that bootstraps a vault.
  • discovery-mining — surfacing latent structure from existing notes.

Architecture-Governance (AG track) — the live parents

The current top-level design parents (AG-track Phase 1, status: launched). Children point up at these; all children are content-final and launched as of AG Phase 3 (2026-06-24).

• Foundations — the shared cross-repo "why": the nine principles agentm and crickets both stand on, and how the person (agentm) and its tools (crickets) relate. The root both HLDs inherit by reference.
• AgentM HLD — the agentm parent: the four pillars (Experience · Memory · Opinions · Personas), their components, and where each touches crickets. Succeeds Memory-OS Architecture (V5).
  • Memory System — the seam, backends, write protocol, recall loop, storage layers, V5-14 target gap.
  • Experience & Dreaming — reflection (backward), scheduled learning (forward), heat policy, dreaming, the scheduler.
  • Opinions & Gates — the four named opinion surfaces (done · good · efficient · how-we-engineer) and the request-by-name model.
  • Personas — the persona tier, the ~11-persona roster, the gate, launch modes, role-retirement.
  • Model + effort routing — the T0…T4 tier scale (Claude + Gemini), the persona→tier map, the tier: manifest axis.

Evolution & architecture

• Agent Memory Evolution V1→V4 — the full HLD: where Agent M started, how it grew, where it's going.
• Device-Wide Architecture — the device-wide design Agent M targets.
• Memory-OS Architecture (V5, superseded) — the V5 memory-OS HLD, kept as the historical arc record; superseded by AgentM HLD.
• The persona tier — the third classification above the substrate/plugin binary: a standing concern that composes capabilities it does not own (rememberer = degenerate persona; V5-11 chief-of-staff = first real persona). Refines ADR 0011 · pairs with ADR 0016.

Documentation & tooling

• Seven-Section Wiki Convergence — converging agentm's documentation spec + tooling onto the seven-section wiki taxonomy crickets standardized (amend ADR 0004 · retire the duplicate diataxis-author copy toward crickets · reshape templates/wiki/).

See also

Architecture · Decisions · Home