unic / unic/unic-agents-plugins

Prune the ADRs aggressively

Open
#384 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc docs p2 wayfinder:task
Dominant language
JavaScript
Stars
1
Forks
0
Avg merge
16h 43m
Merged PRs (30d)
19

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.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the ADR files and matching README.md index, then inspect tickets.md and the referenced decisions. Inventory subjects that no longer exist, including the deleted lib/ context, and verify surviving ADR references before and after removal. Done means the reversal is recorded, obsolete ADRs and references are removed, indexes match, and the before/after counts are stated.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.