Skip to main content

Architecture Decision Records

An ADR records a decision that establishes or alters a contract another component depends on: CRD shapes, the Decision JSON, header semantics, the snapshot format, extension seams, evaluation order, toolchain policy. Ordinary implementation details do not get an ADR.

Conventions

  • One decision per file, named NNNN-kebab-title.md, zero-padded to four digits, numbered sequentially. Numbers are never reused.
  • Headings, in order: # ADR-NNNN: Title, ## Status, ## Context, ## Decision, ## Consequences, ## Alternatives considered.
  • Status is Draft, Accepted, or Superseded by ADR-XXXX.
  • Reversals get a new ADR; the old one's Status line is updated. ADRs are never retro-edited beyond the Status line and typo fixes.

Index

#TitleStatus
0001routeD is a decision layer, not a gatewayAccepted
0002Rust for all runtime components; ONNX for local inferenceAccepted
0003Security constraints are evaluated before cost optimizationAccepted
0004Extension seamsAccepted
0005Cargo workspace layout and containerized toolchainAccepted
0006Classifier seam and degradation semanticsAccepted
0007Header trust model: untrusted headers only restrictAccepted
0008Single-source policy compiler and canonical snapshot hashAccepted
0009Cost model, currency and token estimationAccepted
0010Policy precedenceAccepted
0011Golden decisions live in examples/Accepted
0012Inline forwarder and streamingAccepted
0013Telemetry schemaAccepted
0014Operator reconciliation and snapshot distributionAccepted
0015Admission validationAccepted
0016Artifact resolution and the ONNX model contractAccepted
0017ext_proc processing contractAccepted
0018Feedback records and the learned router contractAccepted
0019Supply chain and release engineeringAccepted
0020Decision API authentication seamAccepted
0021Mutual TLS for snapshot distributionAccepted
0022Cosign signature verification for model artifactsAccepted