К основному содержанию
субагент CX Codex

code-refactoring-legacy-modernizer — субагент для Claude Code

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

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add wshobson/agents
/plugin install code-refactoring@claude-code-workflows
Открыть на GitHub

Что делает code-refactoring-legacy-modernizer

Субагент выстраивает постепенный перенос старых кодовых баз на современные стеки вроде React, свежих версий Python или Java. Основной принцип здесь — паттерн Strangler Fig. Вместо рискованного переписывания с нуля агент шаг за шагом заменяет компоненты и сохраняет работоспособность системы.

Работа начинается с подготовки. Перед любыми правками субагент сначала генерирует тесты под текущее поведение системы, чтобы зафиксировать логику. На выходе он выдаёт план миграции с этапами, адаптеры для совместимости, процедуры отката и отчёты об устаревших интерфейсах. При поломке отдельного модуля систему легко откатить назад.

Агент настроен на модель Sonnet. Если в проекте нет тестов, он откажется слепо менять код и сначала создаст тестовую базу.

Какие задачи решает

  • Перевести старый проект с устаревшего фреймворка на актуальный стек
  • Покрыть легаси-код тестами перед масштабными изменениями
  • Разбить монолитную архитектуру на микросервисы
  • Заменить хранимые процедуры в базе данных на ORM
  • Настроить адаптеры обратной совместимости и фиче-флаги для постепенного релиза

Примеры запросов агенту

  • Составь план миграции нашего бэкенда с Java 8 на 17 и напиши адаптеры для обратной совместимости.
  • Напиши тесты для старых модулей на jQuery перед тем, как переносить логику в React.
  • Спланируй распил монолита по паттерну Strangler Fig с фазами отката для каждого шага.

Как установить code-refactoring-legacy-modernizer

1Через маркетплейс плагинов

/plugin marketplace add wshobson/agents
/plugin install code-refactoring@claude-code-workflows

2Вручную: положить файлы

.claude/agents/legacy-modernizer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о code-refactoring-legacy-modernizer

Как установить code-refactoring-legacy-modernizer в Claude Code?

Добавьте репозиторий каталога командой /plugin marketplace add wshobson/agents, после чего установите плагин через /plugin install code-refactoring@claude-code-workflows.

Что делает субагент code-refactoring-legacy-modernizer?

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

Какой подход субагент использует при рефакторинге?

Агент опирается на паттерн Strangler Fig, создание адаптеров и фиче-флаги. Он всегда сначала фиксирует поведение тестами и готовит план отката для каждого этапа.

Исходный текст

legacy-modernizer.md · MIT
---
name: code-refactoring-legacy-modernizer
description: Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. Handles technical debt, dependency updates, and backward compatibility. Use PROACTIVELY for legacy system updates, framework migrations, or technical debt reduction.
model: sonnet
---

You are a legacy modernization specialist focused on safe, incremental upgrades.

## Focus Areas

- Framework migrations (jQuery→React, Java 8→17, Python 2→3)
- Database modernization (stored procs→ORMs)
- Monolith to microservices decomposition
- Dependency updates and security patches
- Test coverage for legacy code
- API versioning and backward compatibility

## Approach

1. Strangler fig pattern - gradual replacement
2. Add tests before refactoring
3. Maintain backward compatibility
4. Document breaking changes clearly
5. Feature flags for gradual rollout

## Output

- Migration plan with phases and milestones
- Refactored code with preserved functionality
- Test suite for legacy behavior
- Compatibility shim/adapter layers
- Deprecation warnings and timelines
- Rollback procedures for each phase

Focus on risk mitigation. Never break existing functionality without migration path.

© Seth Hobson · MIT · wshobson/agents

Похожие субагенты

Все субагенты по теме «Код-ревью и рефакторинг» →
code-reviewer официальный Anthropic Проверяет изменения в коде по правилам проекта из CLAUDE.md и ищет существенные дефекты. Запускайте перед коммитом или созданием PR. 31 050установок code-reviewer официальный Anthropic Субагент проверяет изменения в коде на баги, уязвимости и нарушения правил проекта. Подойдёт для ревью перед слиянием изменений. 31 050установок security-auditor официальный Anthropic Субагент ищет уязвимости в коде и объясняет, как их исправить. Запускайте его для проверки проекта перед изменениями или модернизацией. 10 718установок test-engineer официальный Anthropic Субагент фиксирует поведение legacy-кода тестами и сравнивает его с новой реализацией. Подходит перед переписыванием модулей. 9 715установок code-reviewer VoltAgent Community Проверяет изменения в коде на ошибки, уязвимости и проблемы поддержки. Ставьте перед слиянием сложных изменений или аудитом проекта. 31 050установок debugger VoltAgent Community Диагностирует сбои, разбирает логи и устраняет первопричины багов в проекте. Пригодится при падениях сервиса или плавающих ошибках. 13 459установок

Из того же набора508

Весь набор →
codebase-cleanup-test-automator Субагент-тестировщик: ведёт TDD-цикл, генерирует тесты и подключает их к CI. Пригодится, когда тестов мало или они падают без причины. CX Codex ★ 41 823звёзд репо tech-debt Находит технический долг в кодовой базе, оценивает его влияние на разработку и строит план рефакторинга с расчётом окупаемости затрат. CX Codex ★ 41 823звёзд репо refactor-clean Команда разбирает код, находит проблемы структуры и предлагает практичный рефакторинг по принципам SOLID. Подойдёт для очистки поддерживаемого кода без усложнения. CX Codex ★ 41 823звёзд репо context-restore Восстанавливает сохранённый контекст проекта и решения, чтобы продолжить сессию без повторного объяснения задачи. CX Codex ★ 41 823звёзд репо doc-generate Команда анализирует кодовую базу и создаёт документацию для API, архитектуры, кода и пользователей. Она также задаёт автоматизацию её проверки и публикации. CX Codex ★ 41 823звёзд репо code-explain Команда объясняет сложный код, алгоритмы и паттерны проектирования: пошагово, с диаграммами и примерами. Пригодится при разборе чужой кодовой базы. CX Codex ★ 41 823звёзд репо code-documentation-tutorial-engineer Превращает исходный код в пошаговые обучающие материалы и руководства по онбордингу. Субагент раскладывает сложные концепции на понятные уроки с практическими упражнениями. CX Codex ★ 41 823звёзд репо code-documentation-docs-architect Субагент для создания полноценной технической документации из исходного кода. Анализирует архитектуру, паттерны и детали реализации, чтобы собрать длинные руководства и учебные материалы. CX Codex ★ 41 823звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой