-
Notifications
You must be signed in to change notification settings - Fork 0
Decisions
github-actions[bot] edited this page Jun 16, 2026
·
13 revisions
Every load-bearing call in agentm is recorded as an Architecture Decision Record (ADR): the context, the decision with explicit "why X, and why not Y" reasoning, and the consequences with re-audit triggers so a stale assumption surfaces later instead of rotting silently.
This page is the index. The homepage links here once instead of listing every ADR.
- ADR 0001 — Phase-gated workflow
- ADR 0002 — Documentation convention
- ADR 0003 — ProjectsV2 ownership and linking
- ADR 0004 — Diátaxis documentation spec
- ADR 0005 — Drop Codex support; three-adapter scope
- ADR 0006 — Split customizations into
crickets - ADR 0007 — Auto-context into harness phases
- ADR 0008 — Project surface split
- ADR 0009 — On-host state-mode config
- ADR 0010 — Vault internal taxonomy
- ADR 0011 — V5 unbundling: slim the dev loop + migrate-to-diataxis
- ADR 0012 — The vault-write protocol (R4 Phase-0 concurrency floor)
- ADR 0013 — The memory↔storage seam: backend selection fails loud, never demotes
- ADR 0014 — The Tier-2 gate: don't fork the loop through the Agent SDK
- ADR 0015 — Capability discovery: the
enhances:runtime - ADR 0016 — The persona tier: a third classification above the substrate/plugin binary
- Home — the wiki landing page.
- Explanation — the narrative rationale behind these decisions.
- Designs — the design docs the larger decisions trace back to.
🔧 How-to
- Your first install
- Install into a project
- Configure a new project
- Update an installed harness
- Cut a release
- Use auto-context in phases
- Use per-project install
- Audit the vault
- Find missing note links
- Use AgentMemory in any agent
- Tune auto-orchestration
- Run without a vault
- Choose a storage backend
- Stand up the memory MCP server
- Installer CLI
- Detection rules
- Project config
- Migration tool
- CI gates
- Repo layout
- Vault lint checks
- Note relatedness signals
- AgentMemory context payload
- Process seam
- Storage seam
- Orchestration bridge
- Vault write protocol
- Queue status lite
- Auto-orchestration config
- Capability resolver
- Persona tier schema
- Compatibility
- Completed features
- Memory MCP tools
🏛️ Architecture
- AgentMemory
- Device-Wide Substrate
- Phases
- Orchestration and Auto-Detection
- Host adapters
- Toolkit interface ↔ crickets