카카오 FE Kay, 효과적인 코드 리뷰를 위한 5가지 원칙 제시

카카오 톡FE파트 Kay가 신입 공채 기술 온보딩 교육에서의 코드 리뷰 경험을 바탕으로, 효과적인 코드 리뷰를 위한 리뷰어의 자세와 5가지 원칙을 제시했다. 리뷰는 단순한 오류 검출을 넘어 기술 부채 감소와 지식 공유를 위해 필수적이며, 리뷰어의 태도가 그 효과를 좌우한다.

5가지 핵심 원칙

1. 개선 이유를 구체적으로 설명하라: 주관적이거나 추상적인 피드백은 혼란을 야기하므로, 변경이 필요한 명확한 근거를 제시해야 한다.
2. 답 대신 방향을 제시하라: 코드를 직접 수정해 주기보다 키워드나 검색 방법을 알려주어 리뷰이가 스스로 고민하고 학습하도록 유도해야 한다.
3. 일관성을 강조하라: 프로젝트 컨벤션 규칙을 준수하도록 피드백하며, 코드 내 반복되는 패턴의 일관성을 유지하는 것이 중요하다.
4. 학습 과정으로 접근하라: 리뷰이의 의도를 먼저 파악하고 질문하는 방식으로, 숙제 검사나 감시보다는 성장의 기회로 느끼게 해야 한다.
5. 리뷰를 위한 리뷰를 지양하라: 피드백할 내용이 없다면 억지로 지적하지 말고, 잘된 코드에 대해 칭찬을 남기는 것도 좋은 커뮤니케이션이다.

실전 팁과 주의사항

리뷰 시 작은 커밋 단위보다는 전체 코드의 맥락을 파악하는 것이 중요하며, Pull Request 템플릿을 활용해 리뷰이와 리뷰어 모두의 실수를 줄이고 작업 내용을 명확히 전달할 수 있다. 또한, if/else와 삼항 연산자 선택처럼 가독성이 주관적인 영역에서는 개발자의 성향을 비판하기보다 충분한 논의를 거쳐야 한다. 코드 리뷰는 커뮤니케이션 비용이 크지만, 좋은 리뷰는 변경의 이점과 근거를 담기 때문에 더 긴 시간이 소요되더라도 가치 있는 투자이다.