母案：CM-1049（文件產出機制泛化）— 文件產出機制泛化：md + build 涵蓋討論稿/規格，並自動生成 FR 索引頁

前作：CM-1050（共用 CSS + render_doc.py）已 Done；CM-1051（索引頁自動生成）已驗收

設計與驗證結論：docs/analysis/2026-08-03-doc-html-pipeline.md

決策者要的是什麼

「每一個需求都會是一個靜態網站，會有一個主頁，主頁可以連結到各個時期建立的文件 html」

CM-1051 做出了主頁（掃資料夾自動生成），但連結指向 .md——發成 Artifact 後那些連結根本點不開（單檔自足，沒有相鄰檔案）。

根因不只是連結字串寫錯：design.md 與 handoff 本來就沒有對應的 html，只有 discussion.md 被 build 過。單純改成「一律連 html」會產生指向不存在檔案的死連結。

本案範圍

把「會掃檔案的清單頁」採升成「真正的靜態網站」，三件事：

A. 資料夾內所有 md 都 build 成 html

• discussion.md / design.md / implementation-plan.md / handoff/*.md ……全部
• 一支指令 build 整個資料夾，不要逐檔手跑
• 已有 front matter 的照舊用；沒有的用檔名／第一個 h1 當 title（handoff 那類流水文件不應強制要求寫 front matter）

B. 導覽——這才是「站」而不只是一堆 html

• 主頁 → 各文件（連結改指 .html）
• 文件頁 → 回主頁（否則進去就出不來）
• 文件之間互連（上一份／下一份，或同類型清單）
• 現成基礎：render_doc.py 已會產頂欄導覽（§1 §2 那條），加「回主頁」不必重寫模板

C. 時期／類型的組織

• 主頁不只是平顯清單，依時序或類型分組（討論稿 → 設計 → 實作計畫 → handoff 時間軸）