Skip to content

docs: renumber colliding ADRs — one number, one decision (ARN-268) - #406

Open
rita-aga wants to merge 1 commit into
mainfrom
claude/adr-renumber
Open

docs: renumber colliding ADRs — one number, one decision (ARN-268)#406
rita-aga wants to merge 1 commit into
mainfrom
claude/adr-renumber

Conversation

@rita-aga

@rita-aga rita-aga commented Jul 18, 2026

Copy link
Copy Markdown
Collaborator

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, and TEMPLATE.md gains 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)

  • 0033 → platform-assigned-agent-identity (7 refs across identity code; the ADR the auth effort builds on)
  • 0032 → granular-cedar-policy-storage
  • 11 more collisions resolved by reference count, ties broken alphabetically. Full old→new mapping and per-keeper evidence in the commit body.

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 -d is 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:

  • Renamed duplicated ADR files to unique numbers 0156–0176.
  • Updated ADR citations in docs, Rust comments, and SQL comments.
  • Added a numbering rule to the ADR template.

Confidence Score: 5/5

This looks safe to merge.

  • No blocking issues found in the changed code.

Important Files Changed

Filename Overview
docs/adrs/TEMPLATE.md Adds a clear rule for assigning the next ADR number and forbidding duplicate or reused numbers.
docs/adrs/0156-temper-native-agent.md Renumbers the Temper-native agent ADR from its old colliding number.
docs/adrs/0157-host-connect-call.md Renumbers the host connect call ADR and updates its related ADR reference.
docs/adrs/0158-platform-store-trait-and-sim-platform-dst.md Renumbers the platform store trait and simulation DST ADR.
docs/adrs/0159-sandbox-fsync.md Renumbers the sandbox fsync ADR and updates its related ADR reference.
docs/adrs/0160-tenant-database-isolation.md Renumbers the tenant database isolation ADR.
docs/adrs/0161-composite-action-kernel-primitive.md Renumbers the composite action kernel primitive ADR and updates related citations.
docs/adrs/0166-field-overflow-inline-ceiling.md Renumbers the field-overflow inline limit ADR and updates affected references.
docs/adrs/0168-optimistic-concurrency-retry.md Renumbers the optimistic concurrency retry ADR and updates retry-path references.
docs/adrs/0169-wasm-field-stream-host-fn.md Renumbers the WASM field read host function ADR and updates related references.

Reviews (1): Last reviewed commit: "docs: renumber colliding ADRs — one numb..." | Re-trigger Greptile

Context used:

  • Context used - CLAUDE.md (source)
  • Context used - AGENTS.md (source)

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
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.

1 participant