먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
훅 이름은 알아도 어느 생명주기에서 어떤 입력과 종료 코드를 처리해야 하는지 연결하기 어려운 학습 업무
어떤 어려움인가
Claude Code 훅을 실제 예제로 배우는 개발팀이 자주 마주치는 문제입니다. 구체적으로는 '훅 이름은 알아도 어느 생명주기에서 어떤 입력과 종료 코드를 처리해야 하는지 연결하기 어려운 학습 업무' 상황입니다.
이렇게 해결합니다
Claude Code Hooks Mastery 단계에서는 예제를 격리된 환경에서 재현한 뒤 현재 작업에 필요한 부분만 옮깁니다. 입력 범위는 '시험할 훅 이벤트, 예제 경로, 기대 입력·출력'입니다. 필요한 필드만 골라 '실행 시점과 실패 동작이 검증된 훅 실습 기록' 형태로 정리합니다.
왜 연결하는가
처음에는 Claude Code Hooks Mastery 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '실행 시점과 실패 동작이 검증된 훅 실습 기록'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
01 · 입력작은 입력 범위시험할 훅 이벤트, 예제 경로, 기대 입력·출력
업무 조건
02 · 현재 자료Claude Code Hooks Mastery예제 적용: 입력 범위는 '시험할 훅 이벤트, 예제 경로, 기대 입력·출력'입니다. 필요한 필드만 골라 '실행 시점과 실패 동작이 검증된 훅 실습 기록' 형태로 정리합니다.
'훅 이름은 알아도 어느 생명주기에서 어떤 입력과 종료 코드를 처리해야 하는지 연결하기 어려운 학습 업무' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
이렇게 해결합니다
Claude Code Hooks Mastery 단계에서는 예제를 격리된 환경에서 재현한 뒤 현재 작업에 필요한 부분만 옮깁니다. 입력 범위는 '시험할 훅 이벤트, 예제 경로, 기대 입력·출력'입니다. 필요한 필드만 골라 '실행 시점과 실패 동작이 검증된 훅 실습 기록' 형태로 정리합니다. 다음 단계인 Superpowers에서는 '적용 스킬과 검증 순서가 있는 개발 실행안' 형태로 업무 문맥을 보강합니다.
왜 연결하는가
Claude Code Hooks Mastery의 결과에는 원문 식별자와 처리 시각을 붙여 Superpowers로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
마지막 확인
검토 대상은 '실행 시점과 실패 동작이 검증된 훅 실습 기록'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '적용 스킬과 검증 순서가 있는 개발 실행안'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
Connection map어떤 값을 다음 자료로 넘기는지
01 · 입력업무 입력시험할 훅 이벤트, 예제 경로, 기대 입력·출력
정리된 입력
02 · 현재 자료Claude Code Hooks Mastery실행 시점과 실패 동작이 검증된 훅 실습 기록
훅 이름은 알아도 어느 생명주기에서 어떤 입력과 종료 코드를 처리해야 하는지 연결하기 어려운 학습 업무를 반복 운영해야 할 때
어떤 어려움인가
'훅 이름은 알아도 어느 생명주기에서 어떤 입력과 종료 코드를 처리해야 하는지 연결하기 어려운 학습 업무' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
이렇게 해결합니다
Claude Code Hooks Mastery 단계에서는 예제를 격리된 환경에서 재현한 뒤 현재 작업에 필요한 부분만 옮깁니다. 입력 범위는 '시험할 훅 이벤트, 예제 경로, 기대 입력·출력'입니다. 필요한 필드만 골라 '실행 시점과 실패 동작이 검증된 훅 실습 기록' 형태로 정리합니다. 보강은 Superpowers, 전달과 후속 처리는 Spec Kit로 분리합니다.
왜 연결하는가
같은 작업 ID가 Claude Code Hooks Mastery → Superpowers → Spec Kit 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
마지막 확인
검토 대상은 '실행 시점과 실패 동작이 검증된 훅 실습 기록'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
Operational architecture자동 처리와 사람 승인 경계
업무 담당자
01 · 입력반복 실행 입력시험할 훅 이벤트, 예제 경로, 기대 입력·출력과 작업 ID
작업 요청
자동 처리
02 · 현재 자료Claude Code Hooks Mastery실행 시점과 실패 동작이 검증된 훅 실습 기록
Claude Code Hooks Mastery는 Claude Code의 동작을 결정론적으로 또는 비결정론적으로 제어하는 훅을 실제 구현으로 익히도록 만든 시연 저장소입니다. 훅뿐 아니라 서브에이전트, 메타 에이전트, 에이전트 오케스트레이션을 포함한 팀 기반 검증 시스템도 함께 다룹니다.
주요 기능
UserPromptSubmit: 프롬프트 검증, 로깅, 컨텍스트 주입, 보안 필터링을 수행합니다
PreToolUse: rm -rf 실행이나 .env 접근 같은 위험한 명령을 차단합니다
PostToolUse와 PostToolUseFailure: 도구 실행 결과를 수집하고 실패는 타임스탬프와 전체 컨텍스트를 담아 구조화 기록합니다
SessionStart와 SessionEnd: git 상태와 최근 이슈, 컨텍스트 파일을 불러오고 종료 시 세션을 기록합니다
PermissionRequest: 권한 요청을 감사하고 읽기 전용 작업은 자동 허용합니다
Setup: CLAUDE_ENV_FILE로 환경을 유지하고 additionalContext로 컨텍스트를 주입합니다
총 13개 훅 이벤트가 구현되어 로깅되며 그중 11개가 자동화 테스트로 검증되었습니다. 사용하려면 Python 패키지 설치와 의존성 해석을 담당하는 Astral UV와 Claude Code가 필요하고, ElevenLabs와 ElevenLabs MCP 서버, Firecrawl MCP 서버, OpenAI, Anthropic, Ollama는 선택 사항입니다. settings.json에 훅 경로를 적을 때는 경로 해석이 확실하도록 $CLAUDE_PROJECT_DIR 접두사를 사용하라고 안내합니다.