背景
L1/L2 知識層實質超重,且層間重複:
prospec/index.md 的 6 個 module 列共 8,666 bytes(佔 index 75%),Description 欄逐 change 累積技術細節(REQ 編號、函式名、行為描述),與各 README 的 Key Files/Public API 大幅重疊——types 列 1,390 B 幾乎逐項對應 modules/types/README.md 表格,直接違反 index.md:59 自訂的 Principle 2「Each layer must NOT duplicate information available in a lower layer」
sdd-workflow.md 單檔 71KB(~17,900 tokens),涉 SDD 工作流即整檔載入
- services/lib README(18,227 / 16,301 B)遠超
_module-readme-conventions.md:91 的抽取閾值
範圍
- index.md module 列瘦身:Description 欄縮至路由所需(Keywords/Aliases/Status/Depends On + 1-2 句定位),細節下放 README
sdd-workflow.md 按 phase 拆分為多檔(載入時只取相關段)
- 超標 README 依約定抽 sub-module
排程建議
先合 knowledge-size drift check(#63)——有 size 護欄再瘦身,防止回彈。
驗收條件
- L1 實載回到宣告預算內(或接近)
knowledge-size check 對瘦身後檔案不再 WARN
- drift 其餘 check(req-references 等)全綠——瘦身不破壞引用
來源
稽核報告 03(.tasks/chore/scan-by-fable5/,2026-07-03)
背景
L1/L2 知識層實質超重,且層間重複:
prospec/index.md的 6 個 module 列共 8,666 bytes(佔 index 75%),Description 欄逐 change 累積技術細節(REQ 編號、函式名、行為描述),與各 README 的 Key Files/Public API 大幅重疊——types 列 1,390 B 幾乎逐項對應modules/types/README.md表格,直接違反 index.md:59 自訂的 Principle 2「Each layer must NOT duplicate information available in a lower layer」sdd-workflow.md單檔 71KB(~17,900 tokens),涉 SDD 工作流即整檔載入_module-readme-conventions.md:91的抽取閾值範圍
sdd-workflow.md按 phase 拆分為多檔(載入時只取相關段)排程建議
先合 knowledge-size drift check(#63)——有 size 護欄再瘦身,防止回彈。
驗收條件
knowledge-sizecheck 對瘦身後檔案不再 WARN來源
稽核報告 03(
.tasks/chore/scan-by-fable5/,2026-07-03)