Linear의 코드 리뷰
TMT우리의 코드 리뷰 절차는 사람이 코드를 쓰던 시절에 만들어졌습니다
대부분의 엔지니어링 팀이 그랬고, 우리도 비슷한 문제를 겪었습니다. 예전 방식대로 코드를 리뷰하면 에이전트 덕분에 아낀 시간의 상당 부분을 리뷰에 다시 쓰게 됐습니다. 그래도 품질이 꼭 나아지는 것은 아니었습니다. 리뷰 요건을 완화하면 더 빠르게 배포할 수 있지만, 배포하는 변경 사항을 그만큼 확신하기 어려워집니다.
어디서 균형을 잡아야 할지는 계속 달라집니다. 균형점을 찾을 때 우리가 가장 중요하게 보는 것은 사람의 시간과 주의를 꼭 필요한 곳에 쓰는 일입니다.
이 글에서는 우리가 이 문제에 어떻게 대응하고 있는지, 리뷰 절차가 어떻게 달라졌고 그에 따라 어떤 개발 방식이 자리 잡고 있는지 소개합니다. 에이전트의 역량이 높아지면 지금의 방식 중 일부는 한계를 드러낼 수 있고, 우리의 생각도 함께 바뀔 것입니다. 코드 리뷰가 앞으로 어떻게 달라질지도 짚어 보고, 그 과정에서 배운 점은 계속 공유하겠습니다.
리뷰하는 방식
예전에는 사람이 리뷰하는 것이 기본이었습니다
예전에는 코드베이스의 모든 변경을 머지하기 전에 두 사람이 관여해야 했습니다. 해당 코드를 책임지는 엔지니어 한 명과 이를 리뷰하는 팀 동료 한 명이었습니다.
엔지니어가 대부분의 코드를 직접 작성할 때는 이 방식이 잘 맞았습니다. 하지만 2025년 말 GPT-5.2와 Claude Opus 4.5가 출시되면서 AI 코딩 역량이 크게 뛰었고, 우리도 리뷰 방식을 다시 생각하게 됐습니다.
변화가 임박했다는 첫 신호는 배포하는 코드의 양이 크게 늘었다는 점이었습니다.
2026년 1월부터 10월까지 코드베이스에 머지된 PR은 2,111건에서 5,341건으로 153% 늘었습니다. 팀이 오프사이트 행사에 참여한 4월에는 잠시 줄었습니다.
2026년 1월부터 10월까지 월별로 머지된 PR 수
master브랜치에 머지된 PR만 집계했습니다.
같은 기간 코드베이스에 기여한 사람은 58명에서 71명으로 22% 늘었습니다.
팀 규모보다 코드량이 더 빠르게 늘었습니다. 작성자 1인당 머지된 PR 수는 두 배가 됐습니다.
2026년 1월부터 10월까지 작성자 1인당 머지된 PR 수
리뷰 부담은 그해 초부터 이미 커지고 있었습니다.
작성하는 코드가 늘면서 엔지니어가 맡아야 할 리뷰도 늘었습니다. 1월부터 6월까지 작성자 1인당 리뷰 요청 건수는 38% 증가했습니다.
PR 자체도 커지면서 부담이 더해졌습니다. 2026년 1월에는 PR에서 변경한 코드 줄 수의 중앙값이 47줄이었지만, 7월에는 108줄로 두 배 넘게 늘었습니다.
2026년 1월부터 7월까지 월별 PR 크기
변경 줄 수 집계에서는 코드 생성 도구로 만든 코드를 제외했습니다.
그사이 눈에 덜 띄는 변화도 있었습니다. 에이전트가 구현을 더 많이 맡으면서 PR 작성자가 하는 일이 점차 리뷰어의 일과 비슷해졌습니다.
PR을 책임지는 엔지니어는 에이전트가 작성한 코드를 검토하는 경우가 많아졌습니다. 이어서 동료 엔지니어가 같은 변경 사항을 다시 살폈습니다.
두 엔지니어 모두 리뷰할 때 에이전트의 도움을 받는 경우가 많았습니다. 우리도 버그를 찾으려고 자동 리뷰 도구를 시험하기 시작했지만, 자동 리뷰는 언제나 1차 검토에 그쳤습니다. 머지하기 전에는 PR 작성자와 동료 리뷰어가 여전히 코드를 검토했습니다.
코드를 직접 쓰는 일이 줄어들었지만, 리뷰 절차는 사람이 코드를 쓰던 시절의 방식을 그대로 따르고 있었습니다.
이제는 필요할 때 동료가 리뷰합니다
지금은 에이전트가 모든 PR을 먼저 리뷰합니다. 작성자는 피드백에 대응한 뒤 변경 사항에 확신이 들면 직접 승인하고 머지할 수 있습니다. 동료에게도 리뷰를 요청할 수 있으며, 변경 사항에 따라 필요성을 판단합니다.
사람이 어떤 리뷰에 시간을 들일 때 가장 가치가 큰지 알아가면서 우리 방식도 달라졌습니다. 2026년 7월부터는 데이터에서도 변화가 보이기 시작했습니다.
2026년 1월부터 6월까지 머지된 PR 중 작성자만 검토한 건은 약 2.5%였습니다. 대부분 예외적인 상황에서 이루어진 수정이었습니다. 7월에는 동료의 추가 리뷰 없이 머지한 PR의 비율이 14%로 뛰었습니다. 이후 꾸준히 올라 10월에는 53%에 이르렀습니다.
2026년 1월부터 10월까지 추가 리뷰를 요청한 사람 수에 따른 머지된 PR 비율
작성자는 모든 PR을 리뷰합니다. 리뷰어 수는 작성자를 제외한 사람만 셉니다.
이제 우리 엔지니어들은 그 어느 때보다 많은 PR을 머지하면서도 리뷰 요청은 더 적게 받습니다.
10월에 작성자 1인당 머지된 PR은 월 72건으로, 1월의 36건에서 두 배로 늘었습니다. 동료에게 보낸 리뷰 요청은 작성자 1인당 6월 85건에서 10월 54건으로 줄었습니다.
2026년 1월부터 10월까지 작성자 1인당 머지된 PR 수와 리뷰 요청 수
여러 엔지니어가 머지 직전에 모든 변경 사항을 검증하는 방식은 이제 시간을 가장 잘 쓰는 방법이 아닙니다. 우리 팀은 규모가 비교적 작고 경험이 많아, 각 엔지니어가 동료의 검토가 필요한 때를 판단할 수 있다고 믿습니다.
정해진 판단 기준은 없지만, 대체로 어떤 변경인지, 잘못됐을 때 어떤 영향이 생길지를 살핍니다.
작성자가 직접 승인하는 경우가 많은 변경
- 일반적인 버그 수정
- 동작을 바꾸지 않는 리팩터링이나 성능 개선처럼 개선 여부가 명확한 변경
- 사용자에게 공개하기 전에 테스트하고 조정할 수 있도록 기능 플래그로 제어하는 변경
동료의 추가 리뷰가 필요한 경우가 많은 변경
- 구현이 유난히 복잡하거나, 기존 패턴에서 벗어나거나, 핵심 컴포넌트를 수정하는 변경
- 사용자가 체감할 만큼 사용 경험이 달라져, 코드가 올바른지 살피는 것만큼 제품 관점의 판단이 중요한 변경
그 판단을 신뢰하면서도 명시적인 안전장치를 둡니다. 인증, 인프라, 배포 설정처럼 민감한 영역을 변경하면 반드시 동료 한 명이 추가로 리뷰해야 합니다. 이 요건을 충족해야만 PR을 머지할 수 있도록 시스템이 자동으로 확인합니다.
최근 데이터에서는 작성자의 근속 기간과 역할에 따라서도 추가 리뷰 비율에 차이가 나타났습니다. 2026년 9월부터 11월까지 Linear에 입사한 지 3개월 이내인 사람이 작성한 PR 중 79%가 동료의 추가 리뷰를 받았습니다. 입사한 지 2년이 넘은 사람이 작성한 PR에서는 46%였습니다.
Linear 근속 기간별로 동료의 추가 리뷰를 받은 PR 비율
직무별로도 비슷한 차이가 있습니다. 엔지니어가 작성한 PR의 46%가 동료의 추가 리뷰를 받았습니다. 디자이너가 작성한 PR은 65%, 제품 직군과 기타 직군이 작성한 PR은 74%였습니다.
작성자의 직무별로 동료의 추가 리뷰를 받은 PR 비율
개발하는 방식
실제로 동작하는 코드로 판단합니다
코드를 작성하는 데 비용이 많이 들던 때에는 구현에 앞서 접근 방식에 합의하는 데 엔지니어의 시간을 쓰는 편이 합리적이었습니다. 이제는 엔지니어가 여러 대안을 구현해 보고, 하나를 택하기 전에 동료들과 각각의 장단점을 살펴볼 수 있습니다. 최종적으로 채택하지 않은 구현까지도 팀이 직접 시험하고 배울 수 있는 구체적인 사례가 됩니다. 덕분에 다음에 무엇을 만들지 더 명확해집니다. 짐작하셨겠지만, 우리 팀은 그런 논의도 Linear에 작업으로 기록해 관리합니다.
실험을 더 많이 한다는 신호 중 하나는 머지하지 않고 닫은 PR의 수입니다. 이 수치는 지난 1년 사이 거의 다섯 배로 늘었고, 2026년 1월부터는 뚜렷한 증가세를 보였습니다.
2025년 10월부터 2026년 10월까지 머지하지 않고 닫은 PR 수
에이전트에게 변경 사항이 동작하는 모습을 보여 달라고 합니다
또 하나 자리 잡고 있는 방식은 에이전트가 작업을 마치면 변경 사항이 실제로 동작한다는 근거까지 보여 달라고 하는 것입니다. 엔드투엔드 테스트와 기존 QA를 발전시킨 방식이라고 생각합니다.
에이전트에게 자신이 변경한 내용을 테스트하고 그 증거를 초안 PR에 첨부하라고 지시합니다. 변경 전후 스크린샷, 기능이 어떻게 동작하는지 보여 주는 동영상, 성능이 개선됐음을 보여 주는 벤치마크 결과 등이 그 예입니다. 눈에 잘 띄지 않는 시각적 변화는 에이전트가 스크린샷에 표시해 차이를 쉽게 알아볼 수 있게 합니다.
코드 변경 내역을 넘어
리뷰의 미래
코드 리뷰 방식은 지금도 달라지고 있습니다. 당분간은 엔지니어가 계속 코드를 리뷰할 것으로 봅니다. Linear에는 관련 변경 사항을 묶고, 변경 의도를 설명하며, 중요한 수정 부분을 쉽게 알아볼 수 있게 하는 도구를 만들었습니다. 모델과 리뷰 에이전트가 발전하면서 사람이 직접 코드를 리뷰하는 양은 점차 줄어들 가능성이 큽니다.
리뷰 에이전트를 시험해 보니, 대부분은 코드가 그렇게 작성되기까지 팀이 어떤 결정을 내렸는지 모른 채 리뷰했습니다. 새로 합류한 엔지니어가 팀에서 여러 차례 논의 끝에 만들지 않기로 한 기능을, 그 사실을 모르고 구현해 PR을 올렸다고 해 봅시다. 구현에 문제가 없다면 지금의 리뷰 에이전트 대부분은 지적할 이유를 찾기 어려울 겁니다. 코드가 의도한 대로 동작하는지는 판단할 수 있지만, 그 기능을 애초에 만들어야 하는지 따져 보려면 팀의 결정 맥락이 필요합니다.
앞으로는 사람이 필요할 때 특정 코드를 더 쉽게 검토하고, 사람의 리뷰 없이도 더 많은 PR을 머지할 수 있게 될 것으로 봅니다. 리뷰에서 판단하는 범위도 기술적인 구현을 넘어 더 넓어질 것입니다. 리뷰 에이전트가 코드를 정확하고 꼼꼼하게 검토할 수 있게 되더라도, 그 변경을 제품에 반영할 가치가 있는지는 여전히 판단해야 합니다.