Handoff
목표: 이 대화에 대한 기억이 없는 다음 에이전트가, 아무것도 묻지 않고, 아무것도 다시 유도하지 않고 계속할 수 있도록 합니다.
시작 시
docs/HANDOFF.md를 전체 읽고,docs/handoff/LOG.md의 상위 3개 항목을 읽습니다.- 실제 상황과 비교 검증합니다:
git status,git log --oneline -10,git branch -a, 그리고 열린 PR들 (gh api repos/al0olo/agents-village/pulls --jq '.[].title'). - 핸드오프와 현실이 불일치하면 현실을 믿고, 새 작업을 시작하기 전에 핸드오프를 수정한 후 로그에 그 사실을 기록합니다.
- 다음 단계를 사용자에게 한두 문장으로 요약하여 말하고, 바로 실행합니다.
작업 중
다음 중 하나가 발생하면 즉시 docs/HANDOFF.md를 업데이트합니다: 작업 단위 완료, 결정 내려짐, 접근 방식 실패, 환경 특이점 발견, PR 열기 또는 병합.
종료 시 (또는 중단될 때)
- 아래 템플릿을 사용하여
docs/HANDOFF.md를 다시 작성합니다. 현재 상태에 대한 문서이지 히스토리가 아니므로, 오래된 줄은 교체하고 쌓아두지 않습니다. docs/handoff/LOG.md에 날짜가 포함된 항목을 앞쪽에 추가합니다(가장 최신이 위로): 수행한 작업, 이유, 실패한 것, 링크. 히스토리는 여기에 기록됩니다.scripts/check-handoff.sh를 실행하고 작업과 함께 핸드오프를 커밋합니다.- 사용자에게 마지막 메시지: 완료된 작업, 다음 작업, 사용자의 결정이 필요한 사항.
docs/HANDOFF.md 템플릿
# Handoff
업데이트: YYYY-MM-DD by <agent/model> · 브랜치: <name> · 마지막 커밋: <sha>
## 목표
한 문단: 프로젝트가 현재 달성하려고 하는 것.
## 상태
- 완료: 항목 (PR #n)
- 진행 중: 항목, 정확히 중단된 위치, 커밋되지 않은 파일 (있을 경우)
- 시작 전: 항목
## 다음 단계
즉시 시작할 수 있을 정도로 구체적인 단일 다음 작업 (명령어 포함).
## 대기열
다음 단계 이후의 순서 목록.
## 미결 결정 (소유자가 결정 필요)
질문, 옵션, 내 추천.
## 주의사항
환경 특이점, 실패한 접근 방식과 그 이유, 잘못된 것처럼 보이지만 의도된 것.
## 검증 방법
현재 상태가 정상임을 증명하는 명령어.
## 참고 자료
깊이 읽을 파일과 문서.
품질 기준
- 파일, 브랜치, PR 번호, 명령어를 명시합니다. "위와 같음", "논의한 것"과 같은 모호한 표현 금지.
- 실패한 접근 방식과 그 이유를 기록하여 반복을 방지합니다.
- 검증한 것과 가정한 것을 구분하고, 각각이 무엇인지 명시합니다.
docs/HANDOFF.md를 약 150줄 이내로 유지하고, 히스토리는 로그로 이동시킵니다.