Claude Code hooks 5종으로 코드 포맷팅부터 에이전트 통신, 세션 컨텍스트 관리까지 워크플로우 자동화 달성함

Context

Claude Code의 코드 포맷팅이 일관되지 않아 프로젝트마다 스타일 충돌이 발생함. 6개 에이전트 간 통신 메커니즘이 필요하지만 polling 방식은 지연 문제가 있음. 세션 종료 시 Claude가 컨텍스트를 저장하지 않아 작업 이어하기가 어려움.

Technical Solution

• PostToolUse hook: Write|Edit 도구 실행 후 prettier --write로 파일 자동 포맷팅 적용함
• UserPromptSubmit hook: 사용자 메시지 전송 시 inbox 스크립트 실행하여 다른 에이전트 메시지 즉시 전달함
• SessionStart hook: 세션 시작 시 SESSION-HANDOFF.md와 known-issues.md 자동 로드하여 이전 상태 복원함
• Stop hook: 세션 종료 시 systemMessage JSON 출력으로 컨텍스트 저장 리마인더 강제 실행함
• PreToolUse hook: 민감파일(.env, credentials, secrets) 패턴 매칭 시 decision:block으로 수정 차단함

Impact

16개 프로젝트에서 동일 hook 설정 재사용 가능함. 에이전트 간 메시지가 polling 없이 사용자 인터랙션 시 즉시 전달됨.

Key Takeaway

Claude Code hook은 동기 실행 방식으로 .claude/settings.json에 정의하며, 실패 시 Claude 차단을 방지하기 위해 || true 가드 필수 적용함.