Claude Code で「死蔵 SDK」を計画的に剥がす — 個人開発12年で堆積した非アクティブ依存を安全に棚卸しする運用設計

# tools/scan_dependencies.py
import json, re, subprocess
from pathlib import Path
from collections import defaultdict
 
PROJECT_ROOTS = [
    Path("~/repos/wallpaper-app-a").expanduser(),
    Path("~/repos/wallpaper-app-b").expanduser(),
    Path("~/repos/wallpaper-app-c").expanduser(),
    Path("~/repos/wallpaper-app-d").expanduser(),
]
 
def parse_podfile_lock(path: Path):
    text = path.read_text(encoding="utf-8")
    pods = []
    for m in re.finditer(r"^\s+- ([\w\d/\-]+) \((\d[^)]*)\)", text, re.MULTILINE):
        pods.append((m.group(1).split("/")[0], m.group(2)))
    return pods
 
def parse_spm_resolved(path: Path):
    data = json.loads(path.read_text(encoding="utf-8"))
    pins = data.get("pins", []) or data.get("object", {}).get("pins", [])
    return [(p.get("identity") or p.get("package", ""), p.get("state", {}).get("version", "")) for p in pins]
 
def parse_gradle(root: Path):
    deps = []
    for f in root.rglob("build.gradle*"):
        for line in f.read_text(encoding="utf-8", errors="ignore").splitlines():
            m = re.search(r"(implementation|api)\s*['\"]([\w\.\-:]+):([\w\.\-]+)['\"]", line)
            if m:
                deps.append((f"{m.group(2)}", m.group(3)))
    return deps
 
def scan(root: Path):
    found = []
    for lock in root.rglob("Podfile.lock"):
        found.extend(parse_podfile_lock(lock))
    for spm in root.rglob("Package.resolved"):
        found.extend(parse_spm_resolved(spm))
    found.extend(parse_gradle(root))
    return found
 
def main():
    inventory = defaultdict(lambda: {"versions": set(), "projects": set()})
    for root in PROJECT_ROOTS:
        for sdk, version in scan(root):
            inventory[sdk]["versions"].add(version)
            inventory[sdk]["projects"].add(root.name)
 
    rows = []
    for sdk, info in sorted(inventory.items()):
        rows.append({
            "sdk": sdk,
            "versions": sorted(info["versions"]),
            "project_count": len(info["projects"]),
            "projects": sorted(info["projects"]),
        })
    Path("inventory.json").write_text(json.dumps(rows, indent=2, ensure_ascii=False))
    print(f"detected {len(rows)} unique SDKs across {len(PROJECT_ROOTS)} apps")
 
if __name__ == "__main__":
    main()

# tools/reach_score.sh — Xcode Index Store からシンボル到達グラフを抽出
set -euo pipefail
PROJECT_ROOT="${1:?usage: reach_score.sh <project_root>}"
DERIVED="$HOME/Library/Developer/Xcode/DerivedData"
INDEX_DIR=$(find "$DERIVED" -maxdepth 3 -type d -name "DataStore" \
  -path "*$(basename "$PROJECT_ROOT")*" | head -1)
 
if [ -z "$INDEX_DIR" ]; then
  echo "Index Store not found. Build the project once in Xcode first." >&2
  exit 1
fi
 
# 各 SDK モジュールについて、参照しているソースファイル数を数える
python3 - <<'PY'
import os, json, subprocess
sdks = [r["sdk"] for r in json.load(open("inventory.json"))]
results = []
for sdk in sdks:
    # 公開ヘッダ・モジュールを参照しているシンボル数を Index から雑に grep
    out = subprocess.run(
        ["grep", "-rIl", "-e", f"import {sdk}", "-e", f"@import {sdk}",
         os.environ.get("PROJECT_ROOT", ".")],
        capture_output=True, text=True
    )
    refs = [l for l in out.stdout.splitlines() if l.endswith((".swift", ".m", ".mm", ".h"))]
    results.append({"sdk": sdk, "import_files": len(refs), "files": refs[:5]})
json.dump(results, open("reach.json", "w"), indent=2, ensure_ascii=False)
PY

# tools/bridge_risk.sh
for sdk in $(jq -r '.[] | select(.import_files == 0) | .sdk' reach.json); do
  echo "===== $sdk ====="
  rg -l --type swift -e "swizzle" -e "+ *load" -e "@objc dynamic" \
     -g '!Pods/*' -g '!Carthage/*' | head -20 > /tmp/candidates.txt
 
  claude -p "次の Swift ファイル群が、SDK '$sdk' の機能を Method Swizzling・KVC・Reflection 経由で間接的に呼び出している可能性があるかを評価してください。出力は JSON: {risk: 'Low'|'Medium'|'High', reason: '...'}" \
    --allow-tool=read \
    < /tmp/candidates.txt
done

あなたは iOS/Android の個人開発リポジトリで、不要になった SDK を1つだけ剥離する PR を準備します。
入力: SDK 名 / 検出された参照ファイル一覧 / マニフェストファイルのパス
出力: 計画 (Plan) として次を提示します:
1. 削除対象のマニフェスト行（Podfile, Package.swift, build.gradle）
2. 削除対象の Import 文一覧
3. 削除すると壊れる可能性のある Build Settings / Info.plist エントリ
4. 動作確認ステップ（具体的なシミュレータ動線）
5. ロールバック手順
 
実装は行わず、Plan のみを出します。人間が approve したあと、Apply モードに移行します。

// monitor/post-decom-check.ts (抜粋)
export default {
  async scheduled(_event: ScheduledEvent, env: Env): Promise<void> {
    const baseline = await env.KV.get<Metrics>("baseline:wallpaper-a", "json");
    const current = await fetchMetrics({
      crashlyticsAppId: env.CRASHLYTICS_APP_ID,
      admobApp: env.ADMOB_APP,
      days: 7,
    });
 
    const crashDelta = (current.crashFreeUsers - baseline!.crashFreeUsers) * 100;
    const ecpmDelta = (current.ecpm - baseline!.ecpm) / baseline!.ecpm * 100;
 
    if (crashDelta < -0.2 || ecpmDelta < -8) {
      await notifySlack({
        title: "post-decom regression suspected",
        body: `crashFree Δ=${crashDelta.toFixed(2)}%, eCPM Δ=${ecpmDelta.toFixed(1)}%`,
        rollbackHint: "git revert <PR sha> && pod install && fastlane release",
      });
    }
  },
};