Skip to content

Architecture Decision Records

This project uses Architecture Decision Records (ADRs) to document significant technical decisions.

Active ADRs

ADR Title Status
ADR-015 Per-Session Bias Audit Implemented
ADR-016 Structured Rubric Scoring Implemented
ADR-018 Cross-Session Bias Aggregation Implemented
ADR-020 Query Triage Layer Implemented
ADR-022 Tiered Model Selection Implemented
ADR-023 Gateway Layer Implemented
ADR-024 Unified Routing Architecture Implemented
ADR-025 Future Integration Implemented
ADR-026 Model Intelligence Layer Implemented
ADR-027 Frontier Tier Implemented
ADR-028 Dynamic Candidate Discovery Implemented
ADR-029 Model Audition Mechanism Implemented
ADR-030 Enhanced Circuit Breaker Implemented
ADR-031 Evaluation Configuration Implemented

ADR Format

Each ADR follows this structure:

  1. Title - Short descriptive title
  2. Status - Draft, Proposed, Accepted, Implemented, Deprecated
  3. Context - What problem are we solving?
  4. Decision - What did we decide?
  5. Consequences - What are the trade-offs?

Creating New ADRs

  1. Copy the template from docs/adr/ADR-000-template.md
  2. Number sequentially (ADR-034, ADR-035, etc.)
  3. Open PR for discussion
  4. Update status as implementation progresses

See the project GOVERNANCE.md for the decision process.