Claude Codeは「優秀だけど日報を書かない部下」である

このプロジェクトに「作業の記録が必ず残る仕組み」をセットアップしてください。
以下を順に実行し、最後にまとめて報告してください。

## 0. 前提の確認
- このディレクトリが git リポジトリになっているか確認する
- リモート（origin）が設定されているか確認する
- 足りないものがあれば、そのうち自分でできることは実行し、
  わたしがやるしかないこと（GitHubのアカウント作成・リポジトリ作成など）は
  具体的な手順を教えてください

## 1. CLAUDE.md を作成（既にあれば追記）
以下のルールを日本語で記載する：
- 作業を終えるときは /done、途中で切り上げて次のセッションへ引き継ぐときは /next を必ず実行する
- コミットメッセージは、「何を」「なぜ」変えたかが分かるように書く
- NOTES.md には「答え」ではなく「答えを再現する方法」を書く
  （次回も使う手順・場所・ルール・仕様だけ。単発の数値や集計結果は書かない）

## 2. NOTES.md を作成
まだ無ければ、見出しだけの空ファイルを作る

## 3. .claude/commands/done.md を作成
セッションを「締める」コマンド。次の「=== done.md ここから ===」から
「=== done.md ここまで ===」までを、一字も変えずにそのままファイルの中身として保存する。

=== done.md ここから ===
---
description: セッション終わりの締め処理。内容を自動判定して「記録する／しない」を決め、保存→記録→条件付きコミット/push→セッションアーカイブまで一括実行
argument-hint: "[締めの補足メモ（任意）]"
disable-model-invocation: true
---

# セッションの締め（/done）

会話の終わりにこのコマンドが呼ばれたら、以下を**上から順に**すべて実行する。
対象は「今このセッションで作業していたプロジェクト」。

## 最重要方針

`/done` の目的は「何でも記憶すること」ではなく、
**「将来必要な情報を、適切な場所にだけ残すこと」**。

役割を混同しない。

| 入れ物 | 役割 | 既定 |
|---|---|---|
| セッションの履歴（transcript） | 過去に何をしたかを検索するための履歴 | **必ず残る**（自動） |
| プロジェクトのメモファイル（NOTES.md 等） | 次回の作業を速くするための再利用知識 | 原則追記しない |
| CLAUDE.md | プロジェクトの恒久ルール | むやみに触らない |
| git | 正式な成果物・変更履歴 | 実変更があるときだけ |

**記録要否をユーザーに聞かない。** 「記録しますか？」「コミットしますか？」と確認を求めず、
自分で判定して実行し、結果だけ報告する。

## 1. 保存漏れと差分の確認（この時点ではコミットしない）

- このセッションで編集した作業ファイルがすべてディスクに保存済みか確認する。未保存なら書き出す。
- `git status --porcelain` と `git branch --show-current` を実行し、差分を把握する。
- セッション用の worktree／作業ブランチにいる場合は、作業を置き去りにせず
  正本ブランチ（通常 main / master）へ取り込んでからコミットする。
- git 管理外の恒久プロジェクトなら、git init + .gitignore 作成 + 初回コミットで
  git 管理を開始する。一時検証用フォルダならコミット系をスキップして手順5へ。

## 2. セッション内容の分類

今回のセッションを、次の3つのうち最も近いものに分類する。

**A. 一時的な質問・集計**
数値を1回調べた／件数を数えた／エラー内容を1回確認した／現在の状態を見た。

→ **どこにも書かない。** セッション履歴が残るため、手書きの記録は二重になるだけ。
git 差分が無ければコミットもしない。

**B. 再利用可能な調査・ノウハウ**
取得方法が判明した／管理画面のこの項目はここにあると分かった／今後も使う手順が固まった／
システム固有の仕様・制約が判明した。

→ 手順3の判定を通ったものだけ記録する。

**C. 実装・設定変更**
コードを直した／設定ファイルを変えた／機能を追加した／ドキュメントを正式に更新した。

→ 通常のコミット・push 対象（手順4）。あわせてBに当たるものがあれば手順3。

## 3. 記録の判定と追記（原則：追記しない）

以下の3つを**すべて**満たす場合のみ追記する。1つでもNO、または迷ったら書かない。

