리뷰 피드백으로 명확한 이름과 단일 책임 원칙 적용 경험
팀 프로젝트에서 팀원이 내 코드를 이해하는 데 오래 걸린다는 피드백을 받은 뒤 읽기 쉬운 코드 작성에 의식적으로 집중하게 됐습니다. 가장 먼저 바꾼 건 변수명과 함수명이 의도를 충분히 담도록 긴 이름을 허용하는 것이었습니다. 짧고 불분명한 이름이 줄고, 코드 리뷰 시 맥락 설명 없이도 흐름을 파악할 수 있게 됐습니다.
단일 책임 원칙을 적용해 함수 하나가 한 가지 일만 하도록 쪼개니, 테스트도 쉬워지고 수정 시 영향 범위도 예측하기 쉬워졌습니다. 코드는 컴퓨터가 아닌 사람이 읽는다는 관점으로 리뷰하게 됐고, 지금도 작성 후 다음 날 다시 읽어서 처음 보는 사람이 이해할 수 있는지를 점검하는 루틴을 유지하고 있습니다.