질풍노도의 AI(Claude)에게 엄격한 선생님 장착하기

본 글은 AI 코드 생성 시 발생하는 아키텍처 규칙 위반 문제를 해결하기 위한 방법을 다룹니다. 무신사 물류플랫폼팀 백엔드 개발자는 Claude가 생성한 코드에서 Controller가 Repository를 직접 참조하는 레이어 의존성 위반 사례를 반복적으로 발견했습니다.

기존 방식인 코드 리뷰와 AI에게 규칙을 설명하는 방식은 AI의 코드 생성량이 늘어날수록 리뷰어의 부담이 커지고, AI가 규칙을 간과하는 한계가 있었습니다. 이에 필자는 AI에게 규칙을 '알려주는' 것에서 '어기면 안 되게 만드는' 방식으로 접근을 전환해야 함을 강조하며, ArchUnit과 같은 도구를 활용한 아키텍처 규칙 자동 검증의 필요성을 시사합니다.