# Migrate

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

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

---


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

Select `adr-kit:migrate` from `/skills`, or ask Copilot to use the `migrate` ADR Kit skill.
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.