Migrate

Orchestrates monorepo migrations: import path changes, package renames, module moves. Uses scripted bulk operations (never file-by-file edits), deduplicates against existing work, verifies types at each step, and commits atomically.

Do NOT load this skill when the change only touches one or two files, the user wants exploratory refactoring, or the package boundary decision is still unresolved.

NEVER

• Never use the Edit tool file-by-file for bulk migrations — use grep | xargs sed instead (10x faster, no missed files).
• Never start without a deduplication check — duplicate migrations cause import conflicts that are hard to debug.
• Never commit without typecheck — silent import breakage is worse than a failed commit.
• Never skip the residual check — 2 files left pointing to the old path cause subtle runtime errors.
• Never migrate without a manifest — you must know the blast radius before touching anything.
• Never run bulk sed without confirming the manifest count with the user if > 20 files or if packages/ is touched.

Decision Tree