Hooks 자동화 — Claude Code가 워크플로우를 직접 지키게 만들기

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "command": ".claude/hooks/protect-files.sh"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": ".claude/hooks/auto-format.sh"
      }
    ],
    "PreCompact": [
      {
        "matcher": ".*",
        "command": ".claude/hooks/save-context.sh"
      }
    ],
    "Notification": [
      {
        "matcher": ".*",
        "command": ".claude/hooks/notify-done.sh"
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/auto-format.sh
 
FILE=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.file_path // empty')
 
# 파일 경로가 없으면 조용히 종료
[[ -z "$FILE" ]] && exit 0
 
# TypeScript 파일에만 Prettier 적용
if [[ "$FILE" == *.ts || "$FILE" == *.tsx ]]; then
  npx prettier --write "$FILE" 2>/dev/null
  echo "Formatted: $FILE"
fi

#!/bin/bash
# .claude/hooks/protect-files.sh
 
FILE=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.file_path // empty')
 
# 보호할 경로 패턴 목록
PROTECTED=(
  ".env"
  ".env.local"
  ".env.production"
  "prisma/migrations"
  "generated/"
  "__generated__"
)
 
for pattern in "${PROTECTED[@]}"; do
  if [[ "$FILE" == *"$pattern"* ]]; then
    echo "BLOCKED: '$FILE' is a protected file. Edit manually if this is intentional." >&2
    exit 1
  fi
done
 
exit 0

#!/bin/bash
# .claude/hooks/save-context.sh
 
TIMESTAMP=$(date +"%Y-%m-%d_%H-%M-%S")
SAVE_DIR=".claude/snapshots"
mkdir -p "$SAVE_DIR"
 
# 현재 작업 상태를 스냅샷으로 저장
cat > "$SAVE_DIR/context-$TIMESTAMP.md" << EOF
# Context Snapshot — $TIMESTAMP
 
## Git 상태
$(git status --short 2>/dev/null || echo "git 없음")
 
## 최근 변경 파일
$(git diff --name-only HEAD 2>/dev/null | head -20 || echo "없음")
 
## 메모
컴팩트 전 자동 저장됨.
EOF
 
echo "Context saved to $SAVE_DIR/context-$TIMESTAMP.md"

#!/bin/bash
# .claude/hooks/notify-done.sh
 
# macOS 데스크톱 알림
if command -v osascript &>/dev/null; then
  osascript -e 'display notification "Claude Code가 작업을 완료했어요" with title "Claude Code" sound name "Glass"'
fi
 
# Linux (notify-send) 대응
if command -v notify-send &>/dev/null; then
  notify-send "Claude Code" "작업이 완료됐어요"
fi

# 실제 환경변수를 흉내 내서 직접 실행
export CLAUDE_TOOL_INPUT='{"file_path": "src/app.ts"}'
bash .claude/hooks/auto-format.sh
echo "Exit code: $?"

echo "DEBUG: FILE=$FILE" >&2

which jq || echo "jq가 없습니다 — brew install jq 또는 apt install jq"

#!/bin/bash
# .claude/hooks/post-compact.sh
# 압축 후 핵심 컨텍스트를 다시 주입
 
cat << 'CONTEXT'
[Post-Compact Context Restoration]
- Current task: Review authentication module
- Important constraint: Do NOT modify database schema
- Active branch: feature/auth-refactor
- Files modified so far: src/auth/login.ts, src/auth/session.ts
CONTEXT

{
  "hooks": {
    "PostCompact": [
      {
        "matcher": ".*",
        "command": ".claude/hooks/post-compact.sh"
      }
    ]
  }
}

#!/bin/bash
# .claude/hooks/local-ci.sh — Edit|Write에 대한 PostToolUse hook
 
FILE=$(echo "$CLAUDE_TOOL_INPUT" | jq -r '.file_path // empty')
[[ -z "$FILE" ]] && exit 0
 
ERRORS=""
 
# Step 1: TypeScript 타입 체크 (.ts/.tsx 파일만)
if [[ "$FILE" == *.ts || "$FILE" == *.tsx ]]; then
  if ! npx tsc --noEmit --pretty 2>/tmp/tsc-output.txt; then
    ERRORS+="TypeScript errors found:\n$(cat /tmp/tsc-output.txt)\n\n"
  fi
fi
 
# Step 2: ESLint 검사
if [[ "$FILE" == *.ts || "$FILE" == *.tsx || "$FILE" == *.js ]]; then
  if ! npx eslint "$FILE" --quiet 2>/tmp/eslint-output.txt; then
    ERRORS+="ESLint issues:\n$(cat /tmp/eslint-output.txt)\n\n"
  fi
fi
 
# Step 3: 관련 테스트 실행
TEST_FILE="${FILE%.ts}.test.ts"
if [[ -f "$TEST_FILE" ]]; then
  if ! npx jest "$TEST_FILE" --silent 2>/tmp/test-output.txt; then
    ERRORS+="Test failures:\n$(cat /tmp/test-output.txt)\n\n"
  fi
fi
 
# 결과 리포트
if [[ -n "$ERRORS" ]]; then
  echo "⚠ Local CI found issues:" >&2
  echo -e "$ERRORS" >&2
else
  echo "✓ Local CI passed: types, lint, tests" >&2
fi
 
exit 0  # 차단하지 않음 — 리포트만 제공

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "command": ".claude/hooks/protect-files.sh"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": ".claude/hooks/auto-format.sh"
      },
      {
        "matcher": "Edit|Write",
        "command": ".claude/hooks/local-ci.sh"
      }
    ],
    "PreCompact": [
      {
        "matcher": ".*",
        "command": ".claude/hooks/save-context.sh"
      }
    ],
    "PostCompact": [
      {
        "matcher": ".*",
        "command": ".claude/hooks/post-compact.sh"
      }
    ],
    "Notification": [
      {
        "matcher": ".*",
        "command": ".claude/hooks/notify-done.sh"
      }
    ]
  }
}