Skip to content

ADR Index

Architecture Decision Records live here.

Naming convention:

  • NNNN-short-title.md (for example 0001-boundary-enforcement.md)

Required sections:

  • Problem
  • Non-goals
  • Public API
  • Invariants
  • Test plan

Start from 0000-template.md.

Latest ADR:

  • 0020-pages-hosted-mkdocs-snapshot.md
  • 0021-pages-hosted-python-api-reference.md
  • 0022-dashboard-png-export-surface.md
  • 0023-dashboard-read-model-v1-endpoints.md
  • 0024-dashboard-timeline-and-heatmap-export-surfaces.md
  • 0026-storage-adapter-boundary-and-decision-spike.md
  • 0027-pipeline-ingestion-resilience-and-canary.md
  • 0028-qa-evaluation-harness-and-calibration-gates.md
  • 0029-nlp-provider-resilience-and-insight-calibration.md
  • 0030-openapi-snapshot-and-hosted-api-reference.md
  • 0031-keycloak-oidc-auth.md
  • 0032-batch-pipeline-re-zero-benchmark.md
  • 0033-sentence-and-dialogue-extraction-details.md
  • 0034-narrative-essence-extraction-profiles.md