adr-newlisted
Install: claude install-skill cahenesy/throughline
# New ADR
Record a durable architectural decision or established pattern. ADRs are the
sparse, forward-feeding memory loaded into every future call to /tdd-author
so keep the bar high and the set small.
## Rules — enforce strictly
- APPEND-ONLY ON SUBSTANCE. Once an ADR is `accepted` (or built upon), its
Context/Decision/Consequences are historical record. Light editorial touch-ups
are fine — typos, a broken link, flipping `proposed`→`accepted`, marking
`superseded by`. Anything that changes the SUBSTANCE of the decision is a new
superseding ADR, never an edit. Rewriting the body destroys the record of what
was decided and why at the time.
- Assign the next zero-padded number: highest existing in `docs/adr/` + 1.
- Every ADR has Status: `proposed` | `accepted` | `superseded by NNNN`.
- To reverse or replace a prior decision: create a NEW ADR with
`Supersedes: NNNN` that captures the new context, decision, and consequences
in FULL; then change ONLY the old ADR's Status line to `superseded by <new>`.
Never delete the old ADR. Update any design docs that referenced the old ADR's
substance to point at the new one.
- Challenging an accepted decision is encouraged when new information surfaces (a
dependency's license, a competitor's architecture, a UX constraint) — say so
plainly and supersede. Changing a decision early is far cheaper than discovering
it was wrong after weeks of building on it. ADRs are accepted, not immutable.
- After writing, update `do