К основному содержанию
субагент CX Codex

refactor-cleaner · sangrokjung — субагент для Claude Code: чистит мёртвый код

Субагент refactor-cleaner находит мёртвый код, неиспользуемые экспорты и зависимости через knip, depcheck и ts-prune, проверяет ссылки и удаляет лишнее маленькими партиями.

MIT ★ 880 обновлён 2026-09-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/refactor-cleaner.md
Открыть на GitHub

Что делает refactor-cleaner

Субагент для Claude ищет в проекте то, что уже никто не вызывает: файлы, экспорты, npm-зависимости. Сначала запускает npx knip, npx depcheck и npx ts-prune, потом раскладывает находки на три группы: безопасные, требующие дополнительной проверки и рискованные вроде публичного API или общих утилит.

Перед удалением каждая позиция проходит через Grep: агент ищет все ссылки, включая динамические импорты, и смотрит историю git. Удаляет по одной категории за коммит и после каждой партии прогоняет тесты. Работает только в feature-ветке, так что основная ветка не под угрозой.

Есть список того, что он не тронет никогда: код авторизации, интеграция кошелька, клиенты БД, поисковая инфраструктура, торговая логика, обработчики реального времени. Код без тестового покрытия удаляется только с вашего подтверждения. Если партия что-то сломала, откат идёт через git revert HEAD с разбором причины и правкой списка запретного.

Какие задачи решает

  • убрать неиспользуемые npm-зависимости перед релизом
  • найти экспорты, которые никто не импортирует
  • свести две копии одной функции в одну реализацию
  • удалить мёртвые файлы и не сломать сборку
  • откатить неудачную чистку одним коммитом

Примеры запросов агенту

  • Найди мёртвый код в src/ и удали неиспользуемые экспорты, начиная с безопасных
  • Прогони knip и depcheck, убери лишние зависимости и запускай тесты после каждой партии
  • Собери дублирующиеся реализации formatDate в одну

Как установить refactor-cleaner

Вручную: положить файлы

.claude/agents/refactor-cleaner.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о refactor-cleaner

Как установить refactor-cleaner в Claude Code?

Положите файл субагента по пути .claude/agents/refactor-cleaner.md. В нём уже прописан frontmatter с моделью sonnet и инструментами Read, Write, Edit, Bash, Grep, Glob.

Что делает refactor-cleaner?

Ищет мёртвый код, неиспользуемые экспорты и зависимости тремя детекторами, проверяет каждую находку через Grep и удаляет её отдельным коммитом с прогоном тестов.

Можно ли запускать его в основной ветке?

Нет, он рассчитан только на feature-ветку. Код без тестового покрытия он тоже не удалит без вашего подтверждения.

Исходный текст

refactor-cleaner.md · MIT
---
name: refactor-cleaner
description: |
  데드 코드·미사용 exports·의존성 제거, 중복 통합 전문. knip/depcheck/ts-prune 감지 → Grep 참조 검증 → 안전 제거. 피처 브랜치에서만 동작. Use proactively when "데드 코드", "미사용 코드", "정리해줘", "클린업", "리팩토링" 요청 시. 빌드 에러 수정은 build-error-resolver, 새 기능은 tdd-guide 사용.
tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"]
model: sonnet
memory: project
maxTurns: 20
isolation: worktree
color: yellow
---

<Agent_Prompt>
  <Role>
    You are Refactor Cleaner. Identify and remove dead code, duplicates, and unused exports through safe, systematic cleanup.
    When in doubt, don't remove. Safety first.
  </Role>

  <Success_Criteria>
    - All removals verified by detection tools (knip, depcheck, ts-prune)
    - All references checked via Grep before deletion
    - Build and tests pass after each removal batch
    - No regressions introduced
  </Success_Criteria>

  <Constraints>
    - Never remove without running detection tools first
    - Never remove RISKY items (public API, shared utilities) without explicit approval
    - Always Grep for all references (including dynamic imports) before deletion
    - Always run tests after each removal batch
    - Always work on a feature branch
    - One category per commit (unused deps / exports / files / duplicates)
    - NEVER REMOVE: Auth code, wallet integration, DB clients, search infra, trading logic, real-time handlers
  </Constraints>

  <Investigation_Protocol>
    1) Run detection tools in parallel: `npx knip`, `npx depcheck`, `npx ts-prune`
    2) Categorize: SAFE (unused exports/deps) | CAREFUL (dynamic imports possible) | RISKY (public API)
    3) Per item: Grep all references, check dynamic imports, review git history
    4) Remove SAFE items one category at a time, run tests after each batch
    5) For duplicates: choose best implementation, update imports, delete rest
  </Investigation_Protocol>
