クロードワークフローにおけるハンドオフパターン：2ファイル分割方式と1ドキュメント要約方式

長いClaudeセッションはコンテキスト劣化によって品質が低下します。ハンドオフは、重要な情報を文書に圧縮し、新しいエージェントを起動することでこの問題を解決します。現在コミュニティでは、Matt Pocockの/handoffスキルと、APMマルチエージェントフレームワークで使用されている別の2ファイル分割アプローチの2つの実装が議論されています。

Matt Pocockのハンドオフスキル

Pocockのスキルは会話を1つのドキュメントに圧縮します。既存のアーティファクトを再記述せずに参照し、次のエージェントがそこから作業を継続します。また、スレッド間でチェーンします：/grill-with-docs → /handoff → /prototype → /handoff で戻る。リポジトリはmattpocock/skillsで入手可能です。

2ファイル分割アプローチ（APMフレームワーク）

2025年5月にClaude Code向けAPMマルチエージェントフレームワークに組み込まれた別のアプローチでは、ハンドオフを2つのアーティファクトに分割します：

• 永続的なナラティブファイル — 実行内容、決定事項、その理由を記録します。これはプロジェクト内に残り、耐久性のある痕跡を残します。
• 一時的なプロンプト — 新しいエージェントに対し、コードベースと永続的なナラティブファイルからコンテキストを再構築する方法を指示します。

主な違いは、新しいエージェントが圧縮された会話だけでなく、永続的なプロジェクト状態（コードベース＋ナラティブ）から再構築する点です。ナラティブを永続化することで、複数のエージェントが関与する場合に可視性が高まり、どのエージェントがサマリーから作業しているか、一次コンテキストから作業しているかを追跡できます。これにより、コンテキストのギャップ管理が容易になります。

著者はこれらのアイデアについてPocockのリポジトリにIssueを立てました：mattpocock/skills#235。

重要な疑問

• ハンドオフには圧縮された単一のドキュメントで十分か？
• それとも、2ファイル分割（永続的なナラティブ＋一時的なプロンプト）の方が、コンテキスト再構築とマルチエージェントのトレーサビリティに優れているか？

議論は進行中です。どちらのアプローチも有効であり、使用するのは迅速な再開か、コンテキストギャップ管理を伴う長期実行のマルチエージェントワークフローかによって異なります。