Claude Codeの途中作業を次の人と次のセッションに渡すハンドオフテンプレート

Claude Code は、セッションを引き継げるほど強くなる

Claude Code の失敗は、モデル性能だけでなく「前回どこまで進んだかが残っていない」ことでも起きます。handoff note は、次のセッションを迷子にしないための短い運用メモです。

この記事は 初回タスク実行ガイド と バグレポートテンプレート の間をつなぐ記事です。

コピペ用 handoff テンプレート

# Claude Code Handoff

## Goal
- 今日達成したいこと:
- 今日はやらないこと:

## Current state
- branch:
- last commit:
- dirty files:
- 関連 URL:

## What changed
- 変更した内容:
- 触ったファイル:
- 意図:

## Verification
- 実行したコマンド:
- 結果:
- 目視確認:

## Risks
- 壊れやすい場所:
- 触らない場所:
- 未確認:

## Next prompt
次のセッションでは、まず git status と直近差分を確認し、
この handoff と矛盾がないか見てから作業してください。

良い handoff の例

## Goal
- /en/products/ から 5/25 の3記事へ内部リンクを追加した
- 今日は価格表の構造変更はしない

## Verification
- npm.cmd run build: 成功
- production /en/products/: 200
- mobile 390px: 横はみ出しなし

## Risks
- Gumroad link は英語版を主軸にしている
- 非英語ページの本文言語は公開URLで確認する

よくある抜け漏れ

• build 成功だけを書き、公開 URL の確認を書かない
• dirty files を残したまま次の人へ渡す
• 「たぶん大丈夫」と書き、未確認項目を隠す
• 次に使う prompt を残さない

handoff は長文日記ではありません。次に作業する人が5分で安全に再開できるだけの情報に絞ります。

次に進むなら

個人運用なら 無料 cheatsheet で確認手順を固定してください。チームの標準手順にするなら Setup Guide と Prompt Templates を組み合わせると速いです。導入設計まで必要なら 導入相談 へ進んでください。

handoff は commit message より詳しく、作業日記より短く

handoff note は、次の担当者が安全に再開するための運用データです。commit message だけでは検証結果や未確認リスクが足りず、作業日記では長すぎます。必要なのは、現在地、変更理由、検証、危険箇所、次の prompt です。

この handoff をレビューしてください。
1. git status と矛盾していないか
2. 変更理由が1文で説明されているか
3. build と公開URL確認が分かれているか
4. 未確認リスクが隠れていないか
5. 次の prompt だけで再開できるか

特に多言語サイトでは「build は通ったが公開URLでは本文が違う」という事故が起きます。handoff には、確認した実URL、言語、画面幅、CTA の状態まで残してください。