# refactor-planner

Субагент refactor-planner разбирает структуру кода и пишет пошаговый план рефакторинга с оценкой рисков. Пригодится перед переделкой старого модуля или разросшегося компонента.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 10055 у репозитория
- Автор: diet103
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/diet103/claude-code-infrastructure-showcase/tree/HEAD/.claude/agents/refactor-planner.md
- Обновлён: 2026-07-13
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/refactor-planner

## Что делает

Агент ведёт себя как старший архитектор. Он читает структуру проекта: как разложены файлы, где проходят границы модулей, что дублируется, какие части сильно связаны между собой и где нарушены принципы SOLID. Отдельно смотрит на покрытие тестами и на то, насколько код вообще можно тестировать.

На выходе получается markdown-документ: краткое резюме, анализ текущего состояния, найденные проблемы, план по фазам, риски, стратегия тестирования и метрики успеха. Проблемы разбиты по серьёзности (критичные, существенные, мелкие) и по типу. Для каждой фазы агент описывает критерии приёмки, оценку трудозатрат и способ отката. Файл он сохраняет в каталог документации, обычно `docs/refactoring/` или `documentation/refactoring/`, с именем вида `[feature]-refactor-plan-YYYY-MM-DD.md`.

Если в проекте есть `CLAUDE.md`, агент сверяет план с ним, поэтому соглашения команды лучше записать туда заранее. Вызываться он может и без прямой просьбы: хватит сказать, что компонент разросся или один и тот же код повторяется в нескольких сервисах. Для Codex файл агента лежит в `.codex/agents/refactor-planner.toml`.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/diet103/claude-code-infrastructure-showcase/tree/HEAD/.claude/agents/refactor-planner.md

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

## Примеры запросов агенту
- Используй субагента refactor-planner: нужно перевести модуль аутентификации на современные паттерны.
- Запусти refactor-planner для компонента дашборда, он стал слишком большим, нужен план рефакторинга.
- Через refactor-planner разбери дублирование между сервисами и сохрани план в `docs/refactoring/`.

## Похожие
- [refactor-expert](https://affpapa.org/nevibecode/agents/refactor-expert.md) — субагент · ★ 788 у репозитория
- [tdd-refactor](https://affpapa.org/nevibecode/commands/tdd-refactor.md) — команда · ★ 42780 у репозитория
- [general-refactor-expert](https://affpapa.org/nevibecode/agents/general-refactor-expert.md) — субагент · ★ 372 у репозитория
- [python-refactor-expert](https://affpapa.org/nevibecode/agents/python-refactor-expert.md) — субагент · ★ 372 у репозитория
- [frontend-refactor-planner](https://affpapa.org/nevibecode/skills/frontend-refactor-planner.md) — скилл · 321 установка
- [clean-architecture](https://affpapa.org/nevibecode/skills/clean-architecture.md) — скилл · 8000 установок

Из того же набора: [diet103/claude-code-infrastructure-showcase](https://affpapa.org/nevibecode/by/diet103/claude-code-infrastructure-showcase.md) — 16 карточек

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

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