Skip to content

docs(adr): drop the Status section#72

Merged
wmadden merged 1 commit into
mainfrom
claude/adr-drop-status
Jul 15, 2026
Merged

docs(adr): drop the Status section#72
wmadden merged 1 commit into
mainfrom
claude/adr-drop-status

Conversation

@wmadden-electric

Copy link
Copy Markdown
Contributor

Drop the Status section from ADRs

A per-ADR Proposed / Accepted line goes stale (most just say "Accepted" forever) and adds nothing — the record exists because we made the call. This removes the Status section as a convention and retroactively from every existing ADR.

Where supersession/deprecation lives instead (already true today, now the only place it lives):

  • the superseding ADR names what it replaces, in its Decision / Related;
  • the Index annotates the superseded entry.

No supersession information is lost — the five ADRs whose Status carried real relationship narrative (0014, 0025, 0026, 0027, 0028) already mirror it in their Related sections and the Index.

Changes

  • Template (adr.md) — Status section removed.
  • Guide (90-decisions/README.md) — documents the convention (no Status; where supersession is recorded) and syncs the section list to the template.
  • All 26 existing ADRsStatus section stripped (10 insertions, 139 deletions).

Docs only; behaviour unchanged.

Note

ADR-0029 lives on the in-review secrets branch (#70), not main, so its Status isn't touched here — it'll be dropped on that branch (or as a fast-follow once #70 merges) to comply.

🤖 Generated with Claude Code

A per-ADR Proposed/Accepted line goes stale and adds nothing — the record
exists because we made the call. Supersession and deprecation already live
where readers look: the superseding ADR names what it replaces (Decision /
Related) and the Index annotates the superseded entry. Removes Status from
the template, the guide, and all existing ADRs; no supersession info is lost.

Signed-off-by: willbot <w.a.madden+machine@gmail.com>
Signed-off-by: Will Madden <madden@prisma.io>
@wmadden wmadden merged commit 6deb606 into main Jul 15, 2026
11 checks passed
@wmadden wmadden deleted the claude/adr-drop-status branch July 15, 2026 09:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants