# refactor

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

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 489 у репозитория
- Автор: josstei
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/refactor.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/refactor

## Что делает

Refactor выполняет пошаговую модернизацию кода, сохраняя логику работы нетронутой. Внутри действует жёсткий протокол последовательности: сначала безопасные переименования, затем выделение методов и классов, перенос полей и только потом внедрение интерфейсов или полиморфизма. Для анализа структуры агент использует поиск по файлам через grep и glob, а для правок — точечную замену фрагментов.

Субагент ограничен лимитом в 25 шагов (`max_turns`) и рамками файлов, явно переданных в задаче. Если для рефакторинга требуется изменить код за пределами заданного скоупа, он завершает доступные правки внутри границ и фиксирует зависимость для отдельной задачи, не трогая внешние файлы без спроса.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/refactor.md

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

## Примеры запросов агенту
- Проведи рефакторинг модуля авторизации и раздели его на независимые сервисы
- Вынеси методы обработки платежей из контроллера заказов в отдельный класс
- Устрани дублирование логики валидации в сервисах пользователей

## Похожие
- [oma-refactor](https://affpapa.org/nevibecode/skills/oma-refactor.md) — скилл · ★ 1472 у репозитория
- [refactor-legacy-code](https://affpapa.org/nevibecode/skills/refactor-legacy-code.md) — скилл · 611 установок
- [refactoring-patterns](https://affpapa.org/nevibecode/skills/proffesor-for-testing-refactoring-patterns.md) — скилл · 140 установок
- [technical-debt-manager](https://affpapa.org/nevibecode/agents/technical-debt-manager.md) — субагент · 857 установок
- [codescene-mcp-server](https://affpapa.org/nevibecode/mcp/codescene-mcp-server.md) — MCP-сервер · ★ 82 у репозитория
- [refactor-code](https://affpapa.org/nevibecode/commands/refactor-code.md) — команда · 4890 установок

Из того же набора: [josstei/maestro-orchestrate](https://affpapa.org/nevibecode/by/josstei/maestro-orchestrate.md) — 40 карточек

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

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