훅 개발 (Claude Code Hook Development)

무엇을 해주나

• Claude Code의 9가지 훅 이벤트(PreToolUse, PostToolUse, Stop, SubagentStop, UserPromptSubmit, SessionStart, SessionEnd, PreCompact, Notification)를 언제·어떻게 쓰는지 표와 예시로 정리해 줍니다.
• LLM이 판단하는 프롬프트 기반 훅과 결정론적인 명령 훅의 차이·선택 기준을 알려줍니다.
• 플러그인용 hooks/hooks.json(래퍼 형식)과 사용자 설정 .claude/settings.json(직접 형식)의 차이를 명확히 구분합니다.
• 훅 입력/출력 JSON 스펙, 종료 코드(0/2), permissionDecision, decision: approve|block, systemMessage 사용법을 제시합니다.
• matcher 정규식 패턴(Read|Write|Edit, mcp__.*__delete.*), ${CLAUDE_PLUGIN_ROOT} 이식성 규칙, 타임아웃 기본값, 병렬 실행 특성, 보안 체크(경로 순회·민감 파일·변수 인용) 가이드를 담고 있습니다.
• 플래그 파일/설정값으로 훅을 임시 활성화하는 패턴과 claude --debug 기반 디버깅 절차도 다룹니다.

이런 분께 추천

• Claude Code 플러그인이나 팀 표준을 만들면서 정책을 자동으로 강제하고 싶은 개발자
• 위험한 Bash 명령이나 .env 같은 민감 파일 수정을 차단하고 싶은 팀 리드
• 작업 완료 조건(테스트 통과, 빌드 성공)을 Stop 훅으로 검증하려는 사람
• 세션 시작 시 프로젝트 컨텍스트나 환경 변수를 자동으로 주입하고 싶은 사람

활용 예시

1. "Write/Edit 전에 경로 순회와 민감 파일을 차단하는 PreToolUse 훅을 만들어줘" → matcher Write|Edit와 검증 스크립트가 포함된 hooks.json 생성.
2. "테스트와 빌드가 끝나지 않으면 멈추지 못하게 해줘" → 프롬프트 기반 Stop 훅으로 decision: block + 이유 반환 구성.
3. "세션 시작 시 프로젝트 타입을 감지해 환경 변수로 저장해줘" → SessionStart 명령 훅에서 $CLAUDE_ENV_FILE에 export 추가.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/tzachbon/smart-ralph/HEAD/.agents/skills/Hook Development/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 tzachbon/smart-ralph 의 .agents/skills/Hook Development 폴더를 내 ~/.claude/skills/hook-development/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.