최근 AI 코딩 에이전트의 활용이 늘면서, 개발자가 설정한 규칙이나 지시를 에이전트가 정확히 따르는지 확인하는 것이 중요해졌습니다. 이러한 요구에 맞춰 '룰리시트(RuleReceipt)'라는 새로운 도구가 등장했습니다. 룰리시트는 AI 코딩 에이전트가 CLAUDE.md와 같은 규칙 파일에 명시된 지침을 제대로 준수했는지 검증하고, 위반 시에는 해당 코드 라인을 증거로 제시하여 개발자의 신뢰를 높이는 데 기여합니다.
룰리시트는 사용자의 로컬 머신에서 완전히 작동하며, 네트워크 호출 없이 프라이버시를 보장합니다. 클로드 코드(Claude Code)는 물론, 오픈AI 코덱스(OpenAI Codex CLI), 커서(Cursor), 깃허브 코파일럿(GitHub Copilot), 제미니(Gemini) 등 다양한 AI 에이전트의 규칙 파일을 지원합니다. 이 도구는 에이전트의 최근 세션 기록을 분석하여 규칙 위반 여부를 확인하고, 특히 지난 30일간의 세션 기록을 바탕으로 가장 많이 위반된 규칙을 집계하여 보여주는 '히스토리 모드'를 제공합니다. 또한, 'protect' 명령어를 통해 에이전트 설정 파일에 가드(guard)와 훅(hook)을 추가하여 규칙 위반을 사전에 방지할 수도 있습니다.
룰리시트의 핵심은 '구조화된 검사(Structured checks)'와 '판단 규칙(Judgment rules)'입니다. 구조화된 검사는 실제 깃(git) 명령어, 파일 편집, 파일 작업 등 에이전트의 구체적인 행동을 분석하여 명확한 실패(FAIL) 여부를 판단합니다. 반면, '나쁜 소식을 먼저 알려라'와 같이 추상적인 '판단 규칙'은 사용자의 클로드(Claude) API 키를 통해 LLM이 개별적으로 평가하도록 할 수 있습니다. 이러한 검증 과정을 거쳐, 룰리시트는 위반 사항에 대한 증거 라인을 포함한 상세 보고서를 터미널, 마크다운, HTML 형식으로 제공하여 개발자가 에이전트의 행동을 명확하게 이해하고 개선할 수 있도록 돕습니다.
이 도구는 AI 코딩 에이전트의 신뢰성과 투명성을 크게 향상시킬 수 있다는 점에서 의미가 큽니다. 개발자들은 이제 에이전트가 의도치 않은 실수를 저지르거나 지시를 오해하는 경우를 보다 쉽게 감지하고 수정할 수 있게 됩니다. 이는 AI 에이전트의 도입 장벽을 낮추고, 실제 개발 워크플로우에 더욱 깊숙이 통합될 수 있는 기반을 마련할 것입니다. 궁극적으로 룰리시트는 AI 에이전트와 인간 개발자 간의 협업 효율성을 높이고, 소프트웨어 개발 과정의 안정성을 강화하는 데 중요한 역할을 할 것으로 기대됩니다.