---
name: deletion-policy
description: ~/.claude/ クリーンアップ時の削除対象と保持対象の厳密リスト
metadata:
type: feedback
---

# ~/.claude/ クリーンアップ削除ポリシー (2026-05-14確定)

> `.credentials.json` 削除事故を踏まえ、恒久的に保持すべきファイルを明示。

## 🔴 絶対削除禁止（Anthropic自動生成・復旧不可）

- `~/.claude/.credentials.json` — 認証情報。git管理外・復旧不可。**削除厳禁**
- `~/.claude/settings.json` — ローカル上書き設定。hooks/permissions/env vars含有。**削除厳禁**

## ✅ 安全に削除できるもの（既実行・確認済み）

| パス | 容量 | 削除理由 |
|------|------|---------|
| `~/.claude/backups/skills/` | 288K | スナップショットのみ。claude-base統合済み |
| `~/.claude/projects/` | 264K | セッション作業フォルダ。恒久ナレッジなし |
| `~/.claude/teams/` | 16K | セッションチーム。恒久ナレッジなし |
| `~/.claude/sessions/` | - | セッション履歴。恒久ナレッジなし |
| `~/.claude/plans/` | - | セッションプラン。恒久ナレッジなし |
| `~/.claude/downloads/` | - | 一時DL。恒久ナレッジなし |
| `~/.claude/cache/` | - | キャッシュ。自動再生成可 |
| `~/.claude/history.jsonl` | 323K | セッション履歴ログ。Anthropic公式削除推奨 |
| `~/.claude/mcp-needs-auth-cache.json` | 54B | MCP認証キャッシュ。自動再生成 |
| `~/.claude/mermaid-puppeteer.json` | 53B | 一時設定。自動再生成 |

## ⚠️ 削除検討時は事前確認必須

- `~/.claude/._.*.json` — Mac OS メタデータ。削除OK（自動再生成）
- `~/.claude/memory/handoff/` — ハンドオフキャッシュ。削除OK（新セッション毎リセット）
- `~/.claude/memory_engine/store.db` — LLM Wiki ローカルキャッシュ。削除OK（arcana本体で十分）
- `~/.claude/ide/` — IDE キャッシュ。削除OK（再スキャン時生成）
- `~/.claude/telemetry/` — テレメトリ一時。削除OK（次回セッションで自動生成）

## 保持理由の詳細

### .credentials.json（必須保持）

```json
{
"anthropic": { "accessToken": "..." },
"github": { "token": "..." },
...
}
```

- Anthropic、GitHub等の OAuth token を保管
- git管理外（`.gitignore`登録）
- git履歴に存在しない（`git show HEAD:.credentials.json` → fatal error）
- **復旧手段なし → 削除厳禁**

### settings.json（必須保持）

- Local User scope設定（claude-base/settings.json はGlobal scope）
- hooks（memory_save.py, llm_wiki_auto_add.py等）
- permissions deny/allow rules
- env vars (EXPERIMENTAL_AGENT_TEAMS等)
- statusLine カスタム設定
- **削除すると全機能破壊 → 削除厳禁**

## 今後のクリーンアップ運用

1. **月次クリーンアップ**: `~/.claude/{projects,teams,sessions,cache}` を削除
2. **削除前確認**: 上記「絶対削除禁止」リストと照合
3. **復旧テスト**: 削除後 `claude --version` 実行で動作確認

---

**事故教訓** (2026-05-14):
- 削除スクリプトは事前に dry-run 実行
- 認証情報ファイルは削除リストから **永遠に除外**
- 設定ファイルは保持判定を常に確認