Skip to content

Architecture Decision Records

The canonical ADR log lives in ARCH.md at the repo root. Each SDK-level decision is recorded there with the Options-considered → Decision → Consequences shape.

Key ADRs to skim first:

  • ADR-001 Two-layer SDK (handwritten + generated)
  • ADR-003 Backend routes under /api/v1/
  • ADR-007 OpenTelemetry is opt-in
  • ADR-012 openapi-python-client is the codegen tool
  • ADR-014 Drift protection (CI regen + contract tests)
  • ADR-015 Streaming ingest endpoints aren't SDK surface
  • ADR-016 Preprocess openapi.json before generation
  • ADR-017 SDK is bearer-token only — no email/password login