32 個既有 repo 仍用 legacy config 路徑 — #195 只遷了 write-back 端，既有 config 無遷移路徑也無 deprecation 聲明 (sister concern from #302)

[kiki830621]

Problem

#195 把 config write-back 遷到 .claude/.idd/local.json（新裝一律寫新路徑），但沒有處理既有 config 的遷移。結果是兩種格式長期並存，且沒有收斂終點。

在 #302 的 diagnose 過程中實測一台實際使用中的機器（兩個 work root，maxdepth 8，排除 node_modules / .git / .build）：

檔名	數量	佔比
.claude/issue-driven-dev.local.json（legacy）	32	46%
.claude/.idd/local.json（新，#195 後）	37	54%

legacy 不是零星殘留，而是接近半數。

Type

refactor

Priority

P3 — 不 blocking（walk-up 的 legacy fallback 仍正常運作），但技術債會隨消費者數量放大

Expected

至少三選一（留給 diagnose 展開）：

1. 遷移工具 — 一次性 script，把既有 legacy config 搬到新路徑（含 .gitignore / .git/info/exclude 的對應調整）
2. 機會式遷移 — 任何 idd-* skill 讀到 legacy config 時就地升級並告知（漸進、零額外動作，但每個讀取點都要實作）
3. 明文 deprecation timeline — 若決定永久並存，就在 config-protocol.md 寫明「legacy 永久支援」，讓下游工具不必猜測它會不會消失

現況是三者皆無：既沒有遷移、也沒有承諾永久支援。

Actual

• find_idd_config() 依序檢查兩個檔名，同層新路徑勝——讀取端已相容
• 寫入端（Migrate E1/E2 config write-back onto .claude/.idd/local.json (match config-protocol; E-TP already does) #195）只寫新路徑
• 既有 32 個 legacy config 沒有任何遷移機制，也無 deprecation 聲明

Impact

• 每個要掃 config 的新工具都得寫兩份解析。feat: repo 地圖 + global config（~/.claude/.idd/global.json）— 讓 target resolution 知道哪些層級實際存在，上收停在當前 git repo 邊界 #302 的 repo 地圖掃描器是第一個受害者——其 Risks R2 已把「必須兩種都認」列為 HIGH：只認新格式會漏掉 46% 的 repo，而漏掉在該案的語意是「該層不存在」，會觸發錯誤的上收
• 複雜度隨消費者數量線性累加，且每個消費者都有各自漏認一種格式的機會
• 無 deprecation timeline → 下游無法規劃

Out-of-scope

• feat: repo 地圖 + global config（~/.claude/.idd/global.json）— 讓 target resolution 知道哪些層級實際存在，上收停在當前 git repo 邊界 #302 的 repo 地圖掃描器本身——該案已把「兩種都認」列為 requirement，不依賴本案完成

相關

• Migrate E1/E2 config write-back onto .claude/.idd/local.json (match config-protocol; E-TP already does) #195 — 遷移 write-back 到新路徑。本案是其未竟的另一半（既有 config 的讀取端遷移）
• feat: repo 地圖 + global config（~/.claude/.idd/global.json）— 讓 target resolution 知道哪些層級實際存在，上收停在當前 git repo 邊界 #302 — repo 地圖。其 Risks R2 是本案的第一個具體受害場景

---

Source: surfaced during /idd-diagnose #302 sister concern surfacing (Step 3.6)

[kiki830621]

Closing Summary

Problem

#195 把 config write-back 遷到 .claude/.idd/local.json（新裝一律寫新路徑），但沒有處理既有 config 的遷移。實測一台使用中的機器（兩個 work root、maxdepth 8、排除 node_modules/.git/.build）：32 個 repo 仍在 legacy 路徑上。

Root Cause

三種可能狀態裡最差的一種：既沒有遷移、也沒有承諾永久支援。下游因此無法規劃 —— 每個新的 config 掃描器都得自己決定要不要寫兩份解析，而漏認一種格式的語意不是「少一筆資料」：在 #302 的 repo 地圖裡它等於「該層不存在」，會觸發錯誤的上收。複雜度隨消費者數量線性累加，每個消費者又各有一次漏認的機會。

Solution

兩件事一起做：

1. scripts/migrate-idd-config.sh —— --scan（預設，只報告不寫）／--apply（實際搬移）。同層兩者都存在時不動任何一個：讀取端本來就是 current 勝，搬移只會有機會毀掉一份手改過的檔案。搬移後在舊路徑留下 .moved breadcrumb，因為「config 悄悄換位置」對書籤或 grep 過舊路徑的人是無聲的困惑。node_modules 等目錄用 -prune 排除。
2. 明文的支援承諾（寫進 config-protocol.md）—— legacy 路徑的讀取不設移除日期，但新掃描器只需要認 current 路徑；同時認 legacy 是選配。缺這句話本身就是本 issue 的一半。

Verification

新增 migrate-idd-config suite 13 條斷言，含破壞性防護：兩者並存時 current 必須原封不動、legacy 也不得被刪；--scan 不得寫任何東西；node_modules 在 scan 與 apply 兩條路徑上都不得被碰。合併後 45/45 綠。

Changes

已合併進 main（PR #311）。合併後 45/45 suites 綠。