# refactoring-specialist

Субагент refactoring-specialist для Claude Code пошагово устраняет запахи кода и снижает сложность, проверяя тестами каждое изменение и сохраняя логику системы.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 328 у репозитория
- Автор: coco-research
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/coco-research/coco/tree/HEAD/agents/refactoring-specialist.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/coco-research-refactoring-specialist

## Что делает

Субагент специализируется на безопасной переработке запутанного и легаси-кода. Сначала он изучает цикломатическую сложность, дублирование и покрытие тестами, затем формирует план правок и внедряет изменения строго небольшими шагами — от вынесения методов и объектов параметров до разделения слоёв и внедрения паттернов проектирования.

Каждое действие сопровождается немедленным запуском тестов: агент требует непрерывной верификации и запрещает накапливать непроверенные правки. Для участков без тестов он сначала создаёт фиксирующие тесты (characterization tests), чтобы зафиксировать исходное поведение системы до модификаций.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/coco-research/coco/tree/HEAD/agents/refactoring-specialist.md

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

## Примеры запросов агенту
- Проверь модуль `order_service.py` субагентом refactoring-specialist и снизь сложность методов
- Используй refactoring-specialist: замени длинный switch в `parser.ts` на полиморфизм и запусти тесты
- Запусти refactoring-specialist для выделения слоя доступа к данным из контроллера `user_controller.go`

## Похожие
- [refactoring-surgeon](https://affpapa.org/nevibecode/skills/refactoring-surgeon.md) — скилл · 260 установок
- [code-refactoring-legacy-modernizer](https://affpapa.org/nevibecode/agents/code-refactoring-legacy-modernizer.md) — субагент · ★ 42780 у репозитория
- [refactoring-analysis](https://affpapa.org/nevibecode/skills/refactoring-analysis.md) — скилл · 434 установки
- [refactoring-expert](https://affpapa.org/nevibecode/agents/carlrannaberg-refactoring-expert.md) — субагент · ★ 763 у репозитория
- [refactoring-patterns](https://affpapa.org/nevibecode/skills/proffesor-for-testing-refactoring-patterns.md) — скилл · 140 установок
- [refactor](https://affpapa.org/nevibecode/skills/smallnest-refactor.md) — скилл · 538 установок

## Другие версии с тем же именем
- [refactoring-specialist · voltagent](https://affpapa.org/nevibecode/agents/refactoring-specialist.md) — 784 установки
- [refactoring-specialist · voltagent](https://affpapa.org/nevibecode/agents/voltagent-refactoring-specialist.md) — ★ 6505 у репозитория

Из того же набора: [coco-research/coco](https://affpapa.org/nevibecode/by/coco-research/coco.md) — 82 карточки

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

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