AI 코딩의 결정적 결함 해결을 위한 Intent Review 아키텍처 제안

We Have Code Review. We Need Intent Review.

huoru2026년 5월 7일12분intermediate

AI 요약

Context

AI 에이전트가 코드베이스의 현 상태(Current State)만 분석하여 이미 폐기된 결정이나 설계 방향을 복원하는 Framing Error 발생. Slack, PR 커멘트 등에 파편화된 Institutional Knowledge가 AI에게 전달되지 않는 구조적 한계 직면.

Technical Solution

구현 검증 중심의 Code Review를 넘어 설계 의도 검증을 위한 Intent Review 레이어 도입
AI가 단순 코드 확장이 아닌 역사적 결정 사항을 질의하는 Interrogation 프로세스 구축
AGENTS.md나 ADR의 한계를 극복하기 위해 AI가 신뢰 가능하게 탐색할 수 있는 구조적 의사결정 저장소 필요
코드 변경 전 '팀의 기존 결정 사항'과 '거부된 대안'을 먼저 확인하는 사전 검토 단계 설계
Git 자체를 Single Source of Truth로 활용하여 AI가 의사결정 이력을 추적하도록 유도

실천 포인트

- AI 에이전트 도입 시 AGENTS.md 외에 의사결정 거부 사유(Rejected Alternatives) 기록 체계 검토 - PR 리뷰 시 구현의 정확성뿐 아니라 '최근의 설계 변경 결정'과 일치하는지 Framing Check 수행 - 파편화된 Slack/Notion 문서 대신 Git 기반의 구조화된 Decision Log 운영 고려

태그

#AI-assisted Workflow #Context Window #Institutional Knowledge #Framing Error #Intent Review

원문 읽기