# Supersede

> Replace an Accepted ADR with a Proposed successor while preserving history and reciprocal links.

- Skill: `rvdbreemen/supersede-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rvdbreemen/supersede-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rvdbreemen/supersede-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: rvdbreemen (https://skillmd.com/u/rvdbreemen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rvdbreemen/supersede-2

---


<!-- Generated by scripts/build-client-adapters.py from clients/workflows.json; schema v1; client codex-cli. -->
# Supersede an ADR

Invoke explicitly with `$adr-kit:supersede` when needed.
Resolve `<plugin-root>` from this installed skill. Use only bundled,
local ADR Kit tools and follow this canonical workflow:

1. Inspect relationships, draft a Proposed successor, and grill changed forces, alternatives, migration, consequences, evidence, and Open Questions.
2. Require the successor acceptance packet and explicit confirmation, accept the successor first, then use `adr supersede` for the transaction; verify reciprocal links, append-only history, and generated indexes.

Do not contact another model or mutate user-owned instructions.