핸드오버 큐
PO와 Dev 에이전트 간의 중앙 파일 기반 커뮤니케이션.
파일 위치
큐 파일: docs/handover-queue.md (프로젝트 루트 기준)
파일이 존재하지 않는 경우: 사용자에게 파일 생성을 요청합니다. 동의하면 references/queue-format.md의 템플릿으로 생성합니다.
명령어
PO: 핸드오버 생성
PO가 "FR-XX 핸드오버" 또는 유사한 말을 하면:
docs/handover-queue.md를 읽습니다.## Pending섹션에 새 항목을 추가합니다:
### FR-XX: 제목
**생성일:** YYYY-MM-DD
**상태:** Pending
**문제:** [한 문장]
**구현:**
[전체 구현 세부사항 - 파일, 코드 스니펫, 승인 기준]
[완전하고 자급자족적이어야 함 - Dev가 이것만 보고 작업]
---
- 핸드오버가 추가되었음을 확인합니다.
Dev: 큐 읽기
Dev가 "내 큐에 뭐가 있나요?" 또는 작업을 시작할 때:
docs/handover-queue.md를 읽습니다.## Pending섹션의 항목들을 보여줍니다.- 특정 FR-XX를 시작하는 경우 상태를
In Progress로 업데이트합니다.
Dev: 작업 완료
Dev가 "FR-XX 완료 표시" 또는 핸드오버를 제공할 때:
docs/handover-queue.md를 읽습니다.- FR-XX 항목을
## Pending에서## Completed로 이동합니다. - 항목을 업데이트합니다:
### FR-XX: 제목
**생성일:** YYYY-MM-DD
**완료일:** YYYY-MM-DD
**상태:** Complete
**문제:** [원본]
**구현:** [원본]
**완료 노트:**
[구현된 내용]
[변경된 파일]
[테스트 노트]
---
PO: 완료 항목 처리
PO가 "완료 항목 처리" 또는 유사한 말을 하면:
docs/handover-queue.md를 읽습니다.## Completed의 각 항목에 대해:- PO에 요약을 보여줍니다.
docs/changelog.md업데이트를 도와줍니다.docs/backlog.md상태 업데이트를 도와줍니다.
- 처리 후
## Completed섹션에서 항목을 제거합니다. - 선택적으로 기록 보존을 위해
## Archived로 이동합니다.
큐 파일 형식
전체 템플릿과 예제는 references/queue-format.md를 참조하세요.
주요 원칙
- 자기 완결적 핸드오버: Dev는 큐만 보고 작업하며, 파일을 뒤질 필요가 없습니다.
- 단일 진실 공급원: 모든 활성 핸드오버가 한 곳에 있습니다.
- 깔끔한 전환: 항목이 Pending → Completed → Archived/Removed 순서로 이동합니다.