2026년 10월 14일부터 18일까지, 5일간의 WIL(Week In Learning) 회고를 정리한다. 결론부터 말하면, 이번 주의 가장 큰 교훈은 "코드 한 줄의 위치가 프로젝트 전체의 흐름을 바꾼다"는 것이다. 실제로 서비스 배포 직전에 발견한 단 한 줄의 조건문 누락이 전체 로직을 뒤흔들었고, 이를 해결하는 과정에서 팀 전체의 코드 리뷰 문화도 함께 바뀌었다.
코드 한 줄이 왜 프로젝트 전체를 바꿨을까
10월 14일, 평소와 다름없이 기능 개발을 진행하던 중이었다. 사용자 인증 로직을 리팩토링하면서 if (user.isActive) 조건 하나를 다른 함수로 옮겼는데, 이때 기존 함수의 뒷부분에 있던 예외 처리 구문이 함께 이동하지 않았다. 문제는 이 조건이 단순히 "활성 사용자 확인"이 아니라, 이후의 모든 권한 부여 로직과 데이터 접근 제어의 시작점이었다는 점이다.
이 한 줄이 빠지면서 비활성 사용자도 관리자 권한을 얻을 수 있는 상황이 발생했다. 다행히 사내 QA 과정에서 발견됐지만, 만약 배포 후에 드러났다면 상당한 규모의 데이터 보안 사고로 이어질 뻔했다.
코드 리뷰에서 이번 사례가 주는 교훈
이번 사건을 계기로 팀 내부에서 코드 리뷰 방식을 다시 점검했다. 핵심은 단순히 "코드가 동작하는가"가 아니라 "이 코드가 전체 시스템에서 어떤 위치에 있는가"를 함께 보는 것이었다.
- 조건문·예외 처리·권한 확인 로직은 이동할 때 반드시 원래 함수의 실행 순서를 함께 검토할 것
- 리팩토링 PR은 기존 코드와의 diff뿐 아니라, 해당 함수를 호출하는 모든 지점을 함께 확인할 것
- "이 줄을 왜 여기에 두었는가"에 대한 주석이 없으면, 이후 수정하는 개발자가 의도를 놓치기 쉽다는 점을 인지할 것
이번 주 배운 것을 실제 업무에 적용하는 방법
이 경험을 단순한 사고 수습으로 끝내지 않고, 다음부터 적용할 수 있는 원칙으로 정리했다. 첫 번째는 코드 이동 시 "영향 범위 체크리스트"를 작성하는 것이다. 함수 하나를 옮기더라도 해당 함수가 호출되는 모든 곳, 그리고 그 함수가 의존하는 모든 변수의 생명주기를 함께 확인하는 습관을 들였다.
두 번째는 PR 설명에 "왜 이 코드가 이 위치에 있어야 하는가"를 한 문장으로라도 적는 것이다. 이 간단한 습관이 리뷰어의 이해도를 크게 높였고, 불필요한 질문과 되돌림 작업이 줄어들었다.
WIL 회고를 더 의미 있게 만드는 기록법
이번 5일간의 기록을 돌아보면, 단순히 "무엇을 했는가"보다 "무엇을 놓쳤는가"가 더 오래 기억에 남는다. WIL을 작성할 때 다음 세 가지를 함께 적는 것을 추천한다.
- 발생한 문제의 원인과 그 문제가 왜 발생했는지에 대한 분석
- 문제 해결 과정에서 새롭게 알게 된 팀 규칙이나 업무 방식
- 다음 주에 동일한 실수를 방지하기 위한 구체적인 행동 항목
이번 주 기록에는 위 세 가지가 모두 포함되었고, 특히 "코드 한 줄의 위치"에 대한 인식이 팀 전체에 퍼지면서 이후 리뷰 속도가 눈에 띄게 빨라졌다.
Q. WIL은 꼭 매주 써야 하나요?
격주로 작성해도 충분하다. 중요한 것은 주기적으로 자신의 업무 방식을 돌아보는 것이지, 일정한 간격을 지키는 것이 아니다. 다만, 문제가 발생한 주에는 반드시 기록을 남기는 것이 좋다.