Repository navigation
Prune the ADRs aggressively #384
Description
Question
Prune the ADRs, aggressively.
37 plugin ADRs plus 36 repo ADRs. tickets.md cites six of them in its first eight lines. Every ADR
is context a session pays for, and a superseded one is worse than absent: it is a wrong instruction an
agent will follow, and more ADRs mean more surface for hallucination.
Deleting lib/ reverses ADR-0018 (tested lib for deterministic IP), ADR-0021 (earns-its-place),
ADR-0031 (three-tier Method resolution), and narrows ADR-0023 §5. Record that once.
Then prune. Retire any ADR whose subject no longer exists — a deleted module, a retired Box, a
superseded decision. Superseded ADRs are removed, not archived: decision 15 is explicit that keeping
them is a source of conflict for agents. Decide nothing new here; this is deletion, not design.
Acceptance criteria
- One new ADR records the reversal of ADR-0018, ADR-0021 and ADR-0031 and the narrowing of
ADR-0023 §5. - Every ADR whose subject no longer exists is removed, and the index in the matching
README.md
matches what remains. - No surviving ADR references a removed one.
- No new decision is introduced by this ticket.
- The remaining ADR count is stated, before and after.
Activity
orioltf commentedon Aug 14, 2026
How to start this session
Produces: one ADR recording the reversals, every dead ADR removed, both indexes correct.
/wayfinder 373 #384. It claims this ticket./domain-modeling— it owns ADR conventions in this repo.README.md.Traps
apps/claude-code/unic-archon-dlc/docs/adr/and repo-rootdocs/adr/.A plugin ADR number quoted in an issue means the plugin-local set — verify the path before editing.
conflict for agents.
orioltf commentedon Aug 19, 2026
Scope addition from #381 (2026-08-20)
Beyond the ADRs:
docs/redesign/(14 files) still names modules #381 deleted. Same class as a superseded ADR — context that invites hallucination (decision 15). Prune or mark it here. The four Box YAML comments that named deleted modules are fixed in #381's own PR; the redesign docs are the remainder.