code-refactoring-legacy-modernizer — субагент для Claude Code
Помогает безопасно обновлять устаревший код, мигрировать фреймворки и распиливать монолиты по паттерну Strangler Fig. Пригодится при закрытии техдолга без риска сломать прод.
/plugin marketplace add wshobson/agents
/plugin install code-refactoring@claude-code-workflowsЧто делает 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-workflows2Вручную: положить файлы
.claude/agents/legacy-modernizer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/legacy-modernizer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/legacy-modernizer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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