ハンドオフ
目標: この会話の記憶を持たない次のエージェントが、誰にも尋ねず、何も再導出せずに作業を続行できるようにすること。
開始時
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'）。 - ハンドオフと現実が矛盾する場合、現実を信頼し、新しい作業を始める前にハンドオフを修正し、その旨をログに記録する。
- 次のステップを1～2文でユーザーに伝え、実行する。
作業中
次のいずれかが発生した場合は、即座に docs/HANDOFF.md を更新する: 作業単位の完了、決定、アプローチの失敗、環境の問題の発見、PRの作成またはマージ。
終了時（または中断時）
- 以下のテンプレートを使って
docs/HANDOFF.mdを書き直す。現在の状態を記述するものであり、履歴ではない: 古い行は置き換え、積み上げない。 - 日付付きのエントリを
docs/handoff/LOG.mdの先頭に追加する（最新が先頭）: 行ったこと、その理由、失敗、リンク。履歴はそこに保存する。 scripts/check-handoff.shを実行し、ハンドオフを作業と一緒にコミットする。- ユーザーへの最終メッセージ: 完了したこと、次に行うこと、ユーザーの判断が必要なこと。
docs/HANDOFF.md のテンプレート
# ハンドオフ
更新日: YYYY-MM-DD by <エージェント/モデル> · ブランチ: <名前> · 最終コミット: <SHA>
## 目的
1段落: プロジェクトが現在達成しようとしていること。
## 状態
- 完了: 項目（PR #n）
- 進行中: 項目、どこで止まったか、未コミットのファイルがあればそれも
- 未着手: 項目
## 次のステップ
すぐに開始できる具体的な次のアクション（コマンド付き）。
## キュー
次のステップ以降の順序付きリスト。
## 未決定の事項（オーナーが決定する必要がある）
質問、選択肢、私の推奨。
## 注意点
環境の問題、失敗したアプローチとその理由、間違っているように見えるが意図的であるもの。
## 確認方法
現在の状態が健全であることを証明するコマンド。
## 参照先
詳細を読むためのファイルやドキュメント。
品質基準
- ファイル名、ブランチ、PR番号、コマンドを明記する。「上記の通り」「先ほど話したこと」などの曖昧な表現は禁止。
- 失敗したアプローチとその理由を記録し、誰も繰り返さないようにする。
- 確認したことと仮定したことを分離し、どちらであるかを明示する。
docs/HANDOFF.mdは約150行以内に保ち、履歴はログに移動する。