Skip to content

docs/adr has a number hole at 0107 — either a withdrawn record with no tombstone, or a lost file #6676

Description

@os-zhuang

Out-of-scope finding from #4585 / PR #6668 (surfaced while confirming ADR number 0123 was free; filed by the engine-core PM on the dev's behalf). Recorded, not claimed.

Fact (origin/main, 2026-08-08)

docs/adr/ runs 0106-* then 0108-* — there is no 0107-* file. check:adr-anchors does not object: it audits decision-anchor collisions, not numbering gaps.

Why it is worth a card at all

If 0107 was drafted and withdrawn, nothing stops a future author from re-using the number for something unrelated — and then two eras of cross-references (commits, issues, chat rulings that said "ADR-0107") point at different documents. A one-paragraph tombstone file ("0107 — withdrawn/never assigned, do not reuse") closes that permanently. If instead a record was lost, that is worth knowing now rather than at the moment someone needs it.

Scope if promoted

XS: git log-archaeology to determine which case it is, then either a tombstone file or a restoration. Optionally teach check:adr-anchors to flag future gaps (separate judgment — gaps may be legitimate).

Refs: #4585, PR #6668 (report out_of_scope_findings).

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions