# version-delta-analyst

Ищет, что именно сломается в вашем коде при переходе на новую версию того же стека, и отдаёт каталог правок с привязкой к строкам.

- субагент · `type=agent` · Claude Code · ★ 44770
- Автор: Anthropic · официальный репозиторий Anthropic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/code-modernization/agents/version-delta-analyst.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/version-delta-analyst

## Что делает

Субагент работает с апгрейдами внутри одного стека: .NET Framework 4.8 → .NET 8, Java 8 → 17/21, Spring Boot 2 → 3. Он не переписывает код заново, а ищет конкретные различия между версиями, которые задевают именно ваш проект. На выходе — каталог дельт: удалённые или изменённые API, тихие поведенческие сдвиги, правки системы сборки и зависимости без поддержки целевой версии.

Каждая дельта оформляется карточкой: категория, `file:line` и число мест, старая и новая конструкция, класс правки (механическая или требующая решения), радиус поражения, минимальное исправление и тест, который надо написать до изменения. Инструменты у субагента — `Read`, `Glob`, `Grep`, `Bash`. Там, где для стека есть готовый миграционный инструмент, он его находит и запускает, а остаток — суждения, которые инструмент не делает — берёт на себя. Запускать инструменты разрешено только на копии кода в временной папке: сборки и пробные прогоны пишут файлы и тянут плагины, а исходный каталог трогать нельзя. Если инструмент не смог отработать, это фиксируется отдельно, а не выдаётся за полное покрытие.

Часть «одностаковых» переходов на деле оказывается переписыванием — Python 2 → 3 с повсеместными `str`/`bytes`, AngularJS → Angular. Там минимальный диф не работает, и субагент помечает такие случаи для `/code-modernization:modernize-transform`. Для Java 17 отдельно стоит помнить про строгую инкапсуляцию JPMS: `setAccessible` и глубокая рефлексия падают в рантайме, а не на компиляции.

## Установка

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

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- найти удалённые API, которые вызывает ваш код, до начала апгрейда
- отловить тихие изменения поведения, которые компилируются, но дают другой результат
- перевести проект с `packages.config` на `PackageReference` и на SDK-style `.csproj`
- оценить, какие зависимости не поддерживают целевую версию рантайма
- разметить места, где нужен характеризационный тест до правки

## Примеры запросов агенту
- Проанализируй переход с .NET Framework 4.8 на .NET 8 и собери каталог дельт по этому репозиторию
- Что сломается при апгрейде Spring Boot 2 на 3? Дай карточки с `file:line`
- Проверь миграцию Java 8 на 17: где удалённые JDK API и проблемы с рефлексией

## Похожие
- [modernization-workflow](https://affpapa.org/nevibecode/plugins/modernization-workflow.md) — плагин · ★ 40451
- [java-coding-standards](https://affpapa.org/nevibecode/skills/java-coding-standards.md) — скилл · 5100 установок
- [convert-jpa-to-spring-data-cosmos](https://affpapa.org/nevibecode/rules/convert-jpa-to-spring-data-cosmos.md) — правило · ★ 40451
- [code-reviewer](https://affpapa.org/nevibecode/agents/voltagent-community-code-reviewer.md) — субагент · 31050 установок
- [debugger](https://affpapa.org/nevibecode/agents/debugger.md) — субагент · 13459 установок

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

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

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