Leo/system-dev-template
1
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity
47 Commits 2 Branches 0 Tags
2f5d9f3bb2f31ac2d6022d4278f680bdf96b2d49
Commit Graph

5 Commits

Author SHA1 Message Date
Leo 2f5d9f3bb2 feat(W2 Phase 2-3): JDD 文件範本＋八條封路 hook＋還清兩件舊債 
SDD: docs/3-specs/jdd-dual-profile（active）。編號 task 26/33 完成，Phase 4-5 未開工。

■ Phase 2 JDD 文件範本（orchestrator profile）
範本形狀對齊「實際跑出來的那兩份」（總管已寫的 root.md 15 卡、journeys.md J-1 九站），
不是照規格憑空造：
- 卡片是巢狀 bullet（`- **P1** 🟢 …` ＋ 子項放來源／對帳），非規格畫的平行文字行
- 站點索引**巢狀 bullet 不用表格**（表格會把層級壓平，看不出從屬）
- 兩份都保留「這卷還缺什麼（誠實記）」收尾段——規格沒有，但那是防假綠的地方
新增：root.md / journeys.md / sprint.md / triage-map.md 四範本（add-if-missing，
填了就永不覆蓋）＋ plugin-load-order.md（W3 插槽，框架不發明平行外掛格式）

■ Phase 3 封路 hook（八條規則落六支檔）
- role-guard（J1+J2+J3）★命門：考生不能改考卷。六組實測含「考題藏在別的 md 裡」也擋
- jdd-format-guard（J4+J5+J8）：紅卡缺對帳日／任務缺站號／PM 文件混技術名詞
- station-done-guard（J6）：收工判準是站的考題全綠，不是任務全關
- regression-scope（J7）：動實作 → 列出要重考哪幾題（只提醒不擋）
- install-artifact-guard（S1）：實例不改機制
- orchestrator-scope-guard（S4）：總管不進成員 repo 動實作（從實例上收進框架，
  路徑清單改由實例自填，範本零專名）
掛載鏈依「範圍大的擋在前」：改機制 → 角色 → 位置 → 格式 → 既有三支

■ 還清兩件舊債
- update.sh 檔案清單改讀 manifest（舊硬編降為抓不到來源時的 fallback）
  ——install/update 兩份手抄清單漂移的根因全修
- CLAUDE.md 界標補植：舊實例全文原封包進本地區、框架區重鋪、原檔備份、冪等
  ——解開「沒界標⇒不敢覆蓋⇒框架改的憲法永遠送不到既有實例」這個死結

■ 修掉三個自己造的問題（實測抓出來的，不是想出來的）
- jdd-format-guard 誤擋真實 journeys.md 的「這卷還缺什麼」自述段
  → 排除法改**正面圈定**（只掃卡片本體與站內文），說明區/自述段/索引自然不在範圍
- install-artifact-guard 把 pre-write-guard.sh 也擋了——而它的錯誤訊息正叫人去改那支
  → 使用者自訂插槽列為最優先放行
- check-legacy-paths 用 HEAD 當基準會**自我弱化**：改成清單驅動後保護範圍 35→29 條
  → 基準改指最後一次真正發佈的版本

■ 實測（全部貼過輸出）
- G2 考生改考卷：6/6，含 orchestrator 寫 code／engineer 改考題／考題藏別處
- G4 憲法分流：兩環境重裝，總管版技術軌關鍵字 0、成員版上游指針 8，界標 4/4
- G6 實例改機制：4/4，含框架開發標記放行與自訂插槽放行
- G7 CI 擋實例名：注入違規 → 指出檔案行號 exit 1
- G3 進度以站計量：起牀推「J-1 已點亮 2/9 站」、收工列未亮站並禁用任務數當理由
- 回歸考、界標補植冪等、orchestrator-scope-guard 四組：全通

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-06 00:26:56 +08:00
Leo 671503fd70 feat: wiki 資訊架構 push/pull 判準 + principles 原則 push 檔 + bump 1.10.0 
從「用戶所有檔案一律改寫成 wiki」前提,用 push(行動前必看見)vs pull(按需查)
重新推導 wiki/ 每個檔存廢——wiki 主要給 AI 看,判準是 CC 做事會不會被動看見。
對應 SDD: wiki-architecture(內部,依原則不推)。