- Q1. 次回以降も使う可能性が高いか
- Q2. 記録しないと再調査・再作業が発生するか
- Q3. 数ヶ月後も有効な「手順・場所・ルール・構造・仕様」か

**「答え」ではなく、答えを再現する方法を書く。**

- 悪い例: `サービスXの年間費用は382,400円`
- 良い例: `サービスXの年間費用は、管理画面の◯◯から月別請求額を取得して12か月分を合算する`

書かないもの: 金額・残高・件数・単発の集計結果・一時的なエラー・現在値・
そのセッションだけで必要だった答え。

**追記先（新しいファイルを乱造しない。既存の入れ物を使う）**

- プロジェクト直下のメモファイル（`NOTES.md` など既存のもの）へ、
  1セッションあたり**最大3行程度**。数値を伴う情報には必ず取得日を併記する。
- プロジェクト横断で使う非自明な知見だけ、自分のメモリ機能（あれば）へ。
- 追記の前に追記先の分量を確認し、重複・古い情報・解決済みの行があれば整理を優先する。
  「頻繁に使う圧縮された知識」に保ち、セッション履歴の蓄積場所にしない。

## 4. コミットと push

**`git add -A` は使わない。** 他の作業者・他セッションの未コミット分を巻き込む事故のもと。
**今回自分が触ったパスだけを明示して add する。**

- **コード・設定・正式ドキュメントに変更がある** → コミットして push。
- **手順3でメモファイルを更新した** → それもコミットして push。
- **git 管理下に実質的な変更がない** → **コミットしない。**
  「/done を実行したから」という理由だけで空コミットや記録専用コミットを作らない。

コミット時の決まり:

- Conventional Commits 形式（`feat:` / `fix:` / `docs:` / `chore:` 等）。
- .env・APIキー・パスワード等の秘密情報が差分に含まれていれば**コミットせず、
  ユーザーに報告して止まる**。
- push はリモート `origin` があるときのみ（上流未設定なら `git push -u origin <branch>`）。
  `origin` が無ければスキップして一言添える。失敗したら原因（未pull・認証・コンフリクト）を
  報告する。**勝手に force push はしない。**

## 5. 完了報告（簡潔に）

次の形式で報告する。長い説明は不要。

```
✅ 記録: NOTES.md に2行 ／ または「記録不要（一時的な集計のため）」
✅ Git: commit <ハッシュ> & push済み ／ または「コミット不要（実変更なし）」
```

失敗した項目があれば明示する。

## 6. セッションのアーカイブ（環境にある場合のみ・必ず最後）

- セッションをアーカイブするツール（例: `mcp__ccd_session_mgmt__archive_session`）が
  この環境で使える場合のみ実行する。**無ければこの手順は丸ごとスキップ**して終了する。
- **前提**: ここまでの手順がすべて成功していること。失敗があればアーカイブせず報告して止まる。
- まず「このセッションをアーカイブします。お疲れさまでした」の旨を報告する
  （アーカイブ後は応答が届かないため、**報告を先、ツール実行を最後**にする）。
- 報告したうえで、**このターンの最後の操作として** `session_id: "self"` でアーカイブを呼ぶ。
- アーカイブより後に、他のツール呼び出しや処理を置かないこと。

## 注意

- 各ステップで確認を求めず、上から自動で進める。
- ただし push の失敗・コンフリクト・秘密情報の混入など、破壊的操作や
  影響の大きい事態が絡む場合は止めて報告する。
- `/next`（引き継ぎ）との違い: /next は次セッション用の引き継ぎを残して締める、
  /done は引き継ぎなしで完全に締める。

## 判断例

| 依頼 | 記録 | Git |
|---|---|---|
| 「サービスXの年間コストはいくら？」 | なし（履歴に残る） | 変更が無ければコミットなし |
| 「毎年コストを確認する方法を調べて」 | NOTES.md に再現手順を1〜2行 | NOTES.md をコミット・push |
| 「コストを自動集計する機能を作って」 | 必要な仕様のみ NOTES.md | コード変更をコミット・push |
=== done.md ここまで ===

## 4. .claude/commands/next.md を作成
「続きは次回」で引き継ぐコマンド。次の「=== next.md ここから ===」から
「=== next.md ここまで ===」までを、一字も変えずにそのままファイルの中身として保存する。

