# Migrate

> Preview metadata migration or convert ADRs between MADR, Nygard, and legacy canonical profiles.

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

---


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

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

1. Run `adr-migrate --plan` first, then show `--dry-run` output.
2. For selective-context enrichment, run `adr-migrate --suggest-retrieval --dry-run`; make clear that candidates are read-only and require human approval.
3. Use `--to-profile madr` by default; support `nygard` and `canonical`, and apply only after explicit confirmation.
4. Preserve prose, frontmatter, history, links, references, and enforcement; verify with `--check` and lint.

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