Architecture Decision Records

ADRs preserve why consequential decisions were made. Canonical architecture pages still describe current truth; you should not have to mentally patch outdated architecture by replaying ADR history. See the repository-root README.md for documentation precedence.

• 0001 — Canonical docs stay current
• 0002 — Keep the Task lifecycle small
• 0003 — Plans use immutable revisions
• 0004 — Task, Run, Turn, and process are distinct
• 0005 — Agent Adapter is separate from Execution Environment
• 0006 — Separate Driver, Instance, Strategy, and Capability
• 0007 — External side effects use durable Operations
• 0008 — Persist raw provider input before parsing
• 0009 — Raw transcripts live outside SQLite
• 0010 — Facts and agent Claims remain distinct
• 0011 — Review and Verification are revision-bound
• 0012 — Use the user's Git executable
• 0013 — Worktree paths use immutable IDs
• 0014 — Worktree cleanup is recoverability-based
• 0015 — Mutating RPCs are domain commands
• 0016 — Live streaming is not historical storage
• 0017 — Connection health and sync health are separate
• 0018 — Structured escalation uses a Forge-controlled tool
• 0019 — Host gating is independent from Involvement Mode
• 0020 — Managed process launch goes through one boundary
• 0021 — Repository-defined execution requires Project trust
• 0022 — No silent semantic fallback
• 0023 — Provider Probe is separate from Start
• 0024 — Authoritative domain state stays in the core