- 新增 principles.md(push 全文):收跨全局原則(不污染根目錄、low-code…),
  原則是會被遺忘的盲區,沒推到眼前 CC 設計時不服從。一行一條 ≤15。
- mistakes 改 push 摘要(標題+症狀,全文按需展開,量大不撐爆 context)
- decisions-summary 降級為 cards + INDEX 決策視圖(既有相容)
- INDEX 升級多角度視圖的家:新增角度只改 INDEX,不開檔不問用戶
- session-start hook 三類 push:principles 全文→status→mistakes 標題;>15 警告
- install 補 principles download;update 加 add_if_missing(補範本/已有則保留)
- push/pull 判準寫進 wiki-init + SKILL,CC/Cowork 共用
- 沙盒驗證:三類注入順序與量受控、add_if_missing 不覆蓋用戶內容、全 bash -n 過

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 17:34:26 +08:00
Leo ead3593109 fix: 遷移後 CLAUDE.md 殘留舊路徑 → hook 偵測並提示 CC 代修 + bump 1.9.3 
升級 1.9.x 後 wiki 已搬 system-dev/,但 update.sh 鐵則絕不碰 CLAUDE.md(用戶資料),
CLAUDE.md 內仍寫 .claude/wiki 舊路徑,CC 照它找錯位置(KB 端升級後發現)。

- session-start hook 偵測:wiki 已遷移但 CLAUDE.md 有 .claude/wiki → 接關後提示 CC 代修
- 由 CC 代改而非腳本盲 sed:避免誤傷用戶自寫內容、不破鐵則
- SDD install-layout 補一條決策(小修,不重寫)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 16:09:11 +08:00
Leo ecf1f882c6 feat: 安裝結構收進 system-dev/(不污染用戶根目錄)+ 舊版自動遷移 + bump 1.9.0 
工具產物原散在用戶根目錄(docs 七層、scripts),又把 wiki/VERSION 寄生在 CC 原生
.claude/ 裡,用戶分不清哪個 docs 是工具的。這版徹底收斂:除 .claude/(settings/
commands/hooks)與 CLAUDE.md 留根,工具所有資料收進 system-dev/。

對應 SDD: system-dev/docs/3-specs/install-layout/(內部記錄,依原則不推)。

- 新結構 system-dev/{VERSION,wiki/,docs/,scripts/};.claude/ 只剩 CC 機制檔
- wiki 改寫產物落點正式化:install 建 system-dev/wiki/cards/(.gitkeep)
- docs 雙語義拆開:工具文件→system-dev/docs/;用戶 raw source 維持原處只讀
- scripts 一開始就裝進 system-dev/scripts/
- 舊版自動遷移雙保險:update.sh 冪等搬移(wiki 含 .git、docs 白名單)
  + session-start hook 偵測舊結構未遷移時提示(low-code 用戶兜底)
- wiki-secret-scan 觸發路徑改 system-dev/wiki/**(否則新結構防護失效)
- 全套路徑引用同步:CLAUDE/SKILL/wiki-*/sdd-*/hooks/INDEX/README(中英)
- 沙盒驗證:遷移含 .git commit 一致、冪等、用戶自填 docs 保留;全 bash -n 過

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 15:13:43 +08:00
Leo 39783cccc8 feat: 接關 hook + SDD 強制 hook（實作 wishlist 兩項） 
§1 接關機制（雙保險）：
- session-start-recall.sh：SessionStart 自動注入 status 重點 + 快照核實提醒
- /wiki-recall：fallback 命令，hook 失效時手動接關

§2 軟規範 → 硬攔截：
- sdd-guard.sh：動 code 檔但無 SDD → exit 2 擋（/sdd-check 自動版）
- pre-write-guard.sh：專案自訂禁令骨架（預設停用）
- settings.json：掛 SessionStart + PreToolUse

配套：install.sh 下載 hooks/settings（settings 比照 CLAUDE.md 不覆蓋）；
README/CLAUDE.md 補文件 + 誠實限制聲明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 16:04:58 +08:00