Decisions

Architecture decisions

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.

Records

• 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

See also

• Home — the wiki landing page.
• Explanation — the narrative rationale behind these decisions.
• Designs — the design docs the larger decisions trace back to.