checkpoint

/checkpoint

概要

セッションの途中で、正常に動作する状態をすばやく保存するための、次の2つの手順です。

1. 内容が分かる git コミット — 関連する変更をステージし、作業内容を要約したメッセージを付けてコミットします。
2. 簡潔な引き継ぎメモ — .claude/handoff.md を作成し、再開したセッション（またはリファクタリングに失敗した後の自分）が現状を正確に把握できるようにします。

Checkpoint はセッション途中の保存で、/wrap-up はセッション終了時の手順です。Checkpoint はコミットしてメモを残した後、作業を続けます。Wrap-up では、完全な引き継ぎに加えて、学びを MEMORY.md に抽出します。

使うタイミング

• リスクの高いリファクタリングや破壊的な変更の前 — 正常に動作する状態をチェックポイントとして保存します
• セッションの途中で別のタスクや機能に切り替えるとき
• 論理的な作業単位が完了した後 — 状態を保存します
• ユーザーが「checkpoint」「save progress」「save state」「pause here」と言ったとき
• セッションを実際に終了する場合は、完全な手順として /wrap-up を使います

手順

1. 状態を確認する — git status と git diff で、ステージ済みおよび未ステージの変更を確認します。
2. 変更をステージする — 特定のファイルをステージします。git add -A は決して使いません。生成ファイル、ビルド成果物、シークレット（.env、認証情報）は除外します。
3. コミットする — リポジトリのコミットスタイルに沿った、内容が分かるメッセージを付けます（従来のプレフィックス：feat:、fix:、refactor:）。新しいコミットを作成し、amend は決してしません。コミット対象がない場合は、引き継ぎメモに進みます。
4. 引き継ぎメモを作成する — .claude/handoff.md に、/wrap-up と同じ形式で短く記載します。完了事項、保留事項（具体的な次の手順を含む）、学び（特筆すべきことが分かった場合のみ）、コンテキスト（ブランチとコミットハッシュ）を記載します。ファイルは1つだけ作成し、常に上書きします。
5. 確認する — コミットハッシュと引き継ぎ内容の概要を報告し、作業を再開します。

安全ルール

• プッシュ、強制プッシュ、リモートブランチへの操作は決して行いません
• シークレットは決してコミットしません
• amend は決してしません — チェックポイントは、後から戻れる新しいコミットです
• コミットする変更がない場合は、引き継ぎメモだけを更新します

例

User: /checkpoint — about to try the EF Core split-query refactor

Claude: 3 files modified, 1 new.

  Commit a1b2c3d: "feat: add CreateOrder validation with FluentValidation"
  - src/Orders/Features/CreateOrder.cs
  - src/Orders/Features/CreateOrderValidator.cs (new)
  - tests/Orders.Tests/Features/CreateOrderTests.cs

  Handoff updated (.claude/handoff.md):
  ## Completed
  - [x] CreateOrder validation + 3 test scenarios
  ## Pending
  - [ ] Split-query refactor in GetOrderDetails (about to attempt)
  ## Context
  - Branch: feature/order-validation | Checkpoint: a1b2c3d

  Checkpoint saved — safe to proceed with the risky refactor.

関連項目

• /wrap-up — セッション終了時の手順：完全な引き継ぎ形式の定義と、学びの MEMORY.md への抽出
• /build-fix — チェックポイントを作成する前にビルドを成功させます