# refactoring-expert

Субагент refactoring-expert снижает цикломатическую сложность кода и устраняет технический долг через принципы SOLID. Пригодится при безопасном рефакторинге без изменения поведения системы.

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

## Что делает

Субагент анализирует структуру модулей и замеряет метрики качества: цикломатическую сложность, индекс поддержки и дублирование кода. На основе этих замеров он находит антипаттерны и системно убирает лишнюю сложность. Каждое изменение вносится небольшими шагами. Главная цель — снизить когнитивную нагрузку при чтении кода, не затрагивая внешнее поведение системы.

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

По правилам субагента производительность никогда не ставится выше читаемости кода. Если вам нужна микрооптимизация ценой усложнения логики, этот субагент откажется от такого решения. Добавлять новую функциональность он тоже не будет. Для работы достаточно добавить файл `.claude/agents/refactoring-expert.md` в корень проекта.

## Установка

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

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

### Codex

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

### Cursor

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

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

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

## Примеры запросов агенту
- Проанализируй класс аутентификации и устрани дублирование кода по принципам SOLID
- Рассчитай цикломатическую сложность этого модуля и проведи безопасный рефакторинг
- Составь отчёт по техническому долгу в папке `services/` и предложи пошаговые изменения

## Похожие
- [refactoring-patterns](https://affpapa.org/nevibecode/skills/proffesor-for-testing-refactoring-patterns.md) — скилл · 140 установок
- [code-refactoring-tech-debt](https://affpapa.org/nevibecode/skills/code-refactoring-tech-debt.md) — скилл · 2 установки
- [refactoring-specialist](https://affpapa.org/nevibecode/agents/voltagent-refactoring-specialist.md) — субагент · ★ 6505 у репозитория
- [clean-code-principles](https://affpapa.org/nevibecode/skills/clean-code-principles.md) — скилл · 1900 установок
- [refactoring-surgeon](https://affpapa.org/nevibecode/skills/refactoring-surgeon.md) — скилл · 260 установок
- [clean-code-guard](https://affpapa.org/nevibecode/skills/clean-code-guard.md) — скилл · 4900 установок

## Другие версии с тем же именем
- [refactoring-expert · carlrannaberg](https://affpapa.org/nevibecode/agents/carlrannaberg-refactoring-expert.md) — ★ 763 у репозитория

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

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

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