레거시 코드, 한 번에 다 고치지 마세요

200줄 God Class 를 한 번에 손대면 테스트가 깨지고 동료 PR 이 막힙니다. refactor-coach 는 5단계 로드맵과 단계별 commit 메시지까지 함께 출력해서, 매 단계 테스트를 보존하면서 안전하게 진행할 수 있게 해줍니다.

탐지하는 Code Smells (15종)

SOLID 위반 자동 진단

예시 출력 (5개 commit)

1. refactor: extract per-method handlers from PaymentProcessor::process()
   350줄 단일 메서드를 결제 방법별 private 메서드 4개로 분리.

2. refactor: extract CreditCardProcessor / PayPalProcessor / ...
   각 결제 방법을 별도 클래스로 분리하여 SRP 준수.

3. refactor: apply Strategy pattern via PaymentMethodInterface
   새 결제 방법 추가 시 PaymentProcessor 수정 없이 확장 (OCP).

4. refactor: separate receipt and mail concerns into PaymentService
   순수 결제 로직과 후처리 (영수증, 메일) 분리.

5. refactor: replace string payment method with PaymentMethod enum
   타입 안정성 강화 + IDE 자동완성 지원.

포함된 자료

• SKILL.md — 메인 스킬 정의
• examples/01-god-class-strategy.md — God Class → Strategy 패턴
• examples/02-long-method-extract.md — 200줄 메서드 분해
• examples/03-primitive-obsession.md — Value Object 도입
• assets/solid-checklist.md — SOLID 5원칙 자동 진단 가이드
• assets/refactoring-catalog.md — Martin Fowler 의 리팩토링 50선
• LICENSE.txt — 라이선스 조건

리팩토링 원칙 (적용됨)

• 테스트 우선 — 테스트 없으면 먼저 작성
• 작은 단계 — 한 번에 한 패턴, 1시간 미만
• commit 자주 — 단계마다 / 안전한 지점마다
• 새 행동 금지 — 리팩토링과 기능 추가는 다른 commit
• 외부 API 보존 — public 시그니처 유지

설치 (30초)

$ unzip refactor-coach.zip -d ~/.claude/skills/
$ # Claude Code 재시작 후 "refactor-coach 활성화"