Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Architecture decision records

Significant decisions are recorded here in the lightweight ADR format: context, decision, consequences. A new ADR is added when a decision changes the shape of the framework; an existing ADR is never edited after acceptance, it is superseded by a new one. The one exception is a cross reference: a link to the later ADR that details or supersedes a point may be added to an accepted ADR, its text does not change otherwise.

ADRTitleStatus
001Rust and a cargo workspaceAccepted
002Traits as extension pointsAccepted
003Git worktrees for isolationAccepted
004Denylist shell policy with validatorsAccepted
005JSON-RPC over stdio plugin protocolAccepted
006Structured QA verdictsAccepted
007One seam for every user interfaceAccepted
008Trace store and read layerAccepted