Skip to content

0000-record-architecture-decisions.md

Latest commit

 

History

History
54 lines (43 loc) · 3.69 KB

0000-record-architecture-decisions.md

File metadata and controls

54 lines (43 loc) · 3.69 KB
Raw

ADR 0000: Record architecture decisions

Status: Accepted

Date: 2026-07-23

Decider: Chelsea Kelly-Reif

Context

ExitDrill already records load-bearing decisions as ADRs under docs/decisions/, but the portfolio's canonical discovery path is docs/adr/. Moving accepted records would break durable links and obscure their history; leaving no canonical index makes both people and automation miss decisions that do exist.

Decision

Keep accepted records immutable at their existing paths and use this directory as the compatibility ADR entry point. New decisions continue under docs/decisions/NNNN-title.md. Superseding a decision creates a new ADR and links both records; accepted history is never rewritten to make the current design look inevitable.

Existing accepted records:

  1. ADR 0001: Structural evaluation before a target adapter
  2. ADR 0002: Validate synthetic exercise preflight without a connector seam
  3. ADR 0003: Compare only same-scope aggregate receipts
  4. ADR 0004: Normalize one Directus canary outside the evaluator
  5. ADR 0005: Exercise one CiviCRM target-roundtrip canary
  6. ADR 0006: Observe one authenticated CiviCRM UI surface
  7. ADR 0007: Observe one CiviCRM browser workflow
  8. ADR 0008: Record one automated CiviCRM accessibility observation
  9. ADR 0009: Record one CiviCRM keyboard interaction observation
  10. ADR 0010: Observe one CiviCRM activity-view workflow
  11. ADR 0011: Index CiviCRM evidence without composing it
  12. ADR 0012: Bind indexed CiviCRM artifacts by digest
  13. ADR 0013: Verify CiviCRM index bindings without composing results
  14. ADR 0014: Validate indexed CiviCRM artifact contracts
  15. ADR 0015: Publish a closed CiviCRM verification result
  16. ADR 0016: Observe one CiviCRM contact-summary browser workflow
  17. ADR 0017: Observe one target-generated CiviCRM case-client workflow
  18. ADR 0018: Observe one authenticated CiviCRM browser access denial
  19. ADR 0019: Observe one authenticated CiviCRM browser allow control
  20. ADR 0020: Record one CiviCRM case-search failure

Consequences

  • The standard discovery path now resolves without breaking existing links.
  • Old records remain where their history was established.
  • New decisions remain in the established docs/decisions/ sequence.
  • A future consolidation may add redirects, but must not silently move or rewrite accepted decisions.