오스마니 기술 — AI 코드, 어디까지 믿고 병합할까 | DAKER 커뮤니티
무엇 : Addy Osmani의 「Agentic Code Review」는 AI가 코드를 빠르게 만들수록 병목이 작성에서 검증으로 이동한다고 설명한다. 핵심은 “AI가 쓴 코드냐”가 아니라, 그 변경이 실패했을 때 비용이 얼마나 큰지에 따라 리뷰 깊이를 달리해야 한다는 점이다. Claude Code나 Codex를 쓸 때도 에이전트 출력은 판결이 아니라 검토할 신호로 다뤄야 한다.
언제 쓰나 : Claude Code가 기능 구현, 테스트 수정, 리팩터링 PR을 빠르게 만든 뒤 사람이 모든 diff를 같은 밀도로 읽기 어려울 때 쓴다. 특히 인증, 결제, 개인정보, 프롬프트 입력 경계처럼 깨지면 비용이 큰 경로에서는 에이전트 리뷰와 테스트가 통과해도 사람이 의도와 위험을 다시 확인해야 한다. 반대로 문구 수정, 작은 설정 변경, 폐기 예정 프로토타입은 자동 검사와 짧은 확인으로 충분할 수 있다.
핵심 원리
- AI 도구는 코드 작성 속도를 크게 올리지만, 사람이 변경을 이해하고 책임질 속도는 같은 비율로 빨라지지 않는다.
- 리뷰의 목적은 단순한 문법 확인이 아니라 변경 의도, 영향 범위, 테스트의 진짜 의미, 운영 책임을 확인하는 것이다.
- 리뷰 노력은 작성자 기준이 아니라 위험도 기준으로 나눈다. 작은 변경은 가벼운 게이트를, 고위험 변경은 타입 검사, 테스트, 서로 다른 AI 리뷰, 보안 검토, 담당자의 인간 리뷰를 거친다.
- 짧은 비유로 말하면, AI 리뷰어는 계기판의 센서다. 센서가 초록색이어도 운전자가 도로 상황과 목적지를 책임진다.
적용 방법
- Claude Code나 Codex 작업 요청에 완료 조건을 먼저 쓴다. 예: “인증 경로 변경은 테스트 결과, 영향 파일, 롤백 위험을 함께 보고하라.”
- PR을 낮음, 중간, 높음 위험도로 분류한다. 사용자 데이터, 권한, 결제, LLM 프롬프트 입력은 기본적으로 높음에 둔다.
- 에이전트에게 diff 요약뿐 아니라 “무엇을 하려 했고 무엇을 배제했는지” 결정 로그를 남기게 한다.
- 테스트 파일 변경을 코드 변경보다 먼저 읽는다. 에이전트가 깨진 동작에 맞춰 assertion을 바꿨는지 확인한다.
- AI 리뷰 결과는 병합 승인으로 쓰지 말고, 사람이 어디에 시간을 써야 할지 정하는 triage 신호로 사용한다.
이미지 차트 : 위 대표 썸네일은 병합 버튼 앞에서 멈추는 판단 장면을, 두 설명 차트는 위험도별 검증 게이트와 리뷰 루프를 보여준다. 핵심은 AI 리뷰를 승인 도장으로 쓰지 않고, 사람이 읽을 위치를 정하는 증거 신호로 쓰는 것이다.
출처