跳轉到

D-20260604-01|project-resources 全面脫鉤與廢棄資訊鐵則

背景與驅動力

先前已定 spec corpus=canon、project-resources/= 純歷史,但 canon 內仍散落約 120+ 裸指標(「詳見 xxx/spec.md」形)指向已過時的 project-resources 模組 spec(如 protocol_version 型別新舊不一致),canon 實質仍依賴 stale 檔案。本批一次切斷、不因後續規則變動重做。

考慮過的選項

(流水帳未記錄替代方案;本決策以修正 / 收斂 / 翻案形式成立)

決定

  • 全面脫鉤:實作細節遷入新 程式架構/<module>.md(27 模組、英文檔名對應 src/、蒸餾與對賬後入檔);領域設計留 canon 主檔;所有指標 re-point。設計美術類產物入新 美術資源/ 資料夾;待定模組入 其他/
  • 3 資料夾慣例程式架構/= 已拍板 src/ 實作(英文檔名、程式架構.md 索引);美術資源/=canon 細化同名資料夾(繁中檔名、美術資源.md 索引);其他/= 待定 / 未拍板模組(其他.md 索引)。
  • 廢棄資訊鐵則:權威檔(程式架構/ 與所有 spec)絕不留 reconcile、已移除、舊對新、日期註記等歷程敘述——歷程一律歸 歷史記錄.md

後果與影響

project-resources 定格為純歷史、canon 零依賴;「權威檔只寫現況」成為全 corpus 寫作紀律,後續每輪複審據此掃殘。脫鉤期間一併裁決的領域決定各自立檔(如 D-20260604-02D-20260604-03D-20260604-04)。spec corpus 其後整體搬遷至 open-4wd-specs repo 根,三資料夾慣例沿用不變。