# install-layout — Tasks

> 權威來源：此檔案是進度真相，不是 CLAUDE.md 或對話。
> 規則：動手前標 [🔄]，完成立刻標 [x]，不批次更新。

---

## Phase 1：腳本核心（install / update + 遷移）

### 前置條件
- [x] design.md 已審核（用戶批准）

### Tasks

- [x] 1.1 install.sh：docs/ create_dir+download 落點全改 system-dev/docs/
  - 驗收：✅ grep 無殘留；raw source 偵測段 `RAW_SOURCE="docs/"` 正確保留
- [x] 1.2 install.sh：.claude/wiki/* 與 .claude/VERSION 落點改 system-dev/
  - 驗收：✅ 落點全 system-dev/；新增 system-dev/VERSION download
- [x] 1.3 install.sh：新增 create_dir system-dev/wiki/cards + 寫 .gitkeep
  - 驗收：✅ 已加 create_dir + .gitkeep 寫入
- [x] 1.4 install.sh：scripts 落點改 system-dev/scripts/（一開始就裝）
  - 驗收：✅ 加 SCRIPTS_URL + download install/update 到 system-dev/scripts/
- [x] 1.5 update.sh：所有路徑改 system-dev/（wiki/docs/scripts/VERSION）
  - 驗收：✅ grep 無殘留；bash -n 過；commands/hooks 正確留 .claude/
- [x] 1.6 update.sh：新增冪等遷移段（舊位置→system-dev/，保留 wiki/.git，白名單只搬工具 docs）
  - 驗收：✅ 沙盒測試全綠——wiki(含.git commit一致)/VERSION/SKILL/docs 搬移正確、冪等(第二次0項)、用戶自填 docs 保留
- [x] 1.7 兩腳本 bash -n + 多位元組旁變數 ${} 包好
  - 驗收：✅ install.sh + update.sh bash -n 通過

---

## Phase 2：路徑引用同步（.md / .sh）

> 前置條件：Phase 1 完成

- [x] 2.1 CLAUDE.md（template + 根）：鐵律/速查/wiki 讀取表路徑；raw source 宣告維持
- [x] 2.2 SKILL.md（template + 根）：cards/ 落點改 system-dev/wiki/cards/；raw source 偵測維持
- [x] 2.3 wiki-init.md（.claude + template）：cards/、工具 docs 示意、SKILL 引用；raw source 偵測維持
- [x] 2.4 wiki-capture.md / sdd-check.md（.claude + template）：docs/ → system-dev/docs/
- [x] 2.5 sdd-guard.sh（.claude + template）：7 處 docs/3-specs → system-dev/docs/3-specs
- [x] 2.6 session-start-recall.sh：STATUS_FILE 路徑 + 新增防呆檢查
- [x] 2.7 INDEX.md / decisions-summary.md（.claude + template）：docs/2-architecture 引用
- [x] 2.8 README.md / README.en.md：目錄樹示意 + 安裝後說明
  - 驗收（2.1–2.8）：全 repo grep 無殘留非 raw-source 語義的舊路徑；raw source 引用未被誤改

---

## Phase 3：版本、文件、提交

> 前置條件：Phase 1+2 完成、bash -n 過

- [x] 3.1 bump template/.claude/VERSION → 1.9.0（注意：VERSION 檔本身也要隨結構搬到 system-dev/，但發佈源 template 內的相對位置同步調整）
- [x] 3.2 CHANGELOG 記 1.9.0（結構重構 + 遷移行為）
- [x] 3.3 commit（先不 push，等實機驗證）

---

## Phase 4：實機 KB 套用與驗證

> 前置條件：Phase 1–3 完成；用戶點頭才動實機

- [ ] 4.1 KB：.claude/wiki/（含 192 卡 + .git）搬 system-dev/wiki/，保留 .git
  - 驗收：192 張卡與 wiki/.git 完整，git log 不斷
- [ ] 4.2 KB：.claude/VERSION、根工具 docs 搬 system-dev/；用戶自有 docs 不動
- [ ] 4.3 KB：開 session 接關正常、/wiki-init 寫入 system-dev/wiki/cards/
  - 驗收：hook 接關輸出正常、無防呆警告（表示已遷移完成）

---

## 完成定義

整個 SDD 完成 = 以下全部達成：
- [ ] 所有 tasks 標 [x]
- [ ] design.md 驗收標準全通過（有客觀證據）
- [ ] design.md 與實作一致

---

## 狀態說明

| 標記 | 意義 |
|------|------|
| `[ ]` | 未開始 |
| `[🔄]` | 進行中（當前 session）|
| `[x]` | 完成（有驗收證據）|
| `[~]` | 暫緩（說明原因）|
| `[!]` | 阻擋中（說明阻擋原因）|