Skip to content

Architecture Decision Records

This directory holds MADR 4.0 Architecture Decision Records. Each file documents one decision; once accepted an ADR is never edited — it is superseded by a later ADR that links back.

ADR Title Status
0001 Record architecture decisions accepted
0002 Geometric edits only — no retouching accepted
0003 MediaPipe FaceLandmarker + crown segmentation accepted
0004 Detect-once architecture (reusable FaceDetector) accepted
0005 Typer + Rich CLI accepted
0006 Support Python 3.10 through the latest release accepted

Authoring a new ADR

  1. Copy adr/0000-template.md to adr/NNNN-short-slug.md with the next sequential number.
  2. Fill in the sections; keep paragraphs short and action-oriented.
  3. Add a row to the table above.
  4. Open a PR. ADRs are normally accepted on merge; controversial ones are landed as proposed and flipped to accepted once the discussion concludes.