Procedure
~/.claude/plugins/cache/<market>/<plugin>/<version>/ 構造を調査する。回収軸は順に確認:
temp clone 残骸 —
find -type d \( -name 'temp_subdir_*' -o -name 'temp_git_*' \)。 接尾辞.cloneは任意(新 sync は省略)。glob はtemp_subdir_*で無印も包含(Phase35)。 pruner:prune-plugin-clone-temp.shdisabled dir —
prune-disabled-plugin-cache.sh旧 semver 版の併存 — 同一 plugin に複数
X.Y.Zdir。最高版 keep(Phase36)。semver/hash 混在 dir の旧版 —
installed_plugins.json[plugins][name@market][].installPathの basename が loader 解決先=keep。一致 sibling のみ削除(Phase37)。 pruner:prune-stale-plugin-versions.sh(Pass1=semver / Pass2=installPath 権威)完全 orphan plugin dir — disk にあるが installed_plugins.json に entry 無し。
installed だが全プロジェクト未 enable の巨大 plugin(Phase39)— installed_plugins.json に 正規 entry があり cache GC 対象外だが、
~/.claude.jsonの全 projects で enabledPlugins=0 の 死蔵 plugin。例: sap-mdk-server 951M(SAP MDK・ユーザ無関係=事故install 疑い)。 これは leak ではなく uninstall 案件。手動 dir 削除は禁止(pruner が守る orphan を自作する矛盾)。 正規 uninstall 経路でのみ除去 → autopilot では報告のみに留める。
回収判定の権威は常に installed_plugins.json の installPath(realpath 比較)。
~/.claude.json の enabledPlugins はグローバルでは空のことがある(per-project 管理)ため
enablement の有無で 削除 判断はしない(ただし軸6の uninstall 提案 材料にはなる)。
Pitfalls
- dot/hyphen 正規化トラップ(重大): plugin KEY 名と on-disk DIR 名は別正規化。
実例: key=
wordpress.com@...(ドット)↔ dir=wordpress-com(ハイフン)。 「dir 名 ∈ installed の key 名集合」で orphan 判定すると live plugin を誤検出 → 誤削除。 必ずinstallPathをrealpath化した keep 集合と version dir の realpath を突合せよ。 正しい突合では orphan=0 になる(誤判定は dir↔key 名の文字列照合が原因)。 - 大物(node_modules 同梱)は単版でも数百MB級(sap-mdk-server 951M/中 node_modules 895M, chrome-devtools-mcp 423M)。installed なら正規=回収対象外。重い≠リークではない。
- 死蔵 elephant は suite 単位で疑え(Phase40): sap-mdk-server 単体ではなく
sap-fiori-mcp-server / sap-cds-mcp も併存=SAP plugin 群の一括誤 install。単発 fat-finger
ではなく suite 丸ごと入る事故があるので、無関係ドメインの大物を見たら
grep -i <domain>で 兄弟 plugin も洗い、uninstall は suite まとめて提案する。 - live 判定はセッションの connected MCP で確認できる:
mcp__plugin_<name>_*ツールが接続済み =実用中(chrome-devtools-mcp=接続→423M 正当)。未接続の installed 大物は死蔵候補 (sap-mdk-server=未接続)。enablement 不在より接続実績の方が live の確証として強い。 - 「dry-run が no-stale」を鵜呑みにしない。実体(孤児 dir の mtime)と script 応答の矛盾を起点に glob/判定ロジックを疑う(Phase35)。
Verification
- 全 pruner は既定 DRY-RUN、
--applyで実削除(不文律)。 - 削除前: 対象が installed_plugins.json で #entries==1 か確認(stale entry 誤選択回避)。
- 削除後:
du -shで回収量、残存 active plugin の commands/agents/skills が intact・非空を実測、 再 dry-run が「no stale」を返すこと、~/.claude/scripts/dotfiles-snapshot.shで snapshot。
軸の恒常性に関する注意(Phase40)
- 軸2(多semver併存)は「一度ゼロ=恒常ゼロ」ではない。 plugin が auto-update されるたび 旧 semver dir が残り再生成する。「全軸クリーン」は時点観測に過ぎず、stale-version sweep は weekly cron で周期実行が前提(検出→恒久ゼロではなく churn 駆動で再発する軸)。
- 毎 Phase の再点検では「前回クリーンだったから今回もゼロ」と仮定せず、必ず disk スキャン (各 plugin dir の子 dir 数 >1 を列挙)+ pruner dry-run を再実行すること。
軸7: registry-orphan(disk 削除済みだが installed_plugins.json に残骸)(Phase42)
- disk-orphan の逆向き孤児。 plugin の on-disk dir が消えた(uninstall/手動削除/cache 飛び)のに installed_plugins.json には entry が残る状態。registry が存在しない installPath を指す=plugin load 時の エラー源になりうる。Phase42 実例: ユーザが SAP suite(951M+) を uninstall→cache 1.7G→550M に縮んだが、 installed_plugins.json には sap-mdk-server / sap-fiori-mcp-server / sap-cds-mcp の3 entry が残骸として残存。
- 検出:
find plugins/cache -maxdepth 2 -iname '*<name>*' -type d(on-disk 権威)が空 かつgrep -o '<name>-[a-z-]*' installed_plugins.jsonがヒット → registry-orphan 確定。 grep の生カウントは信用せず on-disk find と突合する(Phase38 則の再適用)。 - 安全則: registry を手編集しない。それ自体が「壊れた参照を自作する」矛盾で、
正規 uninstall 経路(
claude plugin uninstall <name>)でのみ除去すべき。autopilot は報告のみ。 - 第2の側面(Phase44): registry-orphan は cache/ だけでなく
plugins/data/<name>-claude-plugins-official/にも 0B 空 stub dir として残る(SAP 3本で実観測)。find plugins/cache -iname '*sap*'を cache 限定で 打つと「disk 完全消滅」と誤認するが、plugins/data/まで広げると stub が出る。回収余地は 0B ゆえ無いが、 registry⇔cache⇔data の三方向で残骸が散る点に注意。正規 uninstall は3者を一括除去する。
軸1 の再蓄積と「02-03時の死角」(Phase42)
- 日次 3am GC + clone-temp の <60min 安全窓が組み合わさると、02:00-03:00 に生成された clone は 3am 時点で「<60min」と判定され除外され、次の 3am まで丸1日生き残る(構造的死角)。実害は軽微(~1M)。
- Phase41 で clone-temp/stale-versions pruner を日次 purge に配線済だが、上記死角ゆえ手動 Phase でも dry-run→--apply の sweep は依然有効(Phase42 で 9 dir/1.2M 回収)。
- 軸1 は二相ある(Phase46 で確定): (A) 進行中 live clone(age<60min・自己 cleanup・温存)と (B) marketplace refresh 中断で stuck した死蔵 orphan(age≫60min・要回収)。Phase43-45 は (A) しか 見ず「clone-temp は触るな」と結論したが不完全。Phase46 で temp_git 76→114 dir が age≈4.5h で死蔵化、 **50M/114 dir 回収**。age を epoch_ms から逆算し >60min なら堂々と --apply してよい(live は <60min 安全窓が自動で守る)。毎 Phase --apply まで回すのが正解。
軸8: disabled-plugin cache(無効化済プラグインの node_modules 残留)(Phase45)
- 最大の見落とし軸。 plugin を無効化(settings.json:enabledPlugins から外す/false)しても、cache の
marketplace mirror(重い node_modules 含む)は disk に残り続ける。
prune-disabled-plugin-cache.shが 「cache dir 名 ∉ enabledPlugins(true)」を disabled と判定し回収する。Phase45 で 61M/11 dir 回収。 - Phase43-44 の誤判定を訂正: zscaler 42M を「installed live ゆえ温存」と書いたが誤り。zscaler は
enabledPlugins に不在=disabled で回収対象だった。「サイズが大きい=live」ではなく、必ず
enabledPlugins[<name>]==trueを突合して live/disabled を切り分けること。chrome-devtools-mcp は =true ゆえ 423M 温存が正しい(本物の live)。 - 検出:
prune-disabled-plugin-cache.sh(dry-run 既定)。--apply で削除。再 dry-run「nothing to reclaim」で確認。 - 潜在バグ(要注意): 判定は dir名と enabledPlugins キーの厳密一致。cache dir は
wordpress-com、 settings キーはwordpress.comのように区切り文字が食い違うケースがあり、enabled な plugin を disabled と誤判定して削除する偽陽性リスクがある。Phase45 時点では該当 dir が全て真に disabled ゆえ無害だったが、--apply 前に「リストされた dir が enabledPlugins(true) に不在」を確認すべき。 - net du の罠(Phase43 再掲): --apply 後の
duが下がらない/増えることがある。live clone transient が 調査中に湧くため。回収成否は du でなく「再 dry-run が nothing to reclaim」で判定すること。
軸2 スクリプト名の訂正(Phase45)
- Phase44 で「
prune-plugin-stale-versions.shが現存せず」と記録したがglob の見間違い。 正しい実ファイル名はprune-stale-plugin-versions.sh(stale が先)。存在し dry-run 走査可能。
手動掃除の補足(旧 plugins-cache-gc / prune-plugin-clone-temp から吸収)
- prune-plugin-clone-temp.sh の引数:
[MIN_AGE_MIN](既定60分)。それより新しい temp は in-flight install 保護で温存される。実行後~/.claude/scripts/dotfiles-snapshot.shで snapshot。 - bash 3.2 制約: macOS 既定 bash では
mapfile/readarray不可。残骸処理はfind -execで書くこと。 - 削除後に MCP サーバ起動エラーが出たら Claude Code 再起動 → cache は自動再 fetch される (最新版のみ残せばリカバリ可能)。
- 重複名 plugin(sap-cds-mcp / cds-mcp 等)は
diff -rqで同一内容か確認してから判断。
実績ログ
- 2026-05-31 Phase19: 3.0GB→2.0GB(temp_git_* 20個92MB + chrome-devtools-mcp 旧3世代~900MB)
- 2026-05-31 clone-temp 初回: temp_subdir 44残骸 262M 回収、2.0G→1.8G
- 2026-06 Phase42: 9 dir/1.2M、Phase45: disabled 61M/11 dir、Phase46: temp_git 50M/114 dir