밉지않게 코드리뷰 하는 법
2026. 03. 13. 22:40
수정됨

밉지않게_코드리뷰_하는_법.pdf
534.4KB
리뷰에서 상처받거나 상처준 실수에서 배우는 피드백 기술
실수 → "어떻게 소통했어야 했지?" → 협업 훈련
📄 28페이지 | ⏱ 약 40분 읽기 | 📱 PDF
😤 "팀을 위해 꼼꼼히 리뷰했을 뿐인데, 미움받는 사람이 되었습니다." 좋은 의도로 남긴 코멘트가 왜 공격으로 느껴지는지, 그 메커니즘을 이해하면 같은 내용도 다르게 전달할 수 있습니다.
😶 "PR을 올리면 3일째 아무 반응이 없어요. LGTM 네 글자가 전부입니다." 침묵은 무관심의 메시지입니다. 리뷰어로서 침묵이 팀에 미치는 영향과, 30초면 할 수 있는 대안을 배웁니다.
💢 "리뷰 코멘트에서 기술적 논쟁이 감정 싸움으로 번졌습니다." 텍스트 3회 이상 오가면 위험 신호. 갈등을 탐색으로 전환하는 3단계 프로토콜을 익힙니다.
🥺 "시니어한테 리뷰 받으면 자존감이 바닥을 칩니다." 피드백을 감정과 분리하는 4가지 규칙, 그리고 방어 대신 질문으로 전환하는 기술을 연습합니다.
기술적 내용은 동일합니다. 달라지는 건 전달하는 언어뿐인데, 받는 사람의 반응은 180도 바뀝니다.
"이 함수 구조가 이상합니다."
"네이밍 컨벤션 안 맞아요."
"이렇게 하면 성능 문제 생깁니다."
"이 함수를 extract해서 단일 책임으로 분리하면
테스트하기 훨씬 쉬워질 것 같아요 🙂"
"camelCase로 통일하면 팀 코드와
일관성이 맞을 것 같습니다."
"이 쿼리는 N+1 문제가 있을 수 있어서
eager loading을 고려해보면 좋겠어요."
세 코멘트 모두 기술적 내용은 똑같습니다. 달라진 건 '왜'와 '어떻게'가 들어간 것 뿐입니다. 이 책에서 그 전환의 기술을 체계적으로 배웁니다.
코드 리뷰에서 흔히 발생하는 커뮤니케이션 실수들
Ch제목01"이건 아닌데" — 부정만 하는 리뷰02침묵의 리뷰어 — 아무 말도 하지 않는 위험03인신공격과 코드 공격 사이 — 경계를 넘는 순간
상처 없이 솔직하게, 솔직하면서도 따뜻하게
Ch제목04피드백 샌드위치를 넘어서 — OISO 프레임워크05감정을 읽는 리뷰어 — 텍스트 뒤의 신호06리뷰를 '받는' 기술 — 방어에서 성장으로
팀 전체가 함께 성장하는 리뷰 문화 만들기
Ch제목07심리적 안전감과 코드 리뷰08갈등 상황 매뉴얼 — 3단계 프로토콜09시니어와 주니어 사이의 온도 차이10리뷰 문화 설계하기 — 가이드라인부터 측정까지
코드 리뷰 코멘트 템플릿 : 긍정 피드백 / 개선 제안 / 갈등 전환 / 감정 관리 — 복사해서 바로 쓰는 문장 모음
관찰(Observation) → 영향(Impact) → 제안(Suggestion) → 열림(Openness). 피드백 샌드위치를 대체하는 맥락 기반 피드백 공식을 체득합니다.
과도한 정당화, 짧은 응답, 갑작스러운 동의, 응답 지연, 이모지 과다 — 상대의 불편함을 텍스트에서 읽는 법을 배웁니다.
쿨다운 → 분리 연습 → 감사부터 → 질문 전환. 날카로운 리뷰에 휘둘리지 않는 마인드셋을 훈련합니다.
일시 정지 → 동기화 미팅 → 결정 기록. 텍스트 논쟁이 감정 전쟁으로 번지기 전에 끊는 구체적 방법을 익힙니다.
긍정 / 개선 / 갈등 / 감정 관리 상황별 문장 모음. 복사해서 오늘 PR에 바로 붙여넣을 수 있습니다.
5가지 질문으로 팀의 리뷰 건강도를 점검하고, 분기별 추적으로 문화를 개선하는 피드백 루프를 만듭니다.
🌱 첫 PR을 올린 주니어 개발자 리뷰가 무섭고, 코멘트 하나에 하루가 흔들리는 분. 피드백을 성장의 연료로 바꾸는 법을 배웁니다.
💪 팀을 위해 리뷰하다 미움받은 시니어 꼼꼼하게 리뷰해줬을 뿐인데 팀 분위기가 싸해진 경험이 있는 분. 솔직함과 따뜻함의 균형을 찾습니다.
👥 리뷰 문화를 개선하고 싶은 팀 리드 팀의 리뷰 가이드라인을 만들고, 건강한 피드백 문화를 설계하고 싶은 분을 위한 실전 프레임워크.
🤝 협업 스킬을 키우고 싶은 모든 개발자 코드 리뷰뿐 아니라 슬랙, 회의, 1:1에서도 적용할 수 있는 기술적 커뮤니케이션의 기본기.
"상대방도 최선을 다하고 있다고 믿고, 그 믿음 위에서 소통하라."
리이오 (Leeo) — iOS 개발자 · 멘토 · 20+ 앱 운영
수 년간 iOS 앱을 만들며 수 많은 코드 리뷰를 주고받았습니다. 리뷰 한 줄에 팀 분위기가 바뀌는 것을 경험하며, 기술적 실력만큼 소통 능력이 중요하다는 것을 절감했습니다. 주니어 개발자들을 멘토링하며, 코드 리뷰에서 가장 많이 반복되는 커뮤니케이션 실수들을 정리한 것이 이 책의 출발점입니다.
다음 리뷰에서 지적 대신 질문을 하나 더 해보세요. 다음 피드백에서 이유를 한 줄 더 설명해보세요. 다음 승인에서 왜 좋은지를 한 마디 더 적어보세요.
그 작은 변화들이 모여서 팀의 온도를 바꾸고, 결국 코드의 품질을 바꿉니다.