Handover - ナビゲーションガイドの生成

設計思想

この引き継ぎ書の読者は 次のセッションのエージェント である。 目的は「読んだら即着手できる」こと。過去の振り返りレポートではない。

すべての情報は 次のタスクを起点に フィルタする:

• 次のタスクの前提として必要か？ → 書く
• 次のタスクに無関係か？ → 書かない（git log に委譲）

注意事項

• すべて日本語で記述する
• ファイルパスは正確に記載する
• 推測ではなく、実際にセッションで確認した事実のみを記録する
• コードやdocsに既に反映済みの情報は、参照リンクだけ書いて説明を繰り返さない
• 「やること」にコミットやプッシュを含めない

生成手順

1. .claude/handovers/ ディレクトリが存在しない場合は作成する
2. 「やること」の案を提示する: セッションの作業状況から次にやるべきタスクを提案する
3. ユーザーの承認を得る: AskUserQuestion で「次のタスクはこれでよいですか？」と確認する。ユーザーが修正・追加した場合はそれを反映する
4. 承認後、「やること」を起点に逆算して各セクションを埋める:
   • そのタスクの前提として完了を確認すべき作業は何か？ → 前提の完了状況
   • 「○○について知りたければここ」というインデックスは何か？ → ファイルインデックス
   • コードやdocsに書かれていないが、知らないとハマる情報は何か？ → コードに残っていない判断
   • そのタスクで踏みそうな罠は何か？ → トラップ
5. 各セクションの情報量が適切か検証する:
   • 「前提の完了状況」: 次のタスクに無関係な作業が混ざっていないか？
   • 「ファイルインデックス」: 「何を知りたいか → どこを見るか」の対応が明確か？
   • 「コードに残っていない判断」: コードを読めば分かることを重複記載していないか？
   • 「トラップ」: 次のタスク特有のものか？ 一般論になっていないか？
6. ファイル名: {概要}_{YYYY-MM-DD}.md
   • 概要は20文字以内の日本語で 次のタスク を要約（完了した作業ではない）
   • 例: 認証フロー実装_2026-02-24.md
   • $ARGUMENTS が指定されている場合はそれを概要部分に使用する
   • 同名ファイルが存在する場合は末尾に連番を付与する（例: _2）

テンプレート

# 引き継ぎ: {次のタスク概要}

**日付**: YYYY-MM-DD  **ブランチ**: {現在のgitブランチ}

## やること

次にやるべきタスクを優先順に記述する（1-3項目）。
各タスクは「何を」「どこに」作るか具体的に書く。

1. **タスク名**: 具体的なアクション
2. ...

## 前提の完了状況

次のタスクが依存する作業の完了確認。次のタスクに無関係な作業は記載しない。
チェックボックスで完了/未完了を明示する。

- [x] 完了した前提作業（次のタスクとの関係を括弧で補足）
- [ ] 未完了の前提作業（現在の状態を補足）

## ファイルインデックス

「○○について知りたければここを見る」という索引。
次のタスクに関連するトピックごとに、対応するファイルと行範囲を記載する。
内容の説明は不要。トピックとパスの対応だけ書く。

- DB スキーマ定義 → `src/db/schema.ts`
- 認証フローの仕様 → `docs/design.md:L50-80`
- ユーザーモデル → `src/models/user.ts:L10-45`

## コードに残っていない判断

このセッションで判明したが、コードやdocsに未反映の情報。
次のエージェントがこれを知らないと罠にハマるものだけ書く。
コードを読めば分かることは書かない。

- 判断内容と理由

## トラップ

次のタスクで遭遇しそうな罠。このセッションで実際にハマった経験に基づくもの。

- 罠の内容と回避策

フィルタ判定の具体例

以下は「前提の完了状況」に書くかどうかの判断例: