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

Architectural Decision Records

Meridian uses Michael Nygard's ADR format to capture the why behind significant choices. ADRs are immutable once "Accepted"; we supersede them rather than edit them.

Lifecycle: Proposed → Accepted → (later) Superseded by ADR-NNNN / Deprecated.

Index

IDStatusTitle
0001AcceptedDual-queue vs. priority weights
0002AcceptedWorkspace tri-crate layout
0003AcceptedDashMap for per-request state
0004AcceptedKV tier promotion policy
0005AcceptedBenchmark methodology
0006AcceptedDisagg KV transfer protocol
0007AcceptedRelease and versioning policy
0008AcceptedRequest preemption policy

Writing a new ADR

  1. Copy template.md to NNNN-short-kebab-title.md.
  2. Open as Proposed; merge as Accepted after PR review.
  3. If a later ADR supersedes this one, mark this one Superseded by ADR-NNNN in a new commit — never edit the body of an accepted ADR.