← ClaudeAtlas

adr-newlisted

Create a new Architecture Decision Record with append-only, status-gated supersession, and update the ADR index. Invoke with /adr-new, or let /tdd-author invoke it on approval of an ADR action (this skill stays model-invocable for that reason).
cahenesy/throughline · ★ 2 · AI & Automation · score 75
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