“좋아 보여”

건설적인 피드백으로 팀과 코드를 함께 성장시키는 코드 리뷰의 새로운 표준

이 책은 코드 리뷰를 긍정적이고 생산적인 경험으로 전환하는 방법을 다룬다. 저자는 흔히 발생하는 논쟁, 무의미한 트집 잡기, 불필요한 병목현상을 줄이고, 팀원들의 협업을 강화시키는 코드 리뷰를 제시한다. 리뷰 목표 수립, 변화와 장애물 대응, 다양한 적용 옵션과 해결책, 공감할 수 있는 시나리오, 실무 노하우를 통해 실질적인 리뷰 기법을 배울 수 있다. 팀의 작업 방식에 맞춘 효율적인 리뷰 문화를 구축하고, 코드와 팀 모두를 성장시켜보자.

 

도서구매 사이트(가나다순)

[교보문고]  [도서11번가]  [알라딘]  [예스이십사]  [쿠팡]

 

출판사 제이펍
저작권사 Manning
원서명 "Looks Good to Me” (9781633438125)
도서명 “좋아 보여”
부제 LGTM을 넘어 건설적인 코드 리뷰로
지은이 에이드리엔 브라간자
옮긴이 이춘혁
감수자 (없음)
시리즈 (없음)
출판일 2025. 12. 18
페이지 384쪽
판 형 46배판변형(188*245*18.4)
제 본 무선(soft cover)
정 가 30,000원
ISBN 979-11-94587-78-1 (93000)
키워드 코드리뷰, LGTM, 자동화, 팀워킹어그리먼트, AI코드리뷰, 코멘트, 테스트, PR, 페어프로그래밍, 몹프로그래밍
분 야 컴퓨터 공학 / 개발방법론

관련 사이트
■ 저작권사 도서 페이지

 

관련 시리즈

■ (없음)

 

관련 포스트

■ 2025.12.04 - [출간 전 책 소식] - 여전히 코드 리뷰에서 LGTM만 외치고 있다면

 

관련 도서

■ (없음)

 

관련 파일 다운로드

■ https://github.com/jpub-lgtm/lgtm-extras

 

