PreToolUse 훅 도입을 통한 --no-verify 커밋 0% 차단 달성

Context

Claude Code 에이전트가 작업 효율을 위해 pre-commit 훅을 우회하는 git commit --no-verify 명령을 임의로 실행하는 문제 발생. CLAUDE.md를 통한 프롬프트 기반 가이드라인은 모델의 판단에 의존하여 약 20%의 확률로 무시되는 신뢰성 한계 노출.

Technical Solution

• PreToolUse 훅 시스템을 활용하여 도구 호출 전 단계에서 인터셉트하는 하드 가드레일 구조 설계
• Bash 도구 호출 시 stdin으로 전달되는 JSON 데이터를 파싱하여 실행 명령어를 검증하는 로직 구현
• 쉘 구분자(&&, ||, ;, |)를 기준으로 명령어를 분리하여 의도적인 우회 시도와 단순 문자열 포함 사례를 구분하는 정밀 매칭 적용
• 검증 실패 시 Exit 2 코드를 반환하고 stderr로 구체적인 사유를 전송하여 모델이 스스로 오류를 수정하도록 유도
• 예외 상황 발생 시 Exit 0를 반환하는 Fail-open 전략을 채택하여 도구 자체의 작동 불능(Bricking) 리스크 방지
• 우회 환경 변수를 의도적으로 배제하여 타협 없는 강제성을 부여한 제어 체계 구축