=== next.md ここから ===
---
description: 引き継ぎ用MDを更新し、コミット＆プッシュ→次セッションへの引き継ぎ準備まで一括実行して次セッションへ移行する
argument-hint: "[次セッションの重点テーマ（任意）]"
disable-model-invocation: true
---

# 次セッションへの引き継ぎ（/next）

このセッションの内容を、次の新しいセッションにスムーズに引き継ぐ準備をする。
**新しいセッションは今回の会話を一切覚えていない前提**で進めること。

## 手順

1. **引き継ぎファイルへ保存**
   これまでの作業・成果・決定事項・未決事項を振り返り、対象プロジェクトの
   引き継ぎファイル（例: `HANDOFF.md` や `NOTES.md`。プロジェクトに既存のものがあればそれ）に
   保存・追記する。
   - すでに保存済みの内容は重複させない。
   - どのファイルを使うか不明な場合は、最も関連の深いものを選ぶ。
     該当が無ければプロジェクト直下に `HANDOFF.md` を作る。

2. **「次にやること」を整理**
   次のセッションで最初に着手すべきことを中心に、優先順にまとめて
   引き継ぎファイルに含める。次の3点を必ず書く：
   - **最初にやること**（具体的な1手目）
   - **そのあと相談・判断すること**（ユーザーの判断待ち事項）
   - **守るルール**（このプロジェクト固有の制約・注意点）

3. **コミット（引き継ぎファイルを含む）**
   引き継ぎファイルの更新を含む、このセッションの変更をすべてコミットする。
   - コミット前に `git status` と `git diff` で内容を確認する。
   - .env・APIキー・パスワード等の秘密情報が含まれていればコミットせず
     ユーザーに知らせる。
   - コミットメッセージは Conventional Commits 形式
     （引き継ぎのみの場合は `chore: セッション引き継ぎ（/next）` など）。

4. **リモートへプッシュ**
   コミット後、リモート `origin` へ `git push` する。
   - 上流が未設定なら `git push -u origin <branch>`。
   - プッシュ後、`git status` で up to date を確認し、反映されたことを報告する。
   - リモート `origin` が無い場合は、リポジトリ作成と `origin` 設定を提案してから push する。
     ユーザーが望まない場合のみスキップし、その旨を伝える。
   - push が認証等で失敗した場合は、エラー内容をそのまま伝える
     （成功したように報告しない）。

5. **次セッション用のプロンプトを提示**
   新しいセッションにそのまま貼れる「再開プロンプト」を1つ、コードブロックで提示する。
   条件：
   - **単体で完結する**こと（今回の会話の文脈に依存しない）。
   - 詳細は**引き継ぎファイルを読み込ませる**形にして、プロンプト本体は軽く保つ。
     例: 「`HANDOFF.md` を読んでから、◯◯の続きに着手して」
   - 「最初にやること」「そのあと相談すること」「守るルール」に触れること。
   - 推奨タスク（チップ）を表示できる環境なら、同じ内容をチップとしても表示してよい。

6. **セッションのアーカイブ（環境にある場合のみ・必ず最後）**
   - セッションをアーカイブするツール（例: `mcp__ccd_session_mgmt__archive_session`）が
     この環境で使える場合のみ実行する。**無ければこの手順は丸ごとスキップ**して終了する。
   - **前提**: ここまでの手順（保存・コミット・push・プロンプト提示）がすべて成功していること。
     失敗があればアーカイブせずエラーを報告して止まる。
   - まず「このセッションをアーカイブします。続きは再開プロンプトから新しいセッションでどうぞ」
     の旨を報告する（アーカイブ後は応答が届かないため、**報告を先、ツール実行を最後**にする）。
   - 報告したうえで、**このターンの最後の操作として** `session_id: "self"` でアーカイブを呼ぶ。
   - アーカイブより後に、他のツール呼び出しや処理を置かないこと。

## 注意

- 各ステップで確認を求めず、上から自動で進める。
- ただし push の失敗・秘密情報の混入など、影響の大きい事態は止めて報告する。
- `/done`（締め）との違い: /done は引き継ぎなしで完全に締める、
  /next は次セッション用の引き継ぎを残して締める。
=== next.md ここまで ===

## 5. 報告
作成したファイルと、それぞれが何をするものかを簡潔にまとめて教えてください。