# 에러 분석 + 개선: task-timer.py task_id 형식 문제

## 발생 에러 (스크린샷 기반)
팀장(헤르메스)이 task-417 작업 완료 후 task-timer.py end를 호출할 때 반복 에러 발생:

1. `python3 task-timer.py end task-417` → "잘못된 task_id 형식: task-417 (expected: task-N.N)"
2. `python3 task-timer.py end 417` → "잘못된 task_id 형식: 417 (expected: task-N.N)"
3. `python3 task-timer.py end task-4.17` → "Task 'task-4.17' not found" (잘못된 분할)

팀장이 task_id 형식(task-N.N)을 정확히 맞추지 못해 3번이나 실패하고 삽질함.

## 근본 원인 분석 요청
1. `task-timer.py`의 task_id 검증 로직 분석
   - 파일: `/home/jay/workspace/memory/task-timer.py`
   - 왜 `task-N.N` 형식만 허용하는지
   - dispatch.py는 `task-417`로 task_id를 생성하는데, task-timer.py는 `task-417.1` 형식만 받음 → **불일치**

2. `dispatch.py`와 `task-timer.py` 간의 task_id 흐름 추적
   - dispatch.py가 task_id를 어떻게 생성하는지
   - DIRECT-WORKFLOW.md에서 팀장에게 어떤 task_id를 사용하라고 안내하는지
   - 팀장이 혼동하는 원인 파악

3. `notify-completion.py` 또는 완료 통보 시 `.done` 파일의 task_id 형식
   - task-417.0.done, task-417.1.done, task-417.done 3개가 동시 생성됨 → 중복 문제?

## 개선방안 설계 요청
다음 중 최적의 방안을 선택하고 구현 상세를 설계:

### 방안 A: task-timer.py가 유연한 형식 허용
- `task-417`도 허용, 자동으로 `task-417.1`로 매핑
- 또는 `task-N` 형식도 유효하게 처리

### 방안 B: dispatch.py가 처음부터 task-N.N 형식으로 생성
- dispatch.py가 `task-417.1`로 생성하고 팀장에게도 이 ID 전달
- task-timer start도 dispatch.py 내에서 자동 호출

### 방안 C: 팀장 워크플로우에서 task-timer 호출 자동화
- DIRECT-WORKFLOW.md 수정: 팀장이 직접 task-timer 호출하지 않도록
- dispatch.py에서 start, 완료 통보 스크립트에서 end 자동 처리

### 방안 D: 기타 (분석 후 제안)

## 산출물
- `/home/jay/workspace/memory/research/task-timer-format-analysis.md` 에 분석 결과 + 개선방안 저장
- 코드 수정은 하지 말 것. 분석 + 설계까지만.

## 참고 파일
- `/home/jay/workspace/memory/task-timer.py` — task timer 스크립트
- `/home/jay/workspace/dispatch.py` — 위임 스크립트
- `/home/jay/workspace/prompts/DIRECT-WORKFLOW.md` — 팀장 워크플로우
- `/home/jay/workspace/notify-completion.py` — 완료 통보 스크립트 (있으면)