tfx-hookslisted

# tfx-hooks — 훅 우선순위 관리자 > Claude Code 훅의 실행 순서를 관리합니다. triflux 훅이 항상 최우선 실행되도록 보장합니다. ## 핵심 개념 Claude Code는 같은 이벤트에 매칭된 훅을 **병렬 실행**합니다. 순서 보장이 불가능합니다. triflux의 **hook-orchestrator**는 이벤트당 하나의 진입점을 두고, 내부에서 **우선순위대로 순차 실행**합니다. ``` settings.json → hook-orchestrator.mjs (단일 진입점) ↓ hook-registry.json 읽기 ↓ priority 순 정렬 1. triflux 훅 (priority=0) 2. OMC 훅 (priority=50) 3. 외부 훅 (priority=100) ``` ## 워크플로우 ### Step 1: 현재 상태 확인 ```bash Bash("node hooks/hook-manager.mjs status") ``` 결과 JSON에서 `orchestrated` 필드로 적용 여부를 판단한다. ### Step 2: 메인 메뉴 (AskUserQuestion) ``` question: "훅 관리 — 어떤 작업을 수행하시겠습니까?" header: "Hook Manager" options: - label: "현재 상태 보기" description: "settings.json 훅 스캔 + 오케스트레이터 적용 상태" - label: "오케스트레이터 적용" description: "모든 훅을 통합 — triflux 최우선 실행 보장" - label: "변경점 미리보기 (diff)" description: "적용 시 어떻게 바뀌는지 확인" - label: "원래대로 복원" description: "오케스트레이터 제거, 원래 settings.json 훅으로 복원" - label: "개별 훅 관리" description: "특정 훅 활성/비활성, 우선순위 변경" ``` ### Step 3: 선택에 따른 분기 #### "현재 상태 보기" ```bash Bash("node hooks/hook-manager.mjs scan") ``` 결과 JSON을 파싱하여 테이블로 표시: ```markdown ## 현재 훅 상태 | 이벤트 | 훅 수 | 소스 | |--------|-------|------| | SessionStart | 4 | triflux(3), session-vault(1) | | PreToolUse | 3 | triflux(1), omc(2) | | ... | ... | ... | 오케스트레이터: ❌ 미적용 / ✅ 적용됨 (N개 이벤트) ``` #### "오케스트레이터 적용" 먼저 diff를 보여준 후 확인: ```bash Bash("node hook