handoff

引き継ぎ — 次のセッションへのブリーフィング

このセッションの状態を、作業を引き継ぐ次のセッションに伝えます。引き継ぎは記録ではなくブリーフィングです。可能な限りそのまま次のセッションに渡し、リポジトリにはコミットしません。

1. 状態をまとめる

次のセッションに必要な情報だけを集めます。

完了したこと：

• 完了したタスクやフェーズ
• 作成または変更したファイル（概要）
• 作成してプッシュしたコミット（ブランチ、リモートの状態）

未完了のこと：

• 残っているタスクやフェーズ
• 発生して修正した不具合（次のセッションで繰り返さないようにするため）
• 着手したものの、途中になっている作業

決定事項：

• 今後の作業を制約する、ユーザーが承認した選択
• 確立したパターン
• 試したものの、うまくいかなかった方法

実務情報：

• リポジトリのパス、ブランチ、リモート
• 開発環境の状態（起動中か、起動方法）
• 該当する場合はテスト用認証情報
• 重要なファイルのパス（仕様、計画、ドキュメント）— 最大2～4件

次のタスクが明らかでない場合は、次のように尋ねます。「次のセッションでは何に取り組みますか？」

2. ブリーフィングを書く

1分以内に読める長さにします。それだけで内容が分かるようにし、「上記を参照」といった表現は使いません。

# [Topic] — Handoff (YYYY-MM-DD)

[1-2 sentence summary of where things stand]

## Done
- ...

## Not Done
- ...

## Decisions
- ...

## Bugs Fixed (Don't Repeat)
- ...

## Practical
- Repo: [path] (branch: [branch])
- Dev stack: [state]

## Next
[What to do first]

## Read First
- [path] — [why]

3. 引き継ぐ

利用できる最初の方法を使います。

1. 別の Claude Code セッションが起動中の場合。 ListAgents でセッションを見つけ、SendMessage でブリーフィングを送ります。送信前に対象のセッションを確認します。
2. 対象が Herdr または tmux で動作している場合。 Herdr 内では herdr スキルを、通常の tmux では tmux-orchestration スキルを使って、対象のペインにブリーフィングを送ります。送信前に対象のペインを確認します。
3. 稼働中の対象がない場合。 ${TMPDIR:-/tmp}/handoff-YYYY-MM-DD-<topic>.md にブリーフィングを書き、そこを指す再開用プロンプトを1行コピーしてクリップボードに保存します（macOS では pbcopy、Linux では wl-copy または xclip -selection clipboard）。ファイルのパスをユーザーに伝えます。このファイルは一時的なもので、再起動時に消えても問題ありません。

ブリーフィングをプロジェクト内に書き込んだり、コミットしたりしてはいけません。

含めてはいけないこと

• 会話の逐次的な説明
• 生のエラーログ（修正内容を要約してください）
• ディスク上のファイルから確認できるファイル内容や実装の詳細
• git log やコードから導き出せる情報