01 ▸ 워크플로우 위치
[생성]
│
▼
┌─────────────────────────────┐
│ Clean AI Slop (ACTIVE) │
│ AI 생성 코드 정리 │
└──────────────┬──────────────┘
│
▼
[완료]
02 ▸ 언제 사용하나요?
대규모 AI 코드 생성 세션 이후 동작을 보존하면서 코드를 깨끗하게 유지하고 싶을 때 사용합니다.
주요 트리거
"정리해줘", "deslop", "AI 코드 정리" 명령어 사용 시- 대량의 AI 코드 생성 직후 품질 확보가 필요할 때
- 코드 리뷰 전 LLM 특유의 장황함을 제거하고 싶을 때
03 ▸ 어떻게 동작하나요?
핵심 원리: 테스트로 동작을 잠근 후, 6개 스멜을 순차적 패스로 정리합니다. 각 단계에서 실패 시 즉시 롤백합니다.
6단계 정리 프로세스
- 테스트로 동작 잠금: 정리 전 테스트 통과 확인 — 회귀 기준점 확보.
- 死 code 제거: 사용하지 않는 함수, 변수, import, 리턴값 제거.
- 과잉 주석 제거: 명백한 코드를 설명하는 주석, LLM 필러 제거.
- 불필요 추상화 제거: 한 번만 쓰는 헬퍼, 과도한 인터페이스 간소화.
- 방어적 편집증 제거: 불가능한 케이스, 과잉 검증, null 체크 폭포 제거.
- 장황한 네이밍 정리: 의미를 해치지 않는 범위 내에서 간결한 네이밍으로 변경.
- LLM 필러 아티팩트 제거: 자체 설명 주석, 과도한 docstring 제거.
04 ▸ 하드 게이트
- 동작을 테스트로 잠그기 전에는 어떤 정리도 시작하지 않습니다.
- AI가 직접 수정한 파일만을 대상으로 작업을 제한하여 부수 효과를 차단합니다.
- 한 번에 하나의 스멜 패스만 수행하며, 각 단계 완료 후 반드시 테스트를 실행합니다.