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