네 가지 클로드 코드 훅이 AI 작성 콘텐츠의 음성과 톤 일관성을 강화합니다

한 개발자가 AI 에이전트가 콘텐츠를 작성할 때 브랜드 보이스와 톤의 일관성을 유지하기 위해 네 개의 Claude Code 훅을 사용한 시스템을 구현했습니다. 이 접근법은 AI 생성 콘텐츠가 모호한 표현과 일반적인 언어를 통해 점차 브랜드에서 벗어나는 문제를 해결합니다.

훅 구현

이 시스템은 네 가지 특정 훅을 사용합니다:

• UserPromptSubmit 훅: VOICE-AND-TONE.md 파일을 감지하고, 모든 콘텐츠 파일을 편집하기 전에 검토자 에이전트에게 위임하라는 지시를 주입합니다.
• PreToolUse 훅: 세션 마커가 존재하지 않는 한, 콘텐츠 파일(.tsx, .md)에 대한 Edit/Write 호출을 차단합니다.
• PostToolUse 훅: 검토자가 작업을 완료한 후 세션 마커를 생성합니다.
• Stop 훅: 각 응답 후 마커를 제거하여 다음 턴이 잠긴 상태로 시작하고 새로운 검토를 요구하도록 합니다.

검토자 에이전트 설계

검토자는 읽기 전용 도구(Read, Glob, Grep)를 가진 Claude Code 에이전트입니다. 이는 보이스 가이드를 읽고, 제안된 콘텐츠를 읽으며, 다음 내용으로 위반 사항을 보고합니다:

• 문제가 있는 텍스트
• 위반된 규칙
• 제안된 수정 사항

검토자는 파일을 직접 편집할 수 없어, 관심사의 분리를 유지합니다.

핵심 설계 철학

이 시스템은 단순한 제안이 아닌 게이트 역할을 합니다. 보이스 검토를 놓치면 브랜드에서 벗어난 콘텐츠가 프로덕션에 배포될 수 있습니다. 개발자는 편집 전 한 번의 에이전트 호출 비용이 사후에 문제를 찾고 수정하는 비용보다 낮다고 지적합니다.

전체 구현에는 훅 코드, 에이전트 정의, 보이스 가이드를 위한 시작 템플릿이 포함됩니다. 개발자는 다른 사람들도 접근성이나 코딩 표준과 같은 비기능적 제약 조건에 대해 유사한 훅을 구축했는지 묻습니다.