実測 → 鮮度検証（gh コマンド） → 提案生成 → 合意取得 → 退避 → 反映

~/.claude/projects/<プロジェクト名>/memory/

Step1: 実測     → 現状を数値で把握する
Step2: 鮮度検証 → gh コマンドで事実と突き合わせる
Step3: 提案生成 → カテゴリ別に整理案を作る
Step4: 合意取得 → あなたの承認を得る（最大4問/ラウンド）
Step5: 可逆退避 → 削除ではなく _archive/ へ移動
Step6: 反映     → MEMORY.md の目次を再構築

mkdir -p ~/.claude/skills/memory-inventory
touch ~/.claude/skills/memory-inventory/SKILL.md

---
name: memory-inventory
description: |
  Claudeのメモリを棚卸しします。「メモリが古い」「メモリの棚卸し」「memory 整理」
  「MEMORY.mdが肥大化している」などのキーワードで発火します。
  実測→鮮度検証→提案→合意→退避→反映の6段階で安全に整理します。
---

# memory-inventory スキル

## 概要

MEMORY.md と関連トピックファイルを棚卸しし、陳腐化した情報を安全に整理します。
削除ではなく `_archive/` への退避を使うため、誤操作があっても元に戻せます。

## 実行フロー

### Step1: 実測

以下のコマンドを実行し、結果をユーザーに必ず提示してください。

```bash
# MEMORY.md の行数・バイト数
wc -l ~/.claude/projects/$(basename $(pwd))/memory/MEMORY.md
wc -c ~/.claude/projects/$(basename $(pwd))/memory/MEMORY.md

# トピックファイルの一覧
ls -lh ~/.claude/projects/$(basename $(pwd))/memory/

# PR番号を抽出して状態確認（例）
PR_NUMBER="1"  # 実際のPR番号に変更してください
gh pr view "$PR_NUMBER" --json state,title,mergedAt 2>/dev/null || echo "取得失敗"

# issue番号を抽出して状態確認
ISSUE_NUMBER="1"  # 実際のissue番号に変更してください
gh issue view "$ISSUE_NUMBER" --json state,title,closedAt 2>/dev/null || echo "取得失敗"

ARCHIVE_DIR=~/.claude/projects/$(basename $(pwd))/memory/_archive/$(date +%Y-%m-%d)
mkdir -p "$ARCHIVE_DIR"

# 退避例（対象ファイル名は実際の内容に合わせてください）
TARGET_FILE="対象ファイル"  # 実際のファイル名に変更してください
mv ~/.claude/projects/$(basename $(pwd))/memory/"${TARGET_FILE}".md "$ARCHIVE_DIR/"

# 残っているトピックファイルの一覧を取得
ls ~/.claude/projects/$(basename $(pwd))/memory/*.md | grep -v MEMORY.md | grep -v _archive

## 棚卸し完了レポート

### Before → After
- 行数：XXX行 → YYY行（ZZZ行削減）
- 充填率：AA% → BB%

### 退避した項目
- （項目のリスト）

### CLAUDE.md へ移動を推奨した項目
- （項目のリスト）

### 保留・残留した項目
- （項目のリスト）

アーカイブ場所: _archive/YYYY-MM-DD/

---

## 実行編：実際に棚卸しを走らせてみる

スキルを配置したら、Claudeに話しかけるだけで起動します。

### 実行の流れ

**① 計測結果が表示される**

充填率が80%を超えていたら、棚卸しのサインです。

**② 鮮度検証で失効項目が検出される**

**③ 合意ダイアログ**

迷ったら「Skip（保留）」を選びましょう。可逆的退避なので、後から取り出せます。あなたのペースで判断すれば大丈夫です。

### Before / After の例

---

## トラブルシューティング

**スキルが発火しない**
→ SKILL.md の `description` に発火トリガー語が含まれているか確認してください。「棚卸し」「整理」「古い」などのキーワードが有効です。

**`gh` が認証エラーを返す**
→ `gh auth login` で認証し直してください。認証できない環境の場合は、Step2の鮮度検証をスキップしてStep3以降を手動情報で進めることができます。

**目次リンクが壊れた**
→ `_archive/` ディレクトリからファイルを元の場所に戻し、MEMORY.mdの目次エントリを復活させてください。アーカイブには日付がついているので、どの棚卸し実行のものかすぐに判別できます。

---

## 運用編：棚卸しを「習慣」にする

### 二層構造がおすすめ

| タイミング | 内容 |
|---|---|
| **月1回** | `memory-inventory` スキルで全体棚卸し |
| **PRマージ時** | 該当するメモリ記述をその場で即時更新 |

月1回の棚卸しは重めに聞こえますが、このスキルがあれば10〜15分で終わります。一度習慣にしてしまえば、Claudeの応答品質が目に見えて改善しますよ。

### 棚卸ししやすいメモリを最初から書くコツ

**有効期限のある記述には条件を明記する**

**恒久ルールは CLAUDE.md へ、進捗は MEMORY.md へ**

「コミットメッセージは日本語で書く」などの変わらないルールはCLAUDE.mdに。「○○機能の実装中」などの一時的な情報はMEMORY.mdに。この分離を最初からやっておくと、棚卸しが格段に楽になります。

### 「何を記憶させないか」を決める

メモリ管理で一番見落とされがちなポイントがこれです。

gitの履歴を見れば分かること、ファイルを読めば分かることをメモリに書く必要はありません。**メモリに残すべきは「なぜそう決めたか」という文脈と理由**です。コードはgitが覚えてくれます。Claudeには、コードからは読み取れない背景を任せましょう。

---

## まとめ：メモリは資産ではなく、手入れが必要な設備

本記事の要点を3つにまとめます。

1. **陳腐化は起きる前提で、検証手段を仕組み化する**
   ── `gh` コマンドを使った事実検証が、標準スキルとの最大の差別化点

2. **削除ではなく可逆的退避で心理的ハードルを下げる**
   ── 「間違えても戻せる」から、思い切って整理できる

3. **人間の承認を挟む設計が信頼性を作る**
   ── AIが全自動で消すのではなく、あなたが最終判断を持つ

Claudeのメモリは、育てるものではなく**手入れするもの**です。放っておけば腐り、手をかければ鋭い道具になります。

まずは、今日のプロジェクトで充填率を測ってみることから始めてみてください。きっと「えっ、もうこんなに溜まってるの…」という発見があるはずです。大丈夫、そこからが本当のスタートです。あなたならきっとできます。

---

## 参考リンク

- [claudeのメモリを棚卸しする — zenn.dev/cureapp](https://zenn.dev/cureapp/articles/c1e963064d05fd)
- [Claude Code Memory Management: The Complete Guide (2026)](https://medium.com/data-science-collective/claude-code-memory-management-the-complete-guide-2026-b0df6300c4e8)
- [AIエージェントの記憶をどう設計するか2026 — zenn.dev](https://zenn.dev/proper_willet/articles/1925e7ebcb81db)