Architecture Decision Records

Each ADR captures the context, decision, and consequences for a foundational design choice. ADRs are immutable once accepted — superseding decisions become new ADRs that reference the prior one.

Accepted ADRs

• ADR-001: Two-phase publish — manifest write then atomic _CURRENT swap
• ADR-002: Categorical CEL routing — finite-domain expressions with explicit routing_values
• ADR-003: Run registry & deferred cleanup — durable run records drive loser cleanup
• ADR-004: Consistent writer retry — single RetryConfig shape across writer flavors
• ADR-005: Sharded vector search — per-shard vector indexes with K-amplification merge
• ADR-006: LanceDB vector backend — default high-quality vector backend