Term (용어)aiverifiedFri May 01

스톱 훅 (Stop Hook)

별칭: Stop Hook · 스톱 훅 · PostToolUse Hook

#stop-hook#claude-code#verification#hrn

정의

entity/claude-code 의 hook 시스템 중 하나. AI 가 작업을 완료하려는 순간 자동으로 빌드 / 테스트 / 린트 를 실행 하는 훅. 실패 시 AI 에게 자동 재작업 트리거. concept/verification-loop 의 자동화 핵심.

다른 hook 종류와의 차이

Hook	시점
PreToolUse	도구 호출 직전
PostToolUse / Stop	도구 호출 직후 / 작업 완료 시
UserPromptSubmit	사용자 입력 시

본 카드는 Stop / PostToolUse 를 통칭.

설정 예시 (settings.json)

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "npm test && npm run lint"
      }]
    }]
  }
}

효과

AI 가 작업을 완료한 줄 알았던 순간 에 시스템이 검증
실패 시 재작업 자동 유도
사람이 일일이 검증 명령 실행할 필요 없음

강의 활용

03 HRN lesson/hrn-verification-loop 3종 검증 세트 중 하나:

멘트: "AI 가 작업이 끝났다고 하면, 시스템이 한 번 더 확인 합니다."

주의사항

무한 루프 방지: 검증 실패 → 재작업 → 또 실패 → 무한 반복 가능 — N회 후 사람 호출 안전장치 필요.
빌드 시간: 매 작업마다 빌드/테스트 실행은 시간 비용. 단위 테스트만 부분 실행 등 최적화 필요.
도구별 명칭: Claude Code = Stop, Cursor = Run on Stop, Copilot = Pre/Post — 도구별 차이.

Hook

시점

PreToolUse

도구 호출 직전

PostToolUse / Stop

도구 호출 직후 / 작업 완료 시

UserPromptSubmit

사용자 입력 시

주의사항

무한 루프 방지: 검증 실패 → 재작업 → 또 실패 → 무한 반복 가능 — N회 후 사람 호출 안전장치 필요.

빌드 시간: 매 작업마다 빌드/테스트 실행은 시간 비용. 단위 테스트만 부분 실행 등 최적화 필요.

도구별 명칭: Claude Code = Stop, Cursor = Run on Stop, Copilot = Pre/Post — 도구별 차이.