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-02、D-20260604-03、D-20260604-04)。spec corpus 其後整體搬遷至 open-4wd-specs repo 根,三資料夾慣例沿用不變。