# task-32.1 보고서: dispatch-improvement

## 작업 정보
- **작업 ID**: task-32.1
- **팀**: dev1-team (헤르메스)
- **소요 시간**: 2분 13초
- **완료 시각**: 2026-03-01 16:35:32

## 작업 내용
dispatch.py와 prompts/team_prompts.py 3가지 개선

---

## 개선 1: dispatch.py - --at 절대시간 변환

### 변경 파일
- `/home/jay/workspace/dispatch.py`

### 변경 내용
- `from datetime import datetime` → `from datetime import datetime, timedelta` (import 추가)
- `get_dispatch_time(delay_seconds=10)` 함수 추가 (orchestrator.py 패턴 동일)
- 152줄: `"--at", "1m"` → `"--at", get_dispatch_time(10)` (10초 후 절대시간)

### 효과
- 상대시간("1m") 대신 절대시간 문자열("2026-03-01 16:35:42" 형태) 사용
- orchestrator.py와 일관성 확보
- cokacdir 스케줄러가 정확한 실행 시점을 알 수 있음

---

## 개선 2: .done 이벤트 파일 기반 완료 감지

### 변경 파일
- `/home/jay/workspace/prompts/team_prompts.py` (`_build_direct_prompt`)
- `/home/jay/workspace/dispatch.py` (`_register_followup`)

### team_prompts.py 변경
`_build_direct_prompt()` 워크플로우에 이벤트 파일 생성 단계 추가:
- done_file: `/home/jay/workspace/memory/events/{task_id}.done`
- done_cmd: python3로 JSON 형식 이벤트 파일 생성 (`{"task_id": "...", "status": "done"}`)
- 워크플로우 5번 단계에 추가, 작업 규칙에 필수 생성 명시
- orchestrator.py의 `handle_done_event()`가 기대하는 JSON 포맷 준수

### dispatch.py `_register_followup()` 변경
- `done_file = f"/home/jay/workspace/memory/events/{task_id}.done"` 추가
- follow-up 프롬프트: 보고서 존재 여부 대신 **이벤트 파일 존재 여부**로 판단하도록 변경
  - `.done` 파일 있음 → 보고서 읽고 요약 보고
  - `.done` 파일 없음 → 진행 중 보고 + 5분 후 재확인 스케줄 등록

---

## 개선 3: team_prompts.py - 팀원 코워크 섹션 추가

### 변경 파일
- `/home/jay/workspace/prompts/team_prompts.py` (`_build_direct_prompt`)

### 변경 내용
`_build_direct_prompt()`에 **"## 팀원 코워크 (병렬 수행)"** 섹션 추가:
- Claude Code Task tool 사용 지시
- 팀원 4명 역할 정의:
  - 불칸 (백엔드): general-purpose, 백엔드 로직/API/데이터 처리
  - 이리스 (프론트엔드): general-purpose, UI/프론트엔드 구현
  - 아테나 (UX/UI): general-purpose, UX 설계 및 스타일/레이아웃
  - 아르고스 (테스터): general-purpose, 테스트 코드 작성 및 검증
- 워크플로우도 4단계로 재구성 (분해→병렬실행→통합→이벤트파일생성→완료)

---

## 생성/수정 파일 목록
| 파일 | 변경 유형 |
|------|----------|
| `/home/jay/workspace/dispatch.py` | 수정 |
| `/home/jay/workspace/prompts/team_prompts.py` | 수정 |

## 테스트 결과
- `python3 -c "import dispatch"` → OK
- `from prompts.team_prompts import build_prompt` → OK
- `build_prompt('dev1-team', 'task-32.1', '테스트 작업')` → 프롬프트 정상 생성 확인
- 팀원 코워크 섹션 포함 확인
- done_file 경로 (`memory/events/task-32.1.done`) 포함 확인

## 버그
없음

## 비고
- dev3-team (`_build_glm_prompt`)의 done_file 경로는 `teams/dev3/{task_id}.done`으로 유지 (GLM 에이전트 별도 처리)
- _register_followup의 delay("5m"/"10m")는 상대시간으로 유지 (follow-up 스케줄 등록용이므로 절대시간 불필요)