코드 정리 리팩토링

언제 쓰나

코드에서 불필요한 부분을 찾아 안전하게 제거하고 싶을 때

---
description: 각 변경 후 검증을 통해 사용되지 않는 코드를 안전하게 식별하고 제거합니다.
---

# 정리 리팩터링

모든 단계에서 테스트 검증을 통해 사용되지 않는 코드를 안전하게 식별하고 제거합니다.

## 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을 사용하여 가져온 곳이 없는 exports를 찾으세요:
```
# Find exports, then check if they're imported anywhere
```

## 2단계: 발견된 내용 분류

발견된 내용을 안전 등급으로 분류합니다:

| 등급 | 예시 | 조치 |
|------|----------|--------|
| **SAFE** | 사용되지 않는 유틸리티, 테스트 헬퍼, 내부 함수 | 안전하게 삭제 |
| **CAUTION** | 컴포넌트, API 경로, 미들웨어 | 동적 임포트 또는 외부 소비자가 없는지 확인 |
| **DANGER** | 설정 파일, 진입점, 타입 정의 | 확인 후 처리 |

## 3단계: 안전한 삭제 반복

각 SAFE 항목에 대해:

1.  **전체 테스트 스위트 실행** — 기준선 설정 (모두 통과)
2.  **사용되지 않는 코드 삭제** — Edit 도구를 사용하여 정밀하게 제거
3.  **테스트 스위트 재실행** — 아무것도 손상되지 않았는지 확인
4.  **테스트 실패 시** — `git checkout -- <file>` 명령어로 즉시 되돌리고 해당 항목 건너뛰기
5.  **테스트 통과 시** — 다음 항목으로 이동

## 4단계: CAUTION 항목 처리

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

## 5단계: 중복 통합

사용되지 않는 코드를 제거한 후 다음을 확인하세요:
- 거의 중복되는 함수 (80% 이상 유사) — 하나로 병합
- 불필요한 타입 정의 — 통합
- 가치가 없는 래퍼 함수 — 인라인 처리
- 목적 없는 재-export — 간접 참조 제거

## 6단계: 요약

결과를 보고합니다:

```
Dead Code Cleanup
──────────────────────────────
Deleted:   12 unused functions
           3 unused files
           5 unused dependencies
Skipped:   2 items (tests failed)
Saved:     ~450 lines removed
──────────────────────────────
All tests passing PASS:
```

## 규칙

- **테스트 실행 없이 삭제하지 마세요**
- **한 번에 한 가지씩만 삭제** — 원자적 변경으로 롤백이 쉬워집니다
- **불확실하면 건너뛰세요** — 프로덕션을 망가뜨리는 것보다 사용되지 않는 코드를 남겨두는 것이 낫습니다
- **정리하는 동안 리팩터링하지 마세요** — 관심사 분리 (먼저 정리하고, 나중에 리팩터링)

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-155/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 코드에서 불필요한 부분을 찾아 안전하게 제거하고 싶을 때

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.