# 핸드오프 메타데이터 템플릿
> 버전: 1.0 | 작성일: 2026-03-12 | 참조: Agency-Agents 분석

dispatch.py 위임 시 task-file에 포함할 표준 메타데이터.

---

## 표준 메타데이터 블록

task-file 상단에 다음 형식으로 메타데이터를 기재:

```
## 핸드오프 메타데이터
- From: <위임자 (예: 아누/헤르메스)>
- To: <수신팀 (예: dev1-team)>
- Phase: <Phase 번호/이름 (예: Phase 2 구현)>
- TaskRef: <task_id (예: task-100.1)>
- Priority: <High/Medium/Low>
- 참조문서: <경로 목록 (콤마 구분)>
- 기대산출물: <파일/결과물 목록>
- 품질기준: <구체적 완료 조건>
- 완료 체크리스트:
  - [ ] 항목 1
  - [ ] 항목 2
  - [ ] 항목 N
```

## 핸드오프 유형별 가이드

### Standard 핸드오프
일반적인 작업 위임. 위 메타데이터 블록 전체 기재.

### QA-PASS 핸드오프
QA 통과 후 다음 Phase로 전달:
- 추가 필드: `QA결과: PASS (N건 테스트 통과)`
- 증거 파일 경로 포함

### QA-FAIL 핸드오프
QA 실패 후 수정 요청:
- 추가 필드: `QA결과: FAIL (사유: ...)`
- 실패 항목 목록 + 기대 수정사항

### Escalation 핸드오프
3회 재시도 실패 후 에스컬레이션:
- 추가 필드: `Attempt: 3/3, Escalation사유: ...`
- 이전 시도 로그 경로 포함

### Phase Gate 핸드오프
Phase 경계 통과:
- 추가 필드: `Gate: GO/NO-GO, GateKeeper: 아누`
- Phase 완료 체크리스트 전체 기재

## 사용 시점
- dispatch.py가 task-file을 생성할 때 자동 삽입 (향후)
- 현재는 팀장이 task-file 작성 시 수동 포함
- 체인(chain) 작업에서 Phase 간 전환 시 필수