Leo/system-dev-template

Files

T

Leo 2a8c259d08 依 D22 翻正舊 ignore 政策：本 repo 自己的 SDD 進版控＋新增 jdd-dual-profile 卷

🔴 修的病：這個框架 repo 自己的 5 份 SDD 全部被 .gitignore 擋在版控之外，
只活在一台硬碟上——clone 不到、雲端 CC 讀不到、沒備份。SDD 是進度真相源，
「框架 repo 沒吃自己的狗糧」。

依據 D22（已翻案）：Gitea private 除機敏值外全 push，雲端工人靠 clone，docs 缺＝斷糧；
只有 GitHub mirror 才嚴篩，而 docs 整包已在 github-publish-exclude.txt。

.gitignore 改法：整條擋 → 只擋子項（/*）+ 逐個放行真 SDD。
與 template/ 底下逐位元組相同的自裝副本（TEMPLATE-sdd/、SDD-LIFECYCLE.md）續擋。

新增 docs/3-specs/jdd-dual-profile/（status: draft，等 leo confirm 才升 active）：
JDD（PM 軌 root/journeys/角色權限/站號 sprint）與雙 profile 合成一卷，
33 條 task／6 phase，每條掛服務哪條 Gherkin（G1–G7）。
新增 hook 6 支、改既有 hook 1 支。**0 行實作**。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-05 23:22:14 +08:00

3.7 KiB

Raw Permalink Blame History

install-layout — Tasks

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

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

前置條件

design.md 已審核（用戶批准）

Tasks

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

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

前置條件：Phase 1 完成

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

Phase 3：版本、文件、提交

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

3.1 bump template/.claude/VERSION → 1.9.0（注意：VERSION 檔本身也要隨結構搬到 system-dev/，但發佈源 template 內的相對位置同步調整）
3.2 CHANGELOG 記 1.9.0（結構重構 + 遷移行為）
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]`	完成（有驗收證據）
`[~]`	暫緩（說明原因）
`[!]`	阻擋中（說明阻擋原因）