4.x ADRs

Architectural Decision Records for the 4.x line. New ADRs land here.

Era history

The 4.x line began with the 4.0.0 release-candidate cycle (4.0.0rc1, 2026-09-13). The cycle's intent is declared in docs/changelog/4.0.0.md and executed against the 4.0.0 milestone roadmap.

This folder opened on 2026-09-30. ADRs written earlier in the 4.0.0 cycle (dated 2026-09-13 to 2026-09-29) stay in docs/adr/3.x/: ADRs are immutable and moving them would break every link to them. Read the two folders together for the full 4.0.0 decision record.

Naming

  • YYYY-MM-DD-N-descriptive-title-with-dashes.md where N is 1, 2, 3, … per ADR landed on a given date.

After adding an ADR file, run (from the repository root, so scripts resolves as a package) python -m scripts.docs.freshen_adr_inventory docs/adr/4.x/<your-adr>.md to update the page-inventory lockfile and add the row to the index table below.

Status Conventions

  • Accepted means the decision remains current policy.
  • Superseded means a newer ADR replaced the decision; keep the file for history, but do not implement from it.
  • Deprecated means the direction is in active retirement and should not receive new work.

Template

Use the shared template at docs/architecture/adr-template.md.

Index

Date Title
Edit this page