CodeRabbit 리뷰 코멘트의 근거를 확인하고 직접 조정하세요
해당 블로그는 Sahana Vijaya Prasad 원저자의 글 'Stop guessing why CodeRabbit posted that review comment'을 번역한 것입니다. 더 나은 이해를 위해서 약간의 의역이 반영되었습니다.
수만 명의 개발자가 매주 수백만 건의 풀 리퀘스트를 CodeRabbit에 맡겨 리뷰를 받습니다. 리뷰 하나하나는 CodeRabbit이 뒤에서 모아 둔 수십 가지 컨텍스트를 바탕으로 만들어집니다. 지금까지 CodeRabbit 코멘트는 무엇을 발견했는지는 보여 줬지만 그 판단의 근거는 드러나지 않았습니다.
이제 각 코멘트의 근거가 된 컨텍스트를 확인할 수 있습니다. 그 근거가 여러분의 레포지토리와 맞지 않는다면 해당 소스를 리뷰에서 빼면 됩니다.
먼저 코멘트 자체를 살펴보겠습니다. CodeRabbit은 풀 리퀘스트를 리뷰할 때 사람 리뷰어가 그러듯 변경된 줄에 인라인 코멘트를 답니다. 코멘트마다 특정 코드 범위를 짚어 무엇을 발견했는지 설명하고 대개 수정 제안까지 함께 제시합니다. 리뷰 한 번에 여러 개의 코멘트가 달릴 수 있습니다.
이번 업데이트 전에는 코멘트가 발견 사항만 말하고 거기서 멈췄습니다. CodeRabbit이 무엇을 지적했는지는 읽을 수 있었지만 그 코멘트를 촉발한 컨텍스트는 보이지 않았습니다. 코멘트가 잘못돼 보여도 선택지는 받아들이거나 무시하는 것뿐이었죠. 무시하더라도 그 밑에 깔린 컨텍스트는 그대로 남기 때문에 다음 풀 리퀘스트에서 같은 코멘트가 다시 올라올 수 있었습니다.
이제 코멘트마다 그 근거가 된 컨텍스트를 알려 주는 Source 라인이 붙고 두 개의 설정 페이지에서 그 컨텍스트를 열어 바꿀 수 있습니다. 코멘트가 잘못돼 보이면 정확히 어떤 가이드라인이나 연결된 레포지토리에서 비롯됐는지 추적한 다음 해당 가이드라인을 지우거나 레포지토리를 끄면 됩니다. 그러면 이후 리뷰에서는 그 코멘트가 더 이상 나타나지 않고 시간이 지날수록 피드백이 팀의 실제 작업 방식에 맞게 다듬어집니다.
소스는 코멘트를 읽으면서 그 무게를 가늠하는 방식도 바꿔 놓습니다. 린터에 기댄 지적과 코딩 가이드라인이나 연결된 레포지토리에서 나온 지적은 읽는 느낌부터 다릅니다. 소스는 각 코멘트가 무엇에 근거하는지 알려 주므로 더 빠르게 판단할 수 있죠.
이 모든 일이 벌어지는 곳은 새로 추가된 세 가지 화면입니다. Code guidelines(코드 가이드라인)와 Auto-linked repositories(자동 연결 레포지토리)는 레포지토리 설정에 새로 생긴 Contextual understanding 섹션 아래에 자리합니다. 세 번째는 모든 리뷰 코멘트 맨 아래에 붙는 Source 라인입니다.
Code guidelines: 리뷰를 이끄는 규칙
레포지토리를 열고 Settings로 이동한 뒤 Contextual understanding 아래에서 Code guidelines를 선택하세요. 이 페이지에는 CodeRabbit이 해당 레포지토리의 가장 최근 리뷰에서 적용한 모든 코딩 가이드라인이 나열됩니다.
CodeRabbit은 이미 레포지토리에 들어 있는 가이드라인 파일에서 이 규칙들을 읽어 옵니다. AGENTS.md, CLAUDE.md, .cursorrules 같은 파일이죠. 자동으로 감지하는 모든 파일 형식은 문서에서 확인하실 수 있습니다. 각 행에는 가이드라인 내용과 그 규칙이 적용되는 경로, 그리고 어떤 파일에서 왔는지가 표시되므로 규칙마다 출처 파일을 바로 알 수 있습니다. 목록을 검색하거나 파일별로 필터링하고 CSV로 내보내거나 행을 열어 전체 내용을 읽을 수도 있습니다.
어떤 규칙을 더 이상 적용하고 싶지 않다면 삭제하면 됩니다. 상세 패널에서 가이드라인 하나를 지우거나 여러 개를 선택해 한꺼번에 지울 수 있습니다. 변경은 다음 리뷰부터 반영되고 그 이후로도 계속 적용됩니다. 레포지토리에 있는 원본 파일은 그대로 남습니다. 여러분은 코드를 고치는 게 아니라 CodeRabbit이 참고하는 내용을 조정하는 것뿐입니다.
Auto-linked repositories: CodeRabbit이 함께 살펴보는 것
Contextual understanding 아래 두 번째 화면은 Auto-linked repositories입니다. CodeRabbit은 조직 안에서 지금 레포지토리가 의존하는 다른 레포지토리를 찾아 리뷰 도중 컨텍스트로 함께 읽습니다. 덕분에 호환성을 깨는 변경이나 하위 시스템에 미치는 영향까지 잡아낼 수 있습니다.
연결된 레포지토리마다 이름과 활성화 상태, 그리고 지침 요약이 표시됩니다. 그 레포지토리가 무엇인지, 현재 레포지토리가 어떻게 활용하는지, 리뷰 중 CodeRabbit이 언제 살펴봐야 하는지를 담은 요약입니다. CodeRabbit은 이 요약을 아키텍처와 선언된 의존성, 임포트 그래프를 바탕으로 작성합니다.
관련이 없는 레포지토리는 꺼 두면 CodeRabbit이 리뷰에서 제외합니다. 기능 전체를 켜거나 끄려면 Knowledge Base 탭의 Automatic Repository Linking 토글을 사용하세요. Auto-linked repositories는 Pro Plus와 Enterprise 플랜에서 사용할 수 있습니다.
Source 라인: 코멘트가 무엇에 근거했는가
마지막 조각은 코멘트 자체에 있습니다. 각 인라인 코멘트 맨 아래의 Source 라인이 그 근거가 된 컨텍스트를 이렇게 알려 줍니다.
Sources: Linters/SAST tools, Coding guidelines
가능한 소스는 일곱 가지입니다. Coding guidelines, Path instructions, Learnings, MCP tools, Linked repositories, Linters/SAST tools, Pipeline failures가 여기에 해당합니다. 한 코멘트에 여러 소스가 함께 표시될 수도 있습니다.
Source 라인은 코멘트를 설명해 줄 뿐입니다. 무언가 잘못됐다고 주장하는 것도 아니고 코멘트의 심각도나 대응 필요 여부와도 관계가 없습니다.
바로 여기에서 세 화면이 연결됩니다. Source 라인이 Coding guidelines나 Linked repositories를 가리키는데 코멘트가 어딘가 이상해 보인다면 해당 설정 페이지를 열어 그 근거가 된 정확한 컨텍스트를 찾은 다음 가이드라인을 지우거나 레포지토리를 끄면 됩니다.
리뷰 뒤에 있는 컨텍스트를 직접 확인하세요
이 화면들은 리뷰 뒤에 있는 컨텍스트의 일부를 드러낸 것이고 그 아래에는 훨씬 더 많은 것이 깔려 있습니다. CodeRabbit은 풀 리퀘스트마다 레포지토리를 클론해 변경이 파일과 함수, API, 의존성 전반에 어떻게 연결되는지를 새로 그려 냅니다. 여기에 주변 엔지니어링 컨텍스트를 겹쳐 올립니다. PR 설명, Jira나 Linear 같은 도구에서 연결된 이슈, 레포지토리 지식, 경로별 지침, 아키텍처 표준, 과거 PR, 그리고 팀의 러닝(learnings)이 여기에 포함되죠. 린터와 SAST 도구, MCP로 연결된 시스템에서 오는 신호도 변경과 관련이 있을 때 함께 반영됩니다.
CodeRabbit은 이미 모든 리뷰에서 이 작업을 해 왔습니다. 새로워진 것은 그 과정을 직접 보고 조정할 수 있게 됐다는 점입니다. Source 라인은 코멘트가 무엇에 기댔는지 알려 줍니다. Code guidelines 페이지에서는 잘못 작동한 규칙을 덜어 낼 수 있습니다. Auto-linked repositories에서는 CodeRabbit이 어떤 레포지토리를 읽을지 정할 수 있습니다. 리뷰는 더 이상 추측이 아니라 여러분이 직접 다듬어 가는 대상이 됩니다. CodeRabbit을 열고 직접 확인해 보세요.
관련 글로 CodeRabbit이 PR을 작성자처럼 읽는 방법과 CodeRabbit Review의 Code Peek와 새 기능들, 그리고 코드 리뷰의 진짜 병목은 의도를 이해하는 일입니다를 함께 읽어 보시길 권합니다.