# migration-guide

Команда анализирует проект и составляет пошаговый план миграции с откатом, проверками и разбором несовместимых изменений. Пригодится при смене базы данных, библиотек или облака.

- команда · `type=command` · Claude Code · 281 установка
- Автор: davila7
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/documentation/migration-guide.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/migration-guide

## Что делает

Команда запускает аудит репозитория перед обновлением стека. Сначала ассистент читает `package.json`, `requirements.txt`, историю миграций и файлы схемы БД через `Bash`, чтобы зафиксировать текущее состояние систем и зависимостей. На этой основе генерируется подробный документ.

В итоговый план входят шаги обновления, разбор несовместимых изменений с примерами кода «до и после», стратегия тестирования и скрипты отката. Команда поддерживает аргументы `framework`, `database`, `cloud`, `architecture` и флаг `--version-upgrade`.

Для точного анализа требуются стандартные файлы конфигураций вроде Docker, Terraform или lock-файлов, иначе окружение придётся описывать вручную. Команде открыты инструменты `Read`, `Write`, `Edit` и `Bash`.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --command documentation/migration-guide
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/migration-guide.md` — Вызов — /migration-guide. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/migration-guide.md` — Вызов — /prompts:migration-guide. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/migration-guide.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/migration-guide.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/documentation/migration-guide.md

## Когда брать
- составить план перехода на новую версию фреймворка
- расписать сценарии отката и резервного копирования
- задокументировать ломающие изменения с примерами кода
- подготовить стратегию тестирования при обновлении схемы БД

## Примеры запросов агенту
- /migration-guide framework
- /migration-guide database
- /migration-guide --version-upgrade

## Похожие
- [revise-claude-md](https://affpapa.org/nevibecode/commands/revise-claude-md.md) — команда · ★ 44770

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 651 карточка

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

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