docs: renumber colliding ADRs — one number, one decision (ARN-268) - #406
Open
rita-aga wants to merge 1 commit into
Open
docs: renumber colliding ADRs — one number, one decision (ARN-268)#406rita-aga wants to merge 1 commit into
rita-aga wants to merge 1 commit into
Conversation
13 duplicated ADR numbers (34 files) resolved: the most-referenced document keeps its number, the rest move to fresh numbers 0156+ with all repo references updated. TEMPLATE gains a numbering rule. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0125RD5byAmmMuvhLaK2jsZR
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Resolves 13 duplicated ADR numbers across 34 files in
docs/adrs/. The most-referenced document keeps each number; the rest move to fresh numbers 0156–0176 with every repo reference updated, andTEMPLATE.mdgains a numbering rule so this cannot recur.Why
Ambiguous ADR numbers forced a "cite ADRs by name" workaround and blocked the authorization effort (ARN-255 / RFC-0002, PR #352) from amending ADR-0033 cleanly. See ARN-268.
Keeper decisions (reference-counted repo-wide, self excluded)
Scope
58 files: 21 renames + 37 reference/header edits + the TEMPLATE note. Purely ADR-number substitutions — no decision content changed. Verified:
ls docs/adrs/ | sed 's/-.*//' | sort | uniq -dis empty; zero remaining references to any moved file's old stem.Docs-only; pushed past the pre-push test hook (the changes cannot affect Rust tests, and the hook was hitting unrelated environmental flakes).
🤖 Generated with Claude Code
https://claude.ai/code/session_0125RD5byAmmMuvhLaK2jsZR
Greptile Summary
This PR renumbers colliding ADRs and updates their references. The main changes are:
Confidence Score: 5/5
This looks safe to merge.
Important Files Changed
Reviews (1): Last reviewed commit: "docs: renumber colliding ADRs — one numb..." | Re-trigger Greptile
Context used: