unic / unic/unic-agents-plugins
Prune the ADRs aggressively
Nobody has claimed this yet.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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