Skip to content

L1/L2 知識層瘦身:index 去重、sdd-workflow 拆分、超標 README 抽取 #64

Description

@benwu95

背景

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 的抽取閾值

範圍

  1. index.md module 列瘦身:Description 欄縮至路由所需(Keywords/Aliases/Status/Depends On + 1-2 句定位),細節下放 README
  2. sdd-workflow.md 按 phase 拆分為多檔(載入時只取相關段)
  3. 超標 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)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions