리뷰의 기술

1장 실패한 리뷰들, 도대체 무엇을 놓치고 있는가 1
1.1 왜 사소한 지적이 많은가? 리뷰의 목적부터 다시 생각하자 2
1.2 시간을 낭비하고 중요한 문제를 놓치는 네 가지 안티패턴 12
인간관계 끌어들이기 13
작성자 마인드 15
두 마리 토끼 잡기 16
적절치 못한 시간 분배 18
1.3 계획과 중재가 없는 어수선한 리뷰회의 20
계획성 없는 끝나지 않는 리뷰(준비 단계) 21
다툼, 주제 이탈의 방치(진행 단계) 23
갑작스러운 종료 선언(완료 단계) 26
1.4 보여주기식 경쟁으로 쓸데없는 지적을 하고 있지 않은가? 29
보여주기식 경쟁 30
헐뜯기 31
의도적인 묵인 33

2장 본격적인 리뷰 준비와 문제 검출 39
2.1 리더와 문서 작성자의 리뷰 준비: 시나리오 작성 40
리더의 준비 44
문서 작성자의 준비 51
2.2 리뷰어의 리뷰 준비: 시나리오 순서 정하기 55
2.3 리뷰의 효과를 높이는 문제 검출법 65

3장 설계 리뷰의 중심, 리뷰회의 73
3.1 순조로운 리뷰회의를 위한 준비 74
리더의 리뷰회의(전반) 75
리뷰어의 리뷰회의(전반) 83
문서 작성자의 리뷰회의(전반) 88
3.2 제 시간에 문제를 검출하는 똑똑한 리뷰회의 진행방법 89
리더의 리뷰회의(후반) 90
리뷰어의 리뷰회의(후반) 98
문서 작성자의 리뷰회의(후반) 102
3.3 유종의 미, 문제의 수정과 확인 105
문서의 수정과 확인 106
문제의 재발 방지 110
3.4 만능은 없다. 세 가지 리뷰기법을 상황에 따라 적용하자 115
워크스루: 문서 작성자가 주도하는 가벼운 회의 117
인스펙션: 규칙에 따라 엄격하게 체크 119
테크니컬 리뷰: 테크니컬 리더의 주도적인 체크 121

4장 리뷰 효과 끌어올리기 125
4.1 리뷰를 개선하는 프로젝트 다시보기 126
4.2 개발 방법에 따른 리뷰 적용하기 132
유지보수 개발 134
반복 개발 139
애자일 개발 139
패키지?클라우드 개발 140
대규모 개발 142

부록. 리뷰 관점의 축소 효과 145
A.1 리뷰 관점을 축소함으로써 수정 공수가 줄어드는 효과 146
검증① 정성적으로 리뷰 관점 줄이기 - 중요한 문제의 검출 건수가 1.4배로 150
검증② 정량적으로 리뷰 관점 줄이기 - 2.3배의 수정 공수 저감 효과 153

문서 리뷰는 요구사항을 정리하거나 설계하는 과정에서, 개발하고자 하는 시스템의 잠재적인 문제를 미리 발견하는 데 목적이 있다. 리뷰 단계에서 문제를 발견하면 실제 구현이나 테스트 과정에서 문제를 발견하는 것보다 훨씬 쉽게 문제를 해결할 수 있으며, 이는 곧 비용의 문제로 직결된다. 결국, 문제를 미리 발견하여 비용을 절감하는 것이 리뷰를 시행하는 가장 큰 목적이다.

그렇다면 어떤 문제를 검출해야 비용 효과로 이어질까? 예를 들어, 어느 워터폴(Waterfall)형 개발 프로젝트의 설계문서 리뷰회의에서 애플리케이션 간 리소스 경합(Race Condition)에 관한 문제를 검출했다고 해보자. 설계문서의 수정과 확인에는 1인시의 공수가 들었다. 만약, 리뷰에서 이 문제를 놓쳐서 통합 테스트에서 발견했다면, 얼마만큼의 수정 공수가 필요하게 될까?

문제 지적은 문제 검출만큼 중요하다. 애써 문제를 발견해도 리뷰어의 지적 방법이 올바르지 않다면 문서 작성자가 적절히 수정할 수 없거나 험악한 분위기가 되기 때문이다. 문제 지적 방법은 커뮤니케이션 기술이다. 이를 습득하는 일도 리뷰 효과를 높이는 데 빼놓을 수 없다.