# migration-engineer

Субагент migration-engineer ведёт мажорные апгрейды фреймворков и библиотек: читает changelog, находит все вызовы изменившегося API и правит по шагам с проверкой после каждого.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 267 у репозитория
- Автор: NYCU-Chung
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/migration-engineer.md
- Обновлён: 2026-04-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/migration-engineer

## Что делает

Субагент для мажорных апгрейдов: Next.js 13→14, Vue 2→3, Tailwind 3→4, React 18→19, мажорные версии TypeScript, переходы между версиями языка. Работа разбита на пять фаз. Сначала разведка — читает официальный гайд апгрейда и changelog между релизами, выписывает все breaking changes в чек-лист. Потом ищет через Grep каждое место, где используется изменившийся API, читает вызовы и делит их на простые переименования, изменения поведения и куски, которые придётся переделывать.

Дальше правки идут по одной категории за раз: обновил `package.json`, поставил зависимости, поправил вызовы, прогнал `tsc --noEmit`, тесты и dev-сервер, закоммитил. Одним большим коммитом не делает — при падении откатывается только последняя категория.

В конце отдаёт отчёт: что изменено, какие файлы затронуты, прошли ли проверки, как откатиться через `git revert`. В инструментах есть `Bash`, `WebSearch` и `WebFetch`. Если политика проекта запрещает агенту ходить в сеть или запускать команды, разведка и проверка не отработают.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add NYCU-Chung/my-claude-devteam
```
В чате агента (не в терминале):
```text
/plugin install devteam@my-claude-devteam
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/migration-engineer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/migration-engineer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/migration-engineer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/migration-engineer.md

## Когда брать
- Перевести проект с Vue 2 на Vue 3, не потеряв ни одного вызова старого API
- Найти все места, где используется метод, удалённый в новой мажорной версии
- Разложить апгрейд Next.js на коммиты, которые откатываются по одному
- Убедиться, что после смены мажора собирается билд и проходит тест-сьют
- Превратить changelog в чек-лист breaking changes до правки `package.json`

## Примеры запросов агенту
- Запусти `migration-engineer` на переход с Next.js 13 на 14: сначала гайд и changelog, потом план миграции.
- Через `migration-engineer` найди все вызовы `useRouter` в `app/` и `components/` и распиши, что менять при апгрейде.
- Веди миграцию Tailwind 3→4 по категориям, после каждой — `tsc --noEmit` и тесты.

## Похожие
- [nextjs-migration-helper](https://affpapa.org/nevibecode/commands/nextjs-migration-helper.md) — команда · 237 установок
- [cra-to-next-migration](https://affpapa.org/nevibecode/skills/cra-to-next-migration.md) — скилл · 960 установок
- [Hedera Agent Kit v4 Migration](https://affpapa.org/nevibecode/skills/hedera-agent-kit-v4-migration.md) — скилл · 612 установок
- [pixijs-migration-v8](https://affpapa.org/nevibecode/skills/pixijs-migration-v8.md) — скилл · 6500 установок
- [openrouter-agent-migration](https://affpapa.org/nevibecode/skills/openrouter-agent-migration.md) — скилл · 383 установки
- [contentful-migration](https://affpapa.org/nevibecode/skills/contentful-migration.md) — скилл · 352 установки

Из того же набора: [nycu-chung/my-claude-devteam](https://affpapa.org/nevibecode/by/nycu-chung/my-claude-devteam.md) — 13 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
