최근 AI 코딩 에이전트들이 개발 생산성을 높여주고 있지만, 때로는 멀쩡히 작동하던 코드를 망가뜨리는 예상치 못한 부작용을 낳기도 합니다. 이러한 문제를 해결하기 위해, AI가 기존 코드를 손상시키지 않도록 명확한 규칙과 프롬프트를 제공하는 방법론이 깃허브(GitHub)를 통해 공개되어 개발자들의 주목을 받고 있습니다.
이 방법론의 핵심은 프로젝트 루트에 'CLAUDE.md'와 같은 규칙 파일을 생성하고, AI 에이전트가 이 파일을 자동으로 읽어들이도록 하는 것입니다. 이 파일에는 '요청하지 않은 파일은 수정하지 마라', '요청 없이 작동하는 코드를 리팩토링(refactoring)하지 마라', '확신이 없으면 모른다고 말하라' 등 구체적인 금지 규칙을 명시합니다. 또한, AI에게 코드 변경 전에 영향을 받는 부분을 먼저 보고하게 하거나, '완료' 보고 대신 테스트 통과 증거를 요구하는 등 파괴적인 변경을 막는 5가지 핵심 프롬프트도 제시됩니다. 이는 AI가 전체 코드베이스를 한 번에 파악하기 어렵다는 구조적 한계에서 비롯된 문제를 해결하기 위한 실용적인 접근입니다.
이러한 규칙 기반 접근 방식은 AI 코딩 도구를 활용하는 개발자들에게 큰 도움이 될 것입니다. AI가 코드베이스의 복잡성을 완전히 이해하지 못해 발생하는 오류를 줄이고, 개발자가 AI의 작업을 더 효과적으로 통제할 수 있게 함으로써, AI의 잠재력을 안전하게 활용할 수 있는 기반을 마련합니다. 특히, 잦은 세션 초기화와 실패 사례를 규칙 파일에 추가하여 AI를 '훈련'시키는 방법은 장기적으로 AI의 정확도를 높이는 데 기여할 수 있습니다. 이는 단순히 더 강력한 AI 모델을 기다리는 것이 아니라, 현재의 AI 도구를 더 현명하게 사용하는 방법을 제시한다는 점에서 의미가 큽니다.