open-code-review: 결정론적 엔지니어링과 LLM 에이전트를 결합하여 고정밀 피드백을 제공하는 AI 기반 코드 리뷰 CLI

해결하는 문제

Open Code Review는 코드 리뷰를 자동화하기 위해 설계된 AI 기반 CLI 도구입니다. 대규모 변경 사항에 대한 불완전한 커버리지, "position drift"(AI 코멘트가 실제 코드 라인과 일치하지 않는 현상), 그리고 순수하게 언어 기반 프롬프트로 인해 발생하는 일관성 없는 리뷰 품질과 같은 범용 AI 에이전트의 일반적인 실패 사례를 해결합니다.

작동 방식

이 도구는 결정론적 엔지니어링과 AI 에이전트를 결합한 하이브리드 아키텍처를 사용합니다:

• 결정론적 엔지니어링 (Deterministic Engineering): 정확한 파일 선택, 컨텍스트 관리를 위한 관련 파일의 스마트 번들링, 모델의 집중도를 유지하기 위한 템플릿 기반 규칙 매칭과 같은 엄격한 제약 조건을 처리합니다.
• AI 에이전트: 시나리오 튜닝된 프롬프트와 프로덕션 데이터에서 추출된 특화된 도구 세트를 사용하여 동적인 의사결정 및 컨텍스트 검색을 관리합니다.
• 프로세스: Git diff를 읽고, 도구 사용 능력을 갖춘 에이전트를 통해 변경된 파일을 구성 가능한 LLM으로 전송하며, 구조화되고 라인 단위로 정밀한 리뷰 코멘트를 생성합니다. 또한 diff가 없는 코드베이스에 대한 감사를 위해 전체 파일 스캔도 수행할 수 있습니다.

대상 사용자

• 개발자 중 로컬 워크플로우에서 고정밀 AI 코드 리뷰를 원하는 사용자.
• DevOps/CI/CD 엔지니어 중 GitHub Actions 또는 GitLab CI 파이프라인에 자동화된 AI 리뷰를 통합하고자 하는 사용자.
• AI 코딩 에이전트 사용자 (Claude Code, Cursor, 또는 Codex와 같은) 중 기존 에이전트 워크플로우에 특화된 코드 리뷰 기능을 추가하고자 하는 사용자.

주요 특징

• 고정밀도 (High Precision): 노이즈보다 정밀도를 우선하도록 최적화되어, 범용 에이전트와 비교하여 오탐(false alarms)을 줄입니다.
• 에이전트 통합: Claude Code, Cursor, 및 Codex를 위한 플러그인 또는 슬래시 명령어로 원활하게 통합됩니다.
• 유연한 LLM 지원: 다양한 내장 프로바이더 및 사용자 정의 LLM 엔드포인트(OpenAI 및 Anthropic 프로토콜)를 지원합니다.
• 라인 단위 정밀도 (Line-Level Precision): 독립적인 위치 지정 및 리플렉션 모듈을 사용하여 코멘트가 정확한 위치에 배치되도록 보장합니다.
• CI/CD 준비 완료: 자동화된 파이프라인에 쉽게 통합할 수 있도록 JSON 출력을 제공합니다.