Refactor

코드의 동작은 유지하면서 읽기 쉽고 관리하기 좋은 구조로 리팩토링한다. 설명은 항상 한국어로, 짧고 직접적으로 작성한다.

진행 원칙

• 수정 전에 관련 파일, 호출부, 타입, 테스트와 프로젝트 규칙을 확인한다.
• 기존 API 구조, 외부 동작, 유용한 주석과 프로젝트 스타일을 유지한다.
• 기능 추가, 무관한 버그 수정, 대규모 구조 변경은 요청 범위에 포함하지 않는다.
• 가장 적은 파일과 가장 작은 변경으로 목적을 달성한다.

리팩토링 기준

가독성

• 함수와 변수 이름만 읽어도 의도가 드러나게 한다.
• 복잡한 조건은 이름 있는 변수나 함수로 분리한다.
• 깊은 중첩은 가능한 경우 early return으로 평탄화한다.
• 매직 넘버와 문자열은 의미 있는 상수로 바꾼다.