Ask HN: AI 지원 코드의 인간 코드 리뷰에 어떤 도구를 사용하고 계신가요?
Ask HN: What tools are you using for human code review of AI-assisted code?
저희와 동료들은 이제 에이전트 지원 코드를 엄청난 속도로 생산하고 있으며, 그중 일부는 실제로 좋지만 많은 부분이 그렇지 않습니다. 개인적으로 프로젝트의 실제 품질 관문은 생성된 코드가 단순히 올바른지뿐만 아니라 아키텍처적으로 타당한지 인간이 얼마나 철저히 리뷰했는지에 달려 있다고 생각합니다. Coderabbit, Copilot 같은 AI 코드 리뷰 도구나 Claude Code를 PR에 적용하는 것은 버그와 스타일 문제를 찾는 데는 꽤 유능하지만, 중복 코드, 모듈 간 결합도, 관심사 분리 문제 등을 찾는 데는 프롬프트를 줘도 덜 효과적입니다. GitHub의 PR 인터페이스는 리뷰가 작았을 때도 불안정했는데, 이제는 규모가 커져 감당하기 어려워졌습니다. 에이전트 리뷰와 사람들이 에이전트 출력물을 복사-붙여넣기하는 '미트 프록시' 노이즈까지 더해져 매우 혼란스럽고 탐색하기 어렵습니다. AI 지원 코드의 인간 리뷰를 간소화하는 데 효과적인 도구나 프로세스가 있다면 무엇인가요?
저는 PR 설명에 생성 AI 사용 여부를 명시하고, 리뷰어가 생성된 코드에 집중할 수 있도록 변경 사항을 논리적 단위로 분리하는 것을 선호합니다. 또한 리뷰어가 아키텍처 수준의 우려 사항을 논의할 수 있는 별도의 '아키텍처 리뷰' 단계를 두는 것이 도움이 됩니다.
저는 코드 리뷰에 Graphite를 사용하고 있습니다. 스택형 PR을 통해 변경 사항을 더 작고 검토 가능한 단위로 나눌 수 있으며, GitHub의 기본 PR 인터페이스보다 훨씬 깔끔합니다. 에이전트가 생성한 코드를 검토할 때 특히 유용합니다.
저는 AI 리뷰 도구를 전혀 사용하지 않습니다. 대신 팀 내에서 '페어 리뷰'를 강조합니다. 두 명의 개발자가 함께 앉아 생성된 코드를 검토하며, 이 과정에서 아키텍처 문제를 더 잘 발견할 수 있습니다. 또한 리뷰어가 코드베이스의 전반적인 구조를 이해하는 데 도움이 됩니다.
저는 생성된 코드에 대해 '설계 문서'를 먼저 작성하도록 강제합니다. 에이전트가 코드를 작성하기 전에 접근 방식을 문서화하면, 리뷰어가 코드 자체보다는 설계의 타당성을 검토할 수 있습니다. 이렇게 하면 아키텍처 문제를 사전에 잡아내는 데 효과적입니다.
저는 PR에 대해 '변경 사항 요약'을 자동으로 생성하는 사용자 지정 스크립트를 사용합니다. 이 요약은 코드베이스의 관련 부분과의 차이점을 강조하여 리뷰어가 핵심 변경 사항에 집중할 수 있게 합니다. 또한 에이전트가 생성한 코드에는 'AI 생성' 태그를 달아 리뷰어가 더 주의 깊게 살펴보도록 합니다.