# modernize-transform

Команда modernize-transform для Claude Code переписывает один устаревший модуль на целевом стеке и тестами проверяет, что поведение сохранилось. Используется при поэтапном переносе системы.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 47914 у репозитория
- Автор: Anthropic · официальный репозиторий Anthropic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/code-modernization/commands/modernize-transform.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/modernize-transform

## Что делает

Команда переписывает один модуль устаревшей системы на целевом стеке и проверяет, что поведение осталось прежним. Код берётся из `legacy/<system>`, результат попадает в `modernized/<system>/<module>/`. Если модуль или стек не заданы, она читает `analysis/<system>/MODERNIZATION_BRIEF.md` и берёт первый подходящий модуль оттуда.

Сначала проверяется тулчейн и составляется план. Пока вы его не одобрите, код не пишется. Потом субагент test-engineer пишет характеризационные тесты, а вы их подтверждаете. Дальше идёт реализация в `src/main` в идиомах целевого стека, не по структуре старого кода. В конце тесты запускаются, считается число выполненных кейсов, и код намеренно ломается, чтобы убедиться: хотя бы один тест краснеет.

Без рабочих рантайма, пакетного менеджера и тест-фреймворка целевого стека команда остановится до плана. Если старый код не запускается локально, эквивалентность проверяется по записанным трассам и эталонным фикстурам, и это записывается в `TRANSFORMATION_NOTES.md`. Когда запуск возможен, `scripts/compare.py` сравнивает выходы двух версий и пишет `analysis/<system>/EQUIVALENCE.json`.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin install code-modernization@claude-plugins-official
```

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/code-modernization/commands/modernize-transform.md

## Когда брать
- переписать один устаревший модуль на выбранном стеке
- зафиксировать текущее поведение модуля тестами до переписывания
- сравнить выходы старой и новой версий на одинаковых входах
- проверить, что тесты вообще способны упасть
- выбрать следующий модуль для миграции по плану из `MODERNIZATION_BRIEF.md`

## Примеры запросов агенту
- Выполни `/code-modernization:modernize-transform <system> <module> <target-stack>` и сначала покажи план.
- Запусти `/code-modernization:modernize-transform <system>`: модуль и стек возьми из `MODERNIZATION_BRIEF.md`.
- Перепиши следующий модуль системы `<system>` командой `/code-modernization:modernize-transform` и скажи, сколько кейсов эквивалентности выполнено.

## Похожие
- [doc-and-modernize](https://affpapa.org/nevibecode/skills/doc-and-modernize.md) — скилл · 108 установок
- [legacy-modernizer](https://affpapa.org/nevibecode/agents/legacy-modernizer.md) — субагент · 826 установок
- [code-refactoring-legacy-modernizer](https://affpapa.org/nevibecode/agents/code-refactoring-legacy-modernizer.md) — субагент · ★ 42780 у репозитория
- [working-with-legacy-code](https://affpapa.org/nevibecode/skills/working-with-legacy-code.md) — скилл · 3700 установок
- [legacy-modernize](https://affpapa.org/nevibecode/commands/legacy-modernize.md) — команда · ★ 42780 у репозитория
- [golang-modernize](https://affpapa.org/nevibecode/skills/golang-modernize.md) — скилл · 42700 установок

Из того же набора: [anthropics/claude-plugins-official](https://affpapa.org/nevibecode/by/anthropics/claude-plugins-official.md) — 175 карточек

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

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