How to Build a Governance Layer for Claude Code With Hooks, Skills, and Agents

Claude Code 성능 이슈의 핵심이 ‘기억력’이 아니라 ‘거버넌스’였고, 훅 기반 제어로 스킬 활성화율을 25%에서 90%+로 끌어올렸어요.

팀이 RuoYi-Plus 코드베이스에서 한 달간 실험했는데, 기본 상태에선 Claude가 프로젝트 스킬을 선제 적용한 비율이 약 25%뿐이었어요. 즉 4번 중 3번은 규칙이 사실상 권고로만 작동한 거예요.

해결책은 프롬프트 추가가 아니라 .claude 스택 구성이었어요. UserPromptSubmit 시점 훅으로 스킬별 yes/no와 이유를 먼저 평가하게 강제하고, yes가 있으면 즉시 스킬 호출 후 구현하게 만들었거든요. 여기에 4개 라이프사이클 훅, 26개 도메인 스킬, 슬래시 커맨드, 에이전트를 결합했어요.

결과적으로 규칙 위반 코드와 재작업 요청, 위험한 툴 액션이 함께 줄었어요. AI 코딩도 결국 ‘좋은 모델’보다 ‘강제되는 운영 레이어’가 성패를 가른다는 신호예요.