everything-claude-code/docs/ko-KR/commands/refactor-clean.md

# Refactor Clean

사용하지 않는 코드를 안전하게 식별하고 매 단계마다 테스트 검증을 수행하여 제거합니다.

## 1단계: 사용하지 않는 코드 감지

프로젝트 유형에 따라 분석 도구를 실행합니다:

| 도구 | 감지 대상 | 커맨드 |
|------|----------|--------|
| knip | 미사용 exports, 파일, 의존성 | `npx knip` |
| depcheck | 미사용 npm 의존성 | `npx depcheck` |
| ts-prune | 미사용 TypeScript exports | `npx ts-prune` |
| vulture | 미사용 Python 코드 | `vulture src/` |
| deadcode | 미사용 Go 코드 | `deadcode ./...` |
| cargo-udeps | 미사용 Rust 의존성 | `cargo +nightly udeps` |

사용 가능한 도구가 없는 경우, Grep을 사용하여 import가 없는 export를 찾습니다:
```
# export를 찾은 후, 다른 곳에서 import되는지 확인
```

## 2단계: 결과 분류

안전 등급별로 결과를 분류합니다:

| 등급 | 예시 | 조치 |
|------|------|------|
| **안전** | 미사용 유틸리티, 테스트 헬퍼, 내부 함수 | 확신을 가지고 삭제 |
| **주의** | 컴포넌트, API 라우트, 미들웨어 | 동적 import나 외부 소비자가 없는지 확인 |
| **위험** | 설정 파일, 엔트리 포인트, 타입 정의 | 건드리기 전에 조사 필요 |

## 3단계: 안전한 삭제 루프

각 안전 항목에 대해:

1. **전체 테스트 스위트 실행** --- 기준선 확립 (모두 통과)
2. **사용하지 않는 코드 삭제** --- Edit 도구로 정밀하게 제거
3. **테스트 스위트 재실행** --- 깨진 것이 없는지 확인
4. **테스트 실패 시** --- 즉시 `git checkout -- <file>`로 되돌리고 해당 항목을 건너뜀
5. **테스트 통과 시** --- 다음 항목으로 이동

## 4단계: 주의 항목 처리

주의 항목을 삭제하기 전에:
- 동적 import 검색: `import()`, `require()`, `__import__`
- 문자열 참조 검색: 라우트 이름, 설정 파일의 컴포넌트 이름
- 공개 패키지 API에서 export되는지 확인
- 외부 소비자가 없는지 확인 (게시된 경우 의존 패키지 확인)

## 5단계: 중복 통합

사용하지 않는 코드를 제거한 후 다음을 찾습니다:
- 거의 중복된 함수 (80% 이상 유사) --- 하나로 병합
- 중복된 타입 정의 --- 통합
- 가치를 추가하지 않는 래퍼 함수 --- 인라인 처리
- 목적이 없는 re-export --- 간접 참조 제거

## 6단계: 요약

결과를 보고합니다:

```
Dead Code Cleanup
──────────────────────────────
삭제:     미사용 함수 12개
           미사용 파일 3개
           미사용 의존성 5개
건너뜀:   항목 2개 (테스트 실패)
절감:     약 450줄 제거
──────────────────────────────
모든 테스트 통과 ✅
```

## 규칙

- **테스트를 먼저 실행하지 않고 절대 삭제하지 않기**
- **한 번에 하나씩 삭제** --- 원자적 변경으로 롤백이 쉬움
- **확실하지 않으면 건너뛰기** --- 프로덕션을 깨뜨리는 것보다 사용하지 않는 코드를 유지하는 것이 나음
- **정리하면서 리팩토링하지 않기** --- 관심사 분리 (먼저 정리, 나중에 리팩토링)