tomevault-io Unused Code Cleaner
AI 코드 생성 후 발생하는 불필요한 코드를 자동으로 정리한다.
워크플로우
1. 변경된 파일 확인
git diff --name-only HEAD
staged 파일 포함 시:
git diff --name-only HEAD --staged
특정 커밋/브랜치 비교 시:
git diff --name-only <base>..<target>
2. TS/JS 파일 필터링
확장자 필터: .ts, .tsx, .js, .jsx
제외 대상:
node_modules/.d.ts파일 (타입 선언)- 설정 파일 (
*.config.ts,*.config.js)
3. 파일별 분석 및 수정 (적응형 병렬화)
변경 파일 수에 따른 분석 전략:
2개 이하: 순차 분석 (기존 방식)
각 파일을 직접 읽고 아래 패턴을 찾아 제거합니다.
3개 이상: 병렬 분석 → 순차 수정
3-A: 병렬 분석
각 파일의 unused 코드를 Task sub-agent로 동시 탐지합니다:
Task call:
subagent_type: "general-purpose"
model: "haiku"
description: "Detect unused code in [파일명]"
run_in_background: true
prompt: |
Analyze the following file for unused code. DO NOT modify any files.
Only report what you find.
File to analyze: [파일 경로]
Check for these patterns:
1. Unused exports: Run `git diff HEAD -- [파일]` to find newly added exports,
then search the project for imports of each export name.
2. Unused functions: Functions defined but never called within the file or project.
3. Unused types/interfaces: Type declarations not referenced anywhere.
4. Commented code blocks: Code blocks that are commented out (preserve TODO/FIXME/NOTE comments).
5. Orphan console.log: Debugging console.log statements.
For unused exports, verify by searching the project:
- Check for dynamic imports: import() patterns
- Check barrel files (index.ts) for re-exports
- Check if used in test files
Output a JSON-like report:
{
"file": "[파일 경로]",
"findings": [
{"type": "unused_export", "name": "...", "line": N, "confidence": "high/medium"},
{"type": "unused_function", "name": "...", "line": N, "confidence": "high/medium"},
...
]
}
Only report findings with medium or high confidence.
모든 파일의 분석 Task가 완료될 때까지 대기합니다.
3-B: 순차 수정
오케스트레이터가 모든 분석 결과를 수집한 후:
- 각 finding을 검토하여 false positive 제거 (특히 cross-file 의존성 확인)
- confidence가 "high"인 것부터 순차적으로 파일을 수정
- confidence가 "medium"인 것은 한번 더 확인 후 수정
수정은 반드시 오케스트레이터가 직접 수행합니다 (sub-agent의 동시 파일 수정 방지).
제거 대상 (lint/TS로 못 잡는 것들)
| 패턴 | 설명 |
|---|---|
| Unused exports | 새로 추가된 export 중 프로젝트 어디서도 import 안 되는 것 |
| Unused functions | 정의 후 호출되지 않는 함수 |
| Unused types/interfaces | 참조되지 않는 타입 선언 |
| Commented code blocks | 주석 처리된 코드 블록 (설명 주석은 유지) |
| Orphan console.log | 디버깅용으로 추가된 console.log |
Unused Export 탐지 방법
git diff로 새로 추가된 export 식별:
git diff HEAD -- <file> | grep "^+" | grep -E "export (const|function|class|type|interface|enum)"
- 프로젝트 전체에서 해당 export가 import되는지 확인:
grep -r --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" "import.*<export_name>.*from" .
grep -r --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" "{ <export_name>" .
- 어디서도 import 안 되면 삭제
주의사항
- 동적 import (
import())로 사용될 수 있으므로 해당 패턴도 검색 - barrel file (index.ts)에서 re-export되는 경우 추적
- 주석 중 TODO, FIXME, NOTE, 설명 주석은 유지
4. 수정 적용
파일 수정 후 변경 사항 요약 출력:
- 제거된 import 수
- 제거된 변수/함수 수
- 제거된 코드 라인 수
- (병렬 분석 시) 분석 방식 요약: 파일 수, 병렬 에이전트 수
사용 예시
사용자: 방금 작업한 코드 unused 정리해줘
사용자: git diff 보고 불필요한 코드 삭제해
사용자: dead code 클린업
Converted and distributed by TomeVault — claim your Tome and manage your conversions.