wrap-up

/wrap-up

内容

セッション継続のための儀式です。セッションは一時的なものですが、知識は永続します。 wrap-up は、両方向でセッションを橋渡しします。

• セッション終了 — 次の3点だけを正確に記録します。完了したこと、保留中のこと、学んだことです。.claude/handoff.md に記録し、永続させるべき学びは MEMORY.md に反映します。
• セッション開始 — 引き継ぎ、メモリー、インスティンクトを読み込み、どのセッションも状況を把握できないまま始まらないよう、再開用の要約を提示します。

使用するタイミング

• 作業セッションの終了時 — 「今日はここまで」「以上です」「失礼します」
• プロジェクトを切り替える前、または大きなマイルストーンの達成後
• 暗黙の終了時 — タスク完了後の「ありがとう」や「ひとまずこれで十分です」などの場合は、ただ別れを告げるのではなく、引き継ぎを提案します
• セッションの開始時 — 「セッションを開始」「引き継ぎを読み込んで」「何に取り組んでいましたか」
• セッションを終了せずに途中経過を保存する場合は、代わりに /checkpoint を使用します

使用方法

セッション終了

1. セッションを振り返る — git のステータス／差分と会話をもとに、変更したファイル、完了したタスクと未完了のタスク、決定事項とその理由、ユーザーからの修正内容を確認します。
2. 未コミットの変更を確認する — 変更がある場合は、終了処理の前にコミットするかユーザーに確認します。
3. 引き継ぎを記録する — 以下の形式を使って .claude/handoff.md に記録します。ファイルは1つだけで、常に上書きします。重要なのは現在の状態だけです。既存の引き継ぎに他の人の保留中タスクがある場合は、上書きする前に、統合、上書き、スキップのどれにするか確認します。
4. 学びを抽出する — 残しておく価値のある修正内容や発見は、instinct-system を介して MEMORY.md に記録します。新たに見えてきたパターンは、instinct-system を介して .claude/instincts.md を更新します。引き継ぎの「学んだこと」セクションはきっかけであり、記録先ではありません。引き継ぎは一時的なものです。
5. 確認する — 記録した引き継ぎと学びの概要をユーザーに伝えます。

引き継ぎファイルの形式（.claude/handoff.md）

何も知らない人が読んでも分かるように、ファイルパス、理由、具体的な次の手順を記述します。「リファクタリングを続ける」では役に立ちません。「src/Orders/CreateOrder.cs を Result パターンにリファクタリングする。確立済みのパターンについては Catalog を参照」とすれば、すぐに作業に取りかかれます。

# Session Handoff

> Generated: 2026-06-12 | Branch: feature/order-validation

## Completed
- [x] Added FluentValidation to CreateOrder (src/Orders/Features/CreateOrder.cs:15-35)
- [x] Fixed N+1 in GetOrderDetails (src/Orders/Features/GetOrderDetails.cs:28)

## Pending
- [ ] Add validation to UpdateOrder (src/Orders/Features/UpdateOrder.cs)
  - Reference: CreateOrder validator for the established pattern
- [ ] Full test run — 2 pre-existing Catalog failures, not from today

## Learned
- FluentValidation validators must be registered in the module's DI setup
- Test fixture seeds 1 item per order, which hides N+1 queries

## Context
- Branch: feature/order-validation | Last commit: "Add CreateOrder validation"
- Uncommitted changes: no | Solution: src/MyApp.slnx

複数の開発者がプロジェクトを共有する場合は、## Decisions Made テーブル（Decision | Choice | Rationale）と ## Open Questions を追加します。

学びの抽出チェックリスト

1. ユーザーから何か修正を受けましたか？ → instinct-system を介して MEMORY.md に記録
2. 何か自明でないことを発見しましたか？ → 「学んだこと」セクションに記録
3. 理由を伴う決定をしましたか？ → その「理由」を記録
4. ツールやアプローチが失敗しましたか？ → 次のセッションで再度試さないよう記録

よい学びの例：「EF のコンパイル済みクエリは Include() と併用できない」。悪い学びの例：「Orders モジュールで作業した」（曖昧）や「TimeProvider を使用した」（すでにルールになっている）。

セッション開始

1. コンテキストを読み込む — .claude/handoff.md（保留中の作業）、MEMORY.md（永続的なルール）、.claude/instincts.md（確信度が 0.7 以上のパターン）を読みます。ファイルがなくても問題ありません。その旨を伝えて、何もない状態から開始します。ファイルがないことを理由に作業を止めないでください。
2. ソリューションを検出する — .slnx／.sln を（現在のディレクトリ、親ディレクトリ、子ディレクトリの順に）探し、最初のプロンプトから Roslyn MCP ツールを使えるようにします。
3. 再開用の要約を提示する — 前回のセッションでの作業、保留中のタスク、有効なルール／インスティンクトの数、検出したソリューションを伝えます。その後、何に取り組むかを尋ねます。保留中の作業を自動で開始してはいけません。

例

User: /wrap-up

Claude: Wrapping up session...

## Session Summary
- Implemented OrderService with validation pipeline
- Fixed N+1 query in GetOrdersByCustomer

## Pending
- [ ] Add retry logic to payment gateway calls (OrderService.cs:42)

## Learnings Captured
- User prefers explicit mapping over AutoMapper → MEMORY.md

Written to .claude/handoff.md. See you next session.

関連項目

• /checkpoint — セッションを終了せずに、セッション途中の状態を保存します（コミット＋簡単なメモ）
• instinct-system — セッションでの学びを振り分けます。パターンはインスティンクトに、ユーザーからの修正は永続的な MEMORY.md のルールになります