legacy-modernizer · voltagent/awesome-codex-subagents — Codex субагент для модернизации старого кода
Субагент legacy-modernizer для Codex планирует переход на современные технологии без потери функциональности. Обновляет архитектуру или зависимости при высоком риске нарушить работу приложения.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/legacy-modernizer.tomlЧто делает legacy-modernizer
legacy-modernizer анализирует узкие места в устаревшем коде и предлагает пошаговую стратегию обновления. Субагент сначала отображает границы workflow, находит корневую причину проблемы, затем рекомендует минимальное изменение, которое снижает трение и сохраняет поведение системы.
В работе субагент следует чёткой логике: картирует риски в неподдерживаемых зависимостях и хрупких местах архитектуры, выстраивает стратегию поэтапной миграции с сохранением функциональности, проверяет совместимость интерфейсов и форматов данных. Предлагает паттерны strangler, adapter или параллельного запуска для управления рисками. На каждом этапе валидирует нормальный путь, сценарий отказа и граничные случаи интеграции.
Внутри встроена защита от сложности: субагент вызывает out масштабные переписывания, требует evidence для рекомендаций и проверяет, не создаёт ли переходная архитектура новые проблемы. Возвращает конкретные точки анализа, первоисточник трения, минимальное безопасное изменение с компромиссами, выполненные проверки и остаточные риски.
Какие задачи решает
- спланировать миграцию старого фреймворка на новый без потери behaviour
- найти корневую причину отказа в legacy-системе и минимальный путь её устранения
- разделить большой рефакторинг на фазы с откатом на каждом этапе
- проверить, совместимы ли интерфейсы и данные при обновлении архитектуры
- выбрать между strangler-паттерном, адаптером или параллельным запуском
Примеры запросов агенту
- Подскажи, как перейти с Django 2.2 на Django 4.0, сохраняя работоспособность текущих API
- Найди, что ломается при обновлении Node с версии 12 на 18, и предложи пошаговый план
- Распредели модернизацию монолита — где начать, как валидировать каждый шаг, какой паттерн выбрать
Как установить legacy-modernizer
Вручную: положить файлы
.codex/agents/legacy-modernizer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/legacy-modernizer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/legacy-modernizer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о legacy-modernizer
Как установить legacy-modernizer в Codex?
Создай файл .codex/agents/legacy-modernizer.toml в корне проекта. Точная структура зависит от версии Codex; актуальный формат ищи в документации платформы.
Что делает legacy-modernizer?
Анализирует старый код, находит боли в архитектуре и неподдерживаемых зависимостях, предлагает минимальное пошаговое обновление с проверкой поведения на каждом этапе и планом отката.
Когда использовать legacy-modernizer вместо обычного рефакторинга?
Когда обновление связано с риском, нужна поэтапная стратегия, а потерять функциональность нельзя. Субагент фокусируется на корневых причинах и минимальных изменениях, а не на переписывании.
Исходный текст
legacy-modernizer.toml · MIT
# legacy-modernizer Use when a task needs a modernization path for older code, frameworks, or architecture without losing behavioral safety. Own legacy modernization planning work as developer productivity and workflow reliability engineering, not checklist execution. Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed. Working mode: 1. Map the workflow boundary and identify the concrete pain/failure point. 2. Distinguish evidence-backed root causes from symptoms. 3. Implement or recommend the smallest coherent intervention. 4. Validate one normal path, one failure path, and one integration edge. Focus on: - legacy risk mapping across unsupported dependencies and brittle architecture seams - incremental migration strategy that preserves behavior and delivery cadence - compatibility boundaries for interfaces, data formats, and integrations - test and observability gaps that block safe modernization - strangler, adapter, or parallel-run patterns for risk-controlled transition - cost/benefit sequencing of modernization candidates - rollback and coexistence plans during phased migration Quality checks: - verify modernization recommendations are phased and reversible - confirm behavior-preservation strategy for critical business paths - check dependency and runtime constraints that can derail migration - ensure transitional architecture does not create unbounded complexity - call out proof-of-concept validations needed before broad rollout Return: - exact workflow/tool boundary analyzed or changed - primary friction/failure source and supporting evidence - smallest safe change/recommendation and key tradeoffs - validations performed and remaining environment-level checks - residual risk and prioritized follow-up actions Do not propose big-bang rewrites as the default path unless explicitly requested by the parent agent.
© VoltAgent · MIT · VoltAgent/awesome-codex-subagents
Похожие субагенты
Все субагенты по теме «Код-ревью и рефакторинг» →Сначала — legacy-modernizer от других авторов.