refactor-cleaner · sangrokjung — субагент для Claude Code: чистит мёртвый код
Субагент refactor-cleaner находит мёртвый код, неиспользуемые экспорты и зависимости через knip, depcheck и ts-prune, проверяет ссылки и удаляет лишнее маленькими партиями.
MIT ★ 880 обновлён 2026-09-03
.claude/agents/refactor-cleaner.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/refactor-cleaner.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/refactor-cleaner.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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 от других авторов.