# Upgrade

> Refresh ADR Kit project artifacts after a plugin update while preserving local edits and unrelated instructions.

- Skill: `rvdbreemen/upgrade-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rvdbreemen/upgrade-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rvdbreemen/upgrade-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/upgrade-2

---


<!-- Generated by scripts/build-client-adapters.py from clients/workflows.json; schema v1; client codex-cli. -->
# Upgrade ADR Kit project artifacts (the upgrade mode of setup)

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

1. Preview ADR migration without applying it.
2. Refresh only ADR Kit-owned guide, instruction blocks, and pre-commit wrapper; preserve user-owned guidance.
3. Finish with strict lint and report all migration notices.

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