Menu

#104 docs(adr): resolve duplicate ADR-010 and ADR-011 number collisions

open
nobody
2026-05-17
2026-05-17
Anonymous
No

Originally created by: TheoV823

Problem

Two ADR number collisions exist in docs/adr/:

ADR-010 collision

  • ADR-010-automation-artifact-governance.md — older; cross-referenced in CLAUDE.md and ADR-011
  • ADR-010-external-platform-presence-standards.md — newer; landed 2026-05-17

ADR-011 collision

  • ADR-011-knowledge-graph-content-architecture.md — older (2026-05-15, commit 595cec3)
  • ADR-011-harness-complementary-positioning-vocabulary.md — newer (2026-05-16, commit 92338ac)

Complication: ADR-012-conceptual-authority-discipline.md already exists, so the next available numbers are ADR-013 and ADR-014. Any fix must account for the full sequence before renaming.

Current sequence (as of 2026-05-17)

ADR-001 through ADR-009  — unique, no collisions
ADR-010 — TWO files (collision)
ADR-011 — TWO files (collision)
ADR-012 — one file (conceptual-authority-discipline)
ADR-013, ADR-014 — available

Principle

  • Preserve the older file at its current number (it has downstream references).
  • Renumber the newer file to the next available slot.
  • Do not rename casually — grep docs/, site/, .mneme/, CLAUDE.md, and all ADR cross-references before touching filenames.
  • Fix both collisions in one scoped PR to avoid a second renaming pass.

Smallest safe next action

  1. Run grep -r "ADR-010\|ADR-011" docs/ site/ .mneme/ CLAUDE.md to map all references.
  2. Decide on target numbers: ADR-010-external-platform → ADR-013, ADR-011-harness-complementary → ADR-014 (or whichever the next two available slots are at time of fix).
  3. Rename files and update every reference in one commit on a docs/adr-renumber-collisions branch.
  4. Squash-merge with title docs(adr): renumber duplicate ADR-010 and ADR-011 to ADR-013 and ADR-014.

Out of scope for this issue

  • Content edits to any ADR
  • Renumbering ADR-001 through ADR-009
  • Changing the ADR template or numbering policy

Cross-reference

Wave-3 follow-ups doc (docs/plans/2026-05-17-wave-3-followups.md §2) originally scoped ADR-010-external-platform → ADR-012, but ADR-012 is now taken. This issue supersedes that scope with the updated numbering.

Discovered during post-launch cleanup runbook (2026-05-17).

Discussion


Log in to post a comment.

Auth0 Logo