What problem does it solve? Rolling back an accepted Architecture Decision Record without corrupting project history is error-prone: hand-editing statuses or deleting records breaks the decision graph. This Skill retires a decision the correct way by atomically pairing the old record with a successor, flipping only the old record's header status to superseded while leaving its content byte-identical. ## Core Features & Use Cases - Two-sided supersession: The adr MCP tool's supersede action links both records — the old one points to its successor, the successor carries the Supersedes link back — in one validated operation. - Two successor modes: Create a new proposed skeleton record from a title, or pair an already-drafted existing record as the replacement. - Fail-closed refusals: Clear refusal table covering already-superseded records, self-supersession, unparseable headers, slug failures, and numbering conflicts, with a path forward for each. - Use Case: Your team decided on REST in ADR-0007 but is moving to gRPC. Run this Skill to mark ADR-0007 as superseded, generate a linked draft for the gRPC decision, then fill it in and route it through the normal review and accept gates. ## Quick Start Ask the assistant to supersede ADR-0007 with a new decision titled "Adopt gRPC for inter-service communication" using the adr supersede workflow.
