What problem does it solve? Architecture Decision Record collections accumulate decision debt over time: records go stale, contradict current code, duplicate each other, or become obsolete without anyone noticing. This Skill systematically confronts each ADR cluster with current implementation evidence and applies maintainer-approved changes so the decision history stays accurate. ## Core Features & Use Cases - Ranked Cluster Triage: Inventories active ADRs in .red/adr/, groups them into clusters, detects inconsistencies, and recommends where to start based on fresh evidence and review markers. - Proposal-Driven Reverse Grill: Presents one numbered proposal at a time (P01, P02, ...) with evidence, exact operations, alternatives, and a recommendation, requiring an explicit maintainer disposition for every active record. - Full ADR Verb Set: Supports list, group, surface inconsistencies, add, remove, rewrite, merge, split, archive, renumber, and re-index through deterministic planner/apply helpers with rollback. - Use Case: A maintainer suspects several ADRs no longer match the shipped code. The Skill ranks the clusters, confronts one cluster against current code and tests, walks the maintainer through dispositions, previews the exact diff, and lands one coherent cluster change per PR. ## Quick Start Ask the agent to review the active ADR collection, rank the clusters, and recommend which cluster to confront first.
