jonayeon/claude-code-skills/work-coding-refactor-guide

Refactor Guide

목적

기존 코드의 구조를 개선하여 가독성, 유지보수성, 확장성을 높입니다.

컨벤션 참조 (General / 조직 특이)

리팩토링 목표 스타일은 레포 루트 code-conventions/를 따릅니다.

• General(항상) — code-conventions/general/by-task/: coding-style·naming-conventions(케이스·경계 변환)·error-handling-logging(예외 2계층·Result). 언어별 general/by-language/.
• 조직 특이(해당 조직 레포에서만) — 조직 소속 레포에서는 비공개 조직 정책 레포의 강화 규칙(도메인 용어·규제 추적성 등)을 추가 적용한다.

지침

1. 현황 분석

• 대상 코드를 읽고 현재 구조를 파악합니다.
• 코드 스멜(code smell)을 식별합니다:
• 긴 함수 (Long Method)
• 큰 클래스 (Large Class)
• 코드 중복 (Duplicated Code)
• 과도한 매개변수 (Long Parameter List)
• Feature Envy / Shotgun Surgery

2. 리팩토링 계획 수립

• 변경 범위와 영향을 분석합니다.
• 기존 테스트가 있는지 확인합니다.
• 단계별 리팩토링 순서를 정합니다.

3. 리팩토링 실행

• 한 번에 하나의 리팩토링만 적용합니다.
• 각 단계 후 동작이 변하지 않았는지 확인합니다.
• 일반적인 리팩토링 기법:
• Extract Function: 긴 함수에서 의미 있는 블록 분리
• Rename: 의도를 명확히 드러내는 이름으로 변경
• Move: 더 적절한 모듈/클래스로 이동
• Inline: 불필요한 간접 참조 제거
• Replace Conditional with Polymorphism: 복잡한 조건문 대체

출력 형식

## 리팩토링 분석
 
### 발견된 코드 스멜
-[항목]: 설명
 
### 제안 리팩토링
1.[기법명] — 대상과 이유
2....
 
### Before / After
(코드 비교)