</Agent_Prompt>

## 실행 방법

```bash
npx knip                    # unused files, exports, dependencies, types
npx depcheck                # unused npm dependencies
npx ts-prune                # unused TypeScript exports
```

## 삭제 판단 기준

| Category | Action |
|----------|--------|
| SAFE (unused exports/deps) | Grep 확인 후 제거 |
| CAREFUL (동적 import 가능) | 추가 검증 필요 |
| RISKY (public API, shared) | 명시적 승인 필요 |

## 안전장치

- feature branch에서만 작업
- 문제 발생 시: `git revert HEAD` → 원인 조사 → NEVER REMOVE 리스트 업데이트
- 테스트 커버리지 없는 코드는 제거 전 사용자 확인

## Related Skills
- refactor-clean, component-refactoring, coding-standards

© sangrokjung · MIT · sangrokjung/claude-forge

Похожие субагенты

Все субагенты по теме «Код-ревью и рефакторинг» →

Сначала — refactor-cleaner от других авторов.

refactor-cleaner Affaan Mustafa Субагент refactor-cleaner автоматически находит и удаляет неиспользуемый код, дубликаты и зависимости. Запускает инструменты анализа (knip, depcheck, ts-prune) и безопасно очищает проект. CX Codex ★ 6 739звёзд репо unused-code-cleaner davila7 Субагент unused-code-cleaner ищет неиспользуемые импорты, функции и классы и удаляет их с проверкой после каждого шага. Пригодится после рефакторинга или перед выкладкой в прод. CX Codex 1 990установок fix-knip-unused-exports Factory-AI Скилл fix-knip-unused-exports для Claude Code автоматически исправляет нарушения knip «Unused exports». Находит потребителей и выбирает способ удаления или переноса неиспользуемых в production экспортов. CX Codex +1 147установок ai-slop-cleaner Yeachan-Heo Скилл ai-slop-cleaner для Claude Code и Codex удаляет мёртвый код, дубликаты и лишние абстракции после генерации ИИ. Поведение системы фиксируется тестами до внесения любых правок в файлы. CX Codex +1 1 700установок code-auditing jeffrigby Скилл code-auditing для Claude Code проводит пошаговый аудит кодовой базы: находит уязвимости, мёртвый код и технический долг, сверяет вызовы библиотек с официальной документацией. CX Codex +1 1установок dead-code-finder rohitg00 Плагин dead-code-finder для Claude Code находит неиспользуемый код по всей кодовой базе. Помогает убрать функции и переменные, которые никто не вызывает. ★ 2 858звёзд репо simplify SeifBenayed Скилл simplify для Claude Code, Codex и Cursor проходит по коду и убирает лишнюю сложность. Запускается на свежих правках или на отдельном файле, который разросся. CX Codex +1 ★ 116звёзд репо

Из того же набора44

Весь набор →
instinct-status Команда instinct-status показывает усвоенные привычки агента, уровень уверенности и источник. Помогает проверить, какие наблюдения накопились по стилю кода и рабочим процессам. CX Codex +1 ★ 880звёзд репо doc-updater Субагент doc-updater для Claude Code пересобирает README, гайды и кодмапы по файлам проекта после правок кода. Обновляет документацию, разошедшуюся с кодом. CX Codex ★ 880звёзд репо instinct-export Команда instinct-export выгружает накопленные персональные инстинкты агента в файл, чтобы делиться ими с коллегами или переносить между машинами. CX Codex +1 ★ 880звёзд репо eval Команда ведёт eval-проверки функций: создаёт критерии, запускает проверки и собирает отчёты. Пригодится, чтобы отслеживать возможности новой функции и не пропускать регрессии. CX Codex +1 ★ 880звёзд репо task-grade-routing Правило task-grade-routing определяет объём документации и число независимых проверок под размеры задач S, M, L и XL при работе с классификатором воркфлоу. CX Codex +1 ★ 880звёзд репо frontend-code-review Скилл frontend-code-review проверяет фронтенд-код по чек-листу и оформляет замечания по заданному шаблону. Запускайте его для изменений перед коммитом или ревью конкретных файлов. CX Codex +1 ★ 880звёзд репо instinct-import Команда instinct-import забирает инстинкты из файла или по URL, сверяет их с уже накопленными и раскладывает по хранилищу с пометкой об источнике. CX Codex +1 ★ 880звёзд репо database-reviewer Субагент database-reviewer для Claude Code, который проверяет SQL-миграции, индексы и политики RLS в проектах на PostgreSQL и Supabase. Помогает находить N+1 и оценивать планы через EXPLAIN ANALYZE. CX Codex ★ 880звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой