adr-deprecatelisted

This skill should be used when the user asks to 'deprecate an ADR', 'mark an ADR as obsolete', 'retire an architectural decision', 'flag an ADR as no longer applicable', or when an existing architectural decision is no longer relevant and should be marked as deprecated while preserving history.
samrom3/claude-hyper-plugs · ★ 1 · Data & Documents · score 68

Install: claude install-skill samrom3/claude-hyper-plugs

# adr-deprecate Marks existing ADR deprecated, records reason, updates dir's README.md index. > ADRs **additive only**: never delete or heavily rewrite accepted ADR. History preserved — old ADR stays readable. --- ## Step 1 — Discover ADR directories Same discovery as `adr-create` Step 1: 1. Search `CLAUDE.md` for heading containing `ADR Locations`. Collect bullet paths into `adr_dirs`, strip inline `# comments`. 2. If not found, fall back: scan for `docs/adrs`, `decisions`, `architecture/decisions`. 3. If empty, inform user and stop. ## Step 2 — Select target directory Multiple dirs → ask user or auto-suggest based on recent file context (same as `adr-create` Step 2). Wait for confirmation. ## Step 3 — Identify the ADR to deprecate 1. List files in `target_dir` matching `NNNN-*.md`. 2. If invoked with ADR number (e.g., `/adr-deprecate 3`): find file matching `0003-*.md`. 3. Otherwise, display list and ask: > Which ADR do you want to deprecate? (enter number or filename) 4. Confirm: `Deprecating: ADR-NNNN — <title>. Proceed? (y/n)` 5. Status already `Deprecated` → warn and stop: `ADR-NNNN is already deprecated.` ## Step 4 — Understand and draft the deprecation Gather context from: 1. **Read ADR in full** — understand what it records and current consequences. 2. **Conversation context** — user may have discussed why decision is obsolete. 3. **Arg** — text after ADR number used as deprecation rationale. Draft: - `deprecation_reason`: one-line summary for `**Depre