🧑🏻💻 Ep.06 | AI 시대의 코드 리뷰는 왜 더 어려워졌나
PR 알림이 쌓입니다. 하루에 5개, 많으면 10개. AI가 코드를 작성해주니까 PR 올리는 속도도 빨라졌습니다. 리뷰어의 머릿속에 한 가지 유혹이 스칩니다.
"AI가 짠 코드니까 빠르게 훑고 Approve 누르자."
하지만 이 유혹에 넘어가면 문제가 천천히, 확실하게 쌓입니다.
1. AI가 코드를 쓴다는 것이 리뷰어에게 의미하는 것
AI가 코드를 쓰기 시작하면 두 가지가 동시에 일어납니다. 코드 양이 늘어나고, 작성자의 맥락이 줄어듭니다. 예전에는 코드를 작성한 사람에게 "이거 왜 이렇게 했어?"라고 물어보면 대답이 돌아왔습니다. 직접 짰으니까요. 고민의 흔적이 머릿속에 남아 있습니다.
AI가 작성한 코드는 다릅니다. 작성을 요청한 사람도 세부 구현을 전부 파악하고 있지 않은 경우가 많습니다.
리뷰어는 이제 코드를 쓴 사람이 아니라 코드 자체를 읽어야 합니다. 작성자에게 의도를 묻는 것만으로는 부족해졌습니다.
2. 그럴듯하게 틀리는 코드의 패턴
앞선 글에서 이야기했듯이, AI가 만든 코드는 컴파일도 되고 테스트도 통과합니다. 문제는 의도와 다르게 동작하는 코드가 그럴듯한 외형을 갖고 있다는 점입니다.
자주 보이는 패턴이 있습니다.
- 트랜잭션 경계가 너무 넓거나 좁게 설정됨
- 예외 처리가 있긴 한데 잘못된 레이어에서 잡고 있음
- 동시성 이슈가 발생할 수 있는 코드인데 단일 스레드 테스트만 통과함
- 기존 코드와 비슷하지만 미묘하게 다른 패턴을 사용함
이런 코드는 배포 직후에는 문제가 없습니다. 3개월 뒤, 트래픽이 몰리거나 데이터가 쌓이면 그때 터집니다.
3. 리뷰에서 봐야 할 것 vs 넘겨도 되는 것
리뷰어의 시간은 한정되어 있습니다. AI가 만든 코드든 사람이 짠 코드든 전부 같은 강도로 볼 수는 없습니다.
사람이 집중해야 할 것
- 설계 의도와 코드가 일치하는지
- 비즈니스 로직의 엣지 케이스 처리
- 기존 시스템과의 정합성
- 트랜잭션, 동시성, 장애 전파 같은 런타임 이슈
도구에 맡겨도 되는 것
- 코드 포매팅
- import 정렬
- 네이밍 컨벤션의 단순 위반
- 린터가 잡아줄 수 있는 것들
포맷은 린터에게, 설계는 사람에게. 이 구분이 명확할수록 리뷰 시간이 의미 있게 쓰입니다.
4. AI가 만든 코드를 리뷰하는 방법
코드만 보고 리뷰하면 맥락이 부족합니다. AI에게 어떤 지시를 했는지, 어떤 제약 조건을 줬는지를 알면 리뷰 품질이 올라갑니다. 한 가지 방법이 있습니다. PR 설명에 프롬프트 요약을 남기는 것입니다.
- 어떤 문제를 풀려고 했는지
- AI에게 어떤 맥락을 줬는지
- 생성된 코드에서 직접 수정한 부분은 어디인지
이걸 남겨두면 리뷰어가 "왜 이렇게 했는지"를 추측하지 않아도 됩니다. 처음에는 귀찮게 느껴질 수 있습니다. 하지만 맥락 없는 PR 10개를 리뷰하는 것보다 맥락 있는 PR 10개를 리뷰하는 게 훨씬 빠릅니다.
5. 리뷰 기준을 팀이 공유하는 방법
개인마다 리뷰 기준이 다르면 피드백이 들쭉날쭉해집니다. "이건 왜 이번에는 괜찮고 저번에는 안 됐어?" 이런 질문이 나오기 시작하면 신호입니다.
팀의 규칙 문서에 리뷰 기준을 함께 관리하세요.
앞선 글에서 `CLAUDE.md` 같은 규칙 파일 이야기를 했습니다.
이 문서에 리뷰 체크리스트를 함께 관리하면 AI에게 시킬 때도, 사람이 리뷰할 때도 같은 기준을 적용할 수 있습니다.
- "트랜잭션 경계는 서비스 레이어에서만 열어라"
- "새 API를 추가할 때는 기존 에러 코드 체계를 따라라"
- "외부 API 호출에는 반드시 타임아웃을 설정하라"
이런 것들을 명시해두면 AI가 만든 코드의 품질도 올라가고, 리뷰어의 판단 기준도 일관됩니다.
6. 결국 리뷰는 팀의 설계 감각을 키우는 과정
코드 리뷰를 "통과 판정"으로 보면 시간 낭비처럼 느껴집니다. 하지만 리뷰는 원래 설계를 두고 대화하는 시간입니다.
"이 방식이 맞나?"
"이 구조가 3개월 뒤에도 괜찮을까?"
"더 단순한 방법은 없을까?"
AI가 코드를 빠르게 만들어주는 시대에, 이 대화의 가치는 오히려 더 커졌습니다.
AI가 PR을 쏟아내는 시대, 리뷰 기준을 함께 만들어가는 팀이 결국 더 빠르게 성장합니다.
🌱 리뷰 기준을 함께 만들어가는 개발자들의 모임, 루퍼스
코드 리뷰는 혼자 하는 일이 아닙니다. 기준을 함께 만들고, 서로의 코드를 읽으며 감각을 키우는 과정이죠. 그 과정을 함께할 동료가 필요하다면 루퍼스에서 시작해보세요🙂
AI 시대에도 결국 중요한 건 생각하는 힘과 성장하는 환경이라고 믿습니다.
루퍼스에는 성장에 진심인 650+명의 크루가 함께하고 있습니다. 현업에서 부딪히는 고민과 경험을 나누며 함께 성장하는 크루들의 이야기. 전액 기부 강의 그리고 다양한 오프라인 네트워킹까지! 루퍼스는 개발자를 위한 지속 가능한 성장을 만들어 갑니다.
📢 LOOPERS의 소식이 궁금하다면?
Share article