# 계획서: task-118.1 — UserPromptSubmit hook 미완료 작업 체크 시스템 심층 검토

## 작업 개요
아누 봇의 UserPromptSubmit hook에서 매 대화 시작 시 수행하는 .done 파일 체크 + 이벤트 큐 체크의 필요성을 심층 검토하는 **분석 전용 작업** (코드 수정 없음).

## 서브태스크 분해 및 팀원 배정

### ST-1: 완료 통보 채널 전수 조사 (토르 - 백엔드)
- 3개 채널(cron 통보, .done 파일, 이벤트 큐) 각각의 역할/메커니즘 분석
- 중복/주/백업 관계 매핑
- 데이터 흐름도 작성

### ST-2: .done 파일 & 이벤트 큐 필요성 분석 (미미르 - 분석)
- .done 파일 체크가 안전망으로 기능하는 시나리오 구체 식별
- 이벤트 큐의 FIFO 보장이 cron과 차별화되는 시나리오 식별
- cron 실패 가능성 및 빈도 추정

### ST-3: 토큰 효율 분석 (헤임달 - 검증)
- hook에서 ls + python3 실행의 시간/비용 측정
- 미처리 없는 비율 추정 (현재 데이터 기반)
- 대화당 추가 토큰 소비량 추정

### ST-4: 대안 검토 (토르 - 백엔드)
- 현행 유지 / 일부 제거 / 통합 / 완전 제거 각 시나리오의 장단점
- 권장안 도출

## 실행 순서
1. ST-1, ST-2, ST-3 병렬 실행
2. ST-4는 ST-1~3 결과 통합 후 팀장(오딘)이 직접 수행
3. 보고서 작성

## 예상 위험/대안
- 위험: 분석 범위가 넓어 핵심을 놓칠 수 있음
- 대안: 실제 데이터(83건 .done.clear, 이벤트 큐 15건 processed, 0건 pending)를 근거로 정량적 분석

## 실패 시나리오 체크리스트

### 1. 비정상 입력/상태
- 해당 없음 (분석 작업, 코드 수정 없음). 단, 분석 대상 파일이 변경/삭제된 경우 → 현재 스냅샷 기준으로 분석.

### 2. 동시성/경쟁 조건
- 해당 없음 (읽기 전용 분석). event-queue.py의 동시성 처리는 분석 대상으로 포함.

### 3. 비정상 종료/타임아웃
- 분석 중단 시 중간 결과물 손실 → 계획서가 있으므로 재시작 가능.

### 4. 스테일 데이터
- .done.clear 파일이 계속 축적되는 문제 → 보고서에 정리 정책 제안 포함.

### 5. 통합 시 충돌
- 해당 없음 (보고서만 작성, 코드 수정 없음). 단, 결론이 향후 코드 변경의 근거가 됨.