Hook System - AI Agent Governance

🪝 Hook Types

🚀

UserPromptSubmit

trigger: 사용자 메시지 수신 시

파이프라인 초기화 및 세션 컨텍스트 로딩

파이프라인 상태 초기화
세션 컨텍스트 로딩
이전 작업 상태 복원

🔍

PreExecution

trigger: APEI Execute 단계 진입 전

실행 전 검증 및 준비

입력 유효성 검증
리소스 가용성 확인
의존성 체크

✅

PostToolUse

trigger: 도구 호출 완료 후

도구 사용 결과 검증

출력 형식 검증
품질 기준 체크
에러 탐지 및 분류

🔬

WorkerVerify

trigger: Worker 작업 완료 후

3단계 검증 (Functional → Static → Runtime)

기능 요구사항 충족
코드 품질 검사
런타임 검증

🔄

Stop

trigger: 현재 단계 완료 시

단계 전환 및 상태 저장

상태 저장
다음 단계 결정
자동 전환 실행

🔧 WorkerVerify: 3단계 검증


WorkerVerify:
  verification_stages:
  
    ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
    │   Functional    │────→│     Static      │────→│    Runtime      │
    │                 │     │                 │     │                 │
    │ • 테스트 통과   │     │ • 린트 오류 0   │     │ • 빌드 성공     │
    │ • 예상 출력     │     │ • 타입 체크     │     │ • 통합 테스트   │
    │ • 엣지 케이스   │     │ • 코드 스타일   │     │ • 성능 기준     │
    └─────────────────┘     └─────────────────┘     └─────────────────┘
            │                       │                       │
            ▼                       ▼                       ▼
         PASS/FAIL              PASS/FAIL              PASS/FAIL
            │                       │                       │
            └───────────────────────┴───────────────────────┘
                                    │
                        ┌───────────┴───────────┐
                        │                       │
                      ALL PASS               ANY FAIL
                        │                       │
                        ▼                       ▼
                    ✅ Commit              🔄 Retry (max 3)

🔗 APEI + Hooks 통합

Integration Flow

┌─────────────────────────────────────────────────────────────────┐
│                    APEI + Hooks Integration                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ANALYZE ──────────────────────────────────────────────────────→│
│     │                                                            │
│     └─ [PreExecution Hook] → 입력 검증                          │
│                                                                  │
│  PLAN ─────────────────────────────────────────────────────────→│
│     │                                                            │
│     └─ [Stop Hook] → /specify 완료 → /open 전환                 │
│                                                                  │
│  EXECUTE ──────────────────────────────────────────────────────→│
│     │                                                            │
│     ├─ [PostToolUse Hook] → 각 도구 호출 검증                   │
│     ├─ [WorkerVerify Hook] → Worker 결과 3단계 검증             │
│     └─ [Stop Hook] → 모든 TODO 완료 → /publish 전환             │
│                                                                  │
│  ITERATE ──────────────────────────────────────────────────────→│
│     │                                                            │
│     └─ [WorkerVerify Hook] → 재시도 시 검증                     │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

🪝 Hook System

⚡ Hook Lifecycle