Claude Code のセッション履歴・メモリは、
どこに・いつ・どう保存するか

~/.claude/
├── CLAUDE.md                        # 人格・運用ルールの正本
├── WORK_QUEUE.md                    # 進行中タスクのキュー
├── .gitignore                       # 生ログ・機密を除外する定義（詳細はセクション06）
├── daily/
│   └── YYYY-MM-DD.md                # 日次メモ
├── docs/
│   └── *.md                         # 運用手順書（同期フロー・命名規則など）
├── skills/
│   └── <skill-name>/SKILL.md        # 固定手順のスキル定義
└── projects/
    └── <cwdエンコード名>/           # 作業ディレクトリごとに1フォルダ
        ├── <セッションUUID>.jsonl   # 層A: 会話の生ログ（自動・git対象外）
        └── memory/
            ├── MEMORY.md             # 層B: メモリの索引（1行1メモリ）
            ├── core/
            │   └── feedback_*.md     # ユーザーの好み・作業方針
            ├── reference/
            │   └── reference_*.md    # 外部サービス・ツールの情報
            ├── projects/
            │   └── <name>/
            │       ├── RULES.md       # そのプロジェクトの運用正本
            │       ├── LOG.md         # 時系列の作業記録
            │       └── PROJECT.md     # プロジェクト概要
            ├── decisions/
            │   └── NNNN-*.md         # 意思決定の記録（ADR）
            └── _archive/              # クローズ済み案件の退避先

# 会話の生ログ（層A）。容量が大きく機密が混じるため同期しない
**/*.jsonl
**/subagents/
**/tool-results/

# セッション・キャッシュ（巨大なため同期しない）
sessions/
cache/
history.jsonl
shell-snapshots/

# PC固有設定・認証情報（他PCに持ち込まない）
settings.json
settings.local.json
.credentials.json

# セッション内の一時データ（引き継ぎ不要）
todos/
plans/

## セッション引き継ぎ（必須）
会話中に以下が発生したら、会話が終わる前に必ずメモリに保存する:
- 設定変更（settings.json、CLAUDE.md、環境変数など）
- 調査して判明した事実や根本原因
- ユーザーが示した方針・判断（「これは深追いしない」「こちらを優先」など）
- 新しく導入したツール・サービス・API
- トラブルシューティングの結論（何が原因で、何で解決したか）

保存先の判断基準:
- ユーザーの好み・方針 → `feedback_*.md`
- 外部サービス・ツールの情報 → `reference_*.md`
- 進行中の状況 → `project_*.md`
- ユーザー自身について知ったこと → `user_*.md`

既存メモリに追記できるなら新規作成より更新を優先する。

## PC間同期
`~/.claude/` はgit管理のリポジトリとして同期する。

- セッション開始時: `git pull` → `WORK_QUEUE.md` → 該当 `projects/{name}/{RULES,LOG}.md` → `MEMORY.md` を読む
- 作業区切り: 該当 `projects/{name}/LOG.md` 追記 → `WORK_QUEUE.md` 更新 → メモリ更新 → `git add -A && git commit -m "sync: …" && git push`
- 書き出し前: メモリ・コミットメッセージはタイポを1ステップ自己確認してから保存

# 作業ディレクトリのパスを cwdエンコード名 に変換して1フォルダ作る
CWD_ENC=$(pwd | sed 's/\//-/g')
mkdir -p ~/.claude/projects/$CWD_ENC/memory/{core,reference,projects,decisions,_archive}

# 日次メモ・運用手順書の置き場
mkdir -p ~/.claude/daily ~/.claude/docs

# リポジトリ化
cd ~/.claude
git init

# .gitignore はセクション06の内容で作成してからコミット
git add -A
git commit -m "init: セッション履歴・メモリ運用の初期構成"

# 任意: GitHub privateリポと接続して同期する場合
gh repo create <repo-name> --private --source=. --push

この仕様を自分の環境に再現するには、
(1) セクション08のbashでディレクトリを作る
(2) セクション06の.gitignoreを置く
(3) セクション07の文面を ~/.claude/CLAUDE.md に追記する
(4) 以降、T1/T2/T3のタイミングで層B（MEMORY.md・LOG.md・WORK_QUEUE.md・daily/）を更新する

生ログ（層A）はClaude Codeが自動で書くため、何もしなくてよい。