새로운 AI 기반 코드 리뷰 도구인 '파라노이아(Paranoia)'가 개발자들 사이에서 주목받고 있습니다. 이 도구는 로컬 환경에서 실행되며, 개발자의 코드뿐만 아니라 개발 계획과 결정까지도 비판적인 시각으로 검토합니다. 특히 클로드 코드(Claude Code)나 코덱스(Codex)와 같은 다른 AI 코딩 에이전트를 활용하여, 마치 '다른 전선의 코딩 에이전트'가 냉정하게 코드를 평가하는 듯한 경험을 제공합니다.
파라노이아는 사용자의 코드 저장소에 대한 읽기 전용 접근 권한을 부여받아 작동합니다. 사용자는 클로드 코드에 파라노이아를 설치하여 코덱스(Codex)가 리뷰를 수행하게 하거나, 코덱스에 설치하여 클로드 코드(Claude Code)가 리뷰를 수행하게 할 수 있습니다. 파라노이아는 이 두 에이전트 사이의 'MCP 서버' 역할을 하며, 적절한 프롬프트를 구성하고, 다른 에이전트를 읽기 전용 모드로 실행한 다음, 구조화된 비판을 반환합니다. 주요 기능으로는 특정 브랜치, 변경 사항, 또는 작업 트리를 검토하는 'critique_branch', 계획 문서를 코드와 비교하여 검토하는 'critique_plan', 특정 질문에 대한 답변을 제공하는 'query', 이전 리뷰의 문제 제기에 이의를 제기하는 'rebut', 그리고 여러 옵션 중 최적의 결정을 돕는 'arbitrate' 등이 있습니다.
파라노이아의 핵심은 '수렴 루프(convergence loop)'라는 독특한 리뷰 방식입니다. 이는 한 번의 리뷰로 모든 문제가 해결되지 않는다는 전제하에, 개발자가 코드를 수정하고 다시 리뷰를 요청하는 과정을 반복하며 점진적으로 코드 품질을 향상시키도록 설계되었습니다. 각 라운드(round)는 이전 라운드의 내용을 기억하지 않는 '새로운, 냉철한 리뷰어'가 검토하며, 라운드 번호가 증가할수록 심각도가 낮은 문제 제기는 줄어들고 병합(merge)을 방해하는 핵심적인 문제에 집중합니다. 또한, 'stakes' 설정을 통해 프로젝트의 실제 배포 환경과 위협 모델을 정의하여 리뷰의 범위를 제한하고, 'already_raised' 기능을 통해 이미 수용한 문제 제기는 반복하지 않도록 하여 효율성을 높입니다. 이러한 접근 방식은 개발자가 반복적인 개선 과정을 통해 최종적으로 고품질의 코드를 만들 수 있도록 돕습니다.