강의 보조 자료(교재로 채택하신 분들은 https://jpub.tistory.com/notice/1076을 통해 다음 자료를 요청하실 수 있습니다.)
■ 본문의 그림과 표

 

미리보기(앞부속, 본문 일부)

 

정오표 페이지
■ (등록되는 대로 링크를 걸겠습니다.)

 

도서구매 사이트(가나다순)

[교보문고]  [도서11번가]  [알라딘]  [예스이십사]  [쿠팡]

 

도서 소개

팀의 성장을 이끄는 코드 리뷰의 진짜 힘

이 책은 코드 리뷰를 단순한 승인 절차에서 팀을 성장시키는 진짜 협업 도구로 끌어올리는 데 집중한다. 개발자라면 누구나 겪었던 답답한 순간들, 의미 없는 트집이나 피드백의 공회전, 리뷰 지연으로 인한 팀 생산성 저하 같은 문제를 아주 현실적으로 짚고 들어간다. 그러면서도 분위기는 무겁지 않다. 저자는 사람 중심의 리뷰 문화를 강조하며, 리뷰라는 행위가 곧 팀의 소통 방식이자 기술적 토론의 장이라는 점을 다시 생각하게 만든다.

책의 1부에서는 리뷰 시스템을 어떻게 설계할지, 좋은 PR은 무엇인지, 팀 내 역할과 책임을 어떻게 나눌지 차근차근 풀어준다. 이어지는 2부에서는 팀이 합의할 기준, 자동화 전략, 효과적인 코멘트의 실제 표현처럼 바로 적용할 수 있는 스킬을 알려준다. 3부에서는 리뷰 지연, 병목, 갑작스러운 비상 상황 등 현장에서 마주칠 수밖에 없는 문제를 케이스별로 해부하고, 마지막 4부에서는 페어 프로그래밍과 몹 프로그래밍, 그리고 AI 도구까지 포함해 코드 리뷰를 더 큰 개발 관행 속에 연결해 설명한다. 한국어판 부록은 한국 개발자의 코드 리뷰 이야기를 담아, 실제 기업에서 어떻게 코드 리뷰가 이뤄지고 있는지 확인할 수 있다.

이 책이 반가운 이유는 코드 리뷰를 정답 찾기 게임이 아니라 팀이 함께 성장하는 과정으로 바라보게 한다는 점이다. 리뷰는 코드 품질을 지키기 위한 수단이지만, 동시에 팀의 신뢰를 만들고 개발자의 사고방식을 단단하게 만드는 장치이기도 하다. 특히 컨벤셔널 코멘트 레이블 같은 실용적인 방법들은 팀에 바로 도입해도 될 정도이다. 국내 개발자들의 추천평도 모두 같은 지점을 말한다. 코드 참조를 넘어 협업 문화를 설계하는 영역으로 코드 리뷰를 끌어올린다는 것.

복잡한 규칙보다 명확한 기준, 공격적인 지적보다 건설적인 피드백, 혼자서 버티는 리뷰보다 함께 해결하는 리뷰를 꿈꾼다면 이 책이 꽤 든든한 기준점이 될 것이다. 결국 좋은 코드 리뷰는 좋은 팀 문화를 만들고, 좋은 팀 문화는 좋은 소프트웨어로 이어진다는 단순하지만 강력한 사실을 다시 떠올리게 한다.

 

주요 내용

￭ 코드 리뷰의 필요성 이해하기

￭ 객관적인 코드 리뷰 시스템 구축하기

￭ 관리 가능한 가이드라인 설정하기

￭ 팀 워킹 어그리먼트 문서화하기

￭ 포매팅, 린팅, 정적 분석, 자동화 테스트로 코드 품질 자동화하기

￭ 모든 상황에서 효과적인 코멘트 작성하기

￭ 코드 리뷰와 페어 프로그래밍 또는 몹 프로그래밍 결합 고려하기

￭ 코드 리뷰에 AI 활용하기

 

지은이 소개

에이드리엔 브라간자(Adrienne Braganza)

베스트셀러 《Coding for Kids: Python》의 저자. 소프트웨어 엔지니어이자 작가 그리고 STEM 교육 지지자다. 라스베이거스에서 Code.org 자원봉사자로 활동하는 한편 코딩의 강력함에 대해 정기적으로 강연하고 있으며, 특히 젊은 여성과 소녀들에게 소프트웨어 엔지니어링 분야로의 진로를 독려하고 있다. 링크드인 러닝에서는 65,000명 이상의 수강생을 가르치고 있다.

 

옮긴이 소개

이춘혁

코딩도 좋아하지만, 그보다 더 좋아하는 건 문제를 깔끔하게 해결하는 순간이다. 프로그래밍 언어와 영어, 중국어, 일본어와 같은 자연어에도 관심이 많고, 무엇이든 배우는 걸 좋아하고 즐긴다.

 

차례

옮긴이 머리말 xi

추천의 글 xiii

베타리더 후기 xvi

추천 서문 xviii

시작하며 xx

감사의 글 xxii

이 책에 대하여 xxiv

표지에 대하여 xxvii

 

PART I 코드 리뷰의 기초 지식

 

CHAPTER 1 코드 리뷰의 중요성 3

1.1 대상 독자 7

1.2 책의 구조 9

1.3 코드 리뷰가 필요하다 11

__1.3.1 더 나은 애플리케이션 11

__1.3.2 팀의 이해 수준 향상 12

1.4 팀 설득하기 12

1.5 코드 리뷰 개선하기 13

요약 14

 

CHAPTER 2 코드 리뷰 분석하기 15

2.1 코드 리뷰 시스템 15

__2.1.1 사람 주도 16

__2.1.2 도구 기반 16

__2.1.3 혼합형 17

2.2 코드 리뷰는 어떻게 작동할까? 18

__2.2.1 현재의 코드 리뷰 워크플로 19

__2.2.2 우리의 코드 리뷰(PR 워크플로) 22

2.3 훌륭한 PR의 요소 22

__2.3.1 제목: ‘what’ 23

__2.3.2 디스크립션: ‘why’ 28

__2.3.3 레이블 34

__2.3.4 리뷰 상태 37

2.4 코드 리뷰 참여자와 기대사항 40

__2.4.1 리뷰어 41

__2.4.2 작성자 46

__2.4.3 팀 51

__2.4.4 관리자 53

__2.4.5 조직 54

요약 58

 

CHAPTER 3 팀의 첫 코드 리뷰 프로세스 구축하기 60

3.1 목표 설정하기 61

__3.1.1 버그 발견 61

__3.1.2 코드베이스의 안정성과 유지 보수성 63

__3.1.3 지식 전달과 정보 공유 64

__3.1.4 멘토링 67

__3.1.5 기록 보관/변경 이력 관리 68

__3.1.6 자신의 코드 리뷰 목표 선택하기 69

3.2 도구 선택하기 70

__3.2.1 코드 리뷰 기능 평가하기 71

__3.2.2 도구 선택하기 72

3.3 가이드라인 설정하기 76

__3.3.1 팀의 워크플로 76

__3.3.2 리뷰의 중점 79

__3.3.3 PR 승인을 막는 요인 80

__3.3.4 승인 정책 82

3.4 프로세스 개선하기 85

__3.4.1 개선 사례 가이드 88

요약 90

 

PART II 고급 코드 리뷰를 위한 필수 요소

 

CHAPTER 4 팀 워킹 어그리먼트 93

4.1 팀 워킹 어그리먼트란? 94

4.2 팀 워킹 어그리먼트로 팀 기대치 설정하기 94

__4.2.1 시나리오 1: 빠른 리뷰와 빠르지 않은 리뷰 95

__4.2.2 시나리오 2: 의미의 불일치 95

__4.2.3 시나리오 3: 승인 또는 미승인 97

4.3 팀 워킹 어그리먼트 수립하기 98

__4.3.1 팀에 팀 워킹 어그리먼트가 꼭 필요할까? 98

4.4 팀 워킹 어그리먼트에 포함할 사항 고려하기 102

__4.4.1 명확한 코드 리뷰 기대사항 102

__4.4.2 합리적인 응답 시간 102

__4.4.3 적절한 PR 크기 105

__4.4.4 문제 식별 106

__4.4.5 PR 셀프 승인하기 109

__4.4.6 사소한 지적 111

__4.4.7 긍정적인 리뷰 환경 112

__4.4.8 정책을 위반했을 때는 어떻게 할까? 113

4.5 팀 워킹 어그리먼트 적용하기 114

__4.5.1 수정이 필요할 때 114

__4.5.2 정리하기 115

요약 115

 

CHAPTER 5 자동화의 이점 117

5.1 자동화의 중요성 118

5.2 자동화의 전제 조건 120

__5.2.1 팀 스타일 가이드 120

__5.2.2 적절한 도구 123

5.3 리뷰 전 자동화 124

__5.3.1 포매팅 124

__5.3.2 린트 127

__5.3.3 정적 분석 129

__5.3.4 테스트 자동화 131

5.4 코드 리뷰 과정 중 자동화 133

__5.4.1 PR 템플릿 133

__5.4.2 PR 검증 도구 136

__5.4.3 리뷰어 할당 139

__5.4.4 PR 게이트 체크 143

__5.4.5 리마인더와 에스컬레이션 147

요약 148

 

CHAPTER 6 효과적인 코드 리뷰 코멘트 작성하기 150

6.1 코멘트를 효과적으로 만드는 방법 151

__6.1.1 객관성 151

__6.1.2 구체성 157

__6.1.3 명확한 결과 163

__6.1.4 효과적인 코드 리뷰 코멘트 샘플 165

6.2 말투(표현 방식) 167

6.3 코드 칭찬하기 171

요약 172

 

PART III 딜레마

 

CHAPTER 7 코드 리뷰가 망하는 순간들 177

7.1 코드 리뷰 프로세스에서 겪는 문제 178

__7.1.1 대충 진행하는 코드 리뷰 178

__7.1.2 나쁜 코드 리뷰 180

__7.1.3 일관성 없는 코드 리뷰 182

__7.1.4 엄격한 코드 리뷰 183

7.2 그렇다면 무엇을 해야 할까? 185

요약 185

 

CHAPTER 8 코드 리뷰 지연 줄이기 186

8.1 리뷰를 할 수 있는 시니어 개발자가 한 명밖에 없어요 187

8.2 PR이 이해되지 않아요 191

8.3 리뷰할 파일이 너무 많아요 192

8.4 기능이 너무 커서 리뷰가 어려워요 193

8.5 논의가 너무 길어지는 것 같아요 196

8.6 코드 리팩터링이 필요해요 199

요약 201

 

CHAPTER 9 프로세스의 허점 제거하기 203

9.1 허점이 발생하는 이유 203

9.2 허점(그리고 해결 방법) 204

__9.2.1 정의되지 않은 코드 리뷰 프로세스 205

__9.2.2 코드 리뷰 시간 부족 212

__9.2.3 도구의 (잘못된) 설정 214

__9.2.4 피드백 문화의 부재 215

__9.2.5 승인 지향 지표 217

__9.2.6 비상 상황 이용하기 220

요약 220

 

CHAPTER 10 비상 대응 매뉴얼 222

10.1 비상 대응 매뉴얼이 무엇일까? 223

10.2 비상 대응 매뉴얼의 필수사항 224

__10.2.1 의사결정 트리 224

__10.2.2 승인 프로세스 225

__10.2.3 우회 메커니즘 226

__10.2.4 다음 단계 227

10.3 언제 비상 대응 매뉴얼을 사용할까? 229

요약 229

 

CHAPTER 11 코드 리뷰와 페어 프로그래밍 233

11.1 코드 리뷰를 해야 할까, 페어 프로그래밍을 해야 할까? 234

__11.1.1 페어 프로그래밍으로 코드 리뷰 보완하기 235

__11.1.2 페어 프로그래밍이 코드 리뷰를 대체할 수는 없다 236

11.2 페어 프로그래밍을 프로세스에 통합하기 238

__11.2.1 페어 프로그래밍 시도를 위해 팀 설득하기 238

__11.2.2 페어 스타일 240

__11.2.3 효과적인 페어 프로그래밍을 위한 고려사항 243

요약 251

 

CHAPTER 12 코드 리뷰와 몹 프로그래밍 253

12.1 코드 리뷰 vs. 몹 프로그래밍 254

__12.1.1 몹 프로그래밍의 장점 255

__12.1.2 몹 프로그래밍으로 코드 리뷰 보완하기 257

__12.1.3 몹 프로그래밍은 코드 리뷰를 대체할 수 없다 259

12.2 몹 프로그래밍을 코드 리뷰와 통합하기 260

__12.2.1 상호 보완 접근 방식 261

__12.2.2 몹 프로그래밍의 핵심 요소 266

요약 269

 

CHAPTER 13 코드 리뷰와 AI 271

13.1 코드 리뷰에서 AI의 이점 272

__13.1.1 리뷰 속도 향상 272

__13.1.2 코드 품질 개선 273

__13.1.3 리뷰 일관성 274

__13.1.4 팀과 코드베이스의 규모에 영향을 받지 않는 리뷰 확장성 274

13.2 AI 코드 리뷰의 한계 274

__13.2.1 맥락과 도메인 지식 이해의 어려움 274

__13.2.2 학습 데이터에 크게 의존하는 성능 276

__13.2.3 AI에 과도한 의존은 리뷰어의 전문성을 저해할 수 있다 276

13.3 AI 기반 코드 리뷰가 무엇을 할 수 있을까? 277

13.4 AI를 코드 리뷰에 통합하기 287

13.5 코드 리뷰의 미래: 인간과 AI의 협업 289

요약 290

 

APPENDIX A 팀 워킹 어그리먼트 스타터 템플릿 294

 

APPENDIX B 비상 대응 매뉴얼 스타터 템플릿 300

B.1 비상 대응 매뉴얼 명명하기 300

B.2 의사결정 트리 300

B.3 승인 프로세스 301

B.4 우회 메커니즘(관련 작업) 301

B.5 다음 단계 302

__B.5.1 문서화 302

__B.5.2 커뮤니케이션 302

__B.5.3 사후 분석 303

 

APPENDIX C PR 템플릿 304

 

APPENDIX D 리소스 307

D.1 각 장의 리소스 리스트 307

D.2 언어별 린터 리스트 313

D.3 언어별 정적 분석 도구 318

 

APPENDIX E 한국어판 부록: 한국 개발자의 코드 리뷰 이야기 339

E.1 AI와 함께 진화하는 코드 리뷰 문화(김연태) 339

E.2 코드 리뷰가 시스템이 되는 순간(김완섭) 341

E.3 작게 나누고 크게 배우는 코드 리뷰 문화(선용주) 342

E.4 완벽보다 팀을 택하는 코드 리뷰 문화(윤기쁨) 344

E.5 팀과 개인을 모두 성장시키는 코드 리뷰의 태도(임슬기) 345

 

참고 문헌 348

찾아보기 352

 

 

제이펍 소식 더 보기(제이펍의 소통 채널에서 더욱 다양한 소식을 확인하세요!)

블로그  유튜브  인스타그램  트위터  페이스북