寫稿者只寫 md，網站自己長出來

起點不是「想做一個文件站」，是產一份文件的成本已經高到會讓 agent 死在半路。FR-060 討論稿手刻了 1,003 行 HTML，第一支撰寫 agent 因單次輸出過長 stalled mid-stream 陣亡——連檔案都沒開始寫；重派改成「分 7 次寫入」才勉強完成，約 11 分鐘。版面、CSS、章節編號、mermaid 主題全部混在內容裡，每產一份都要重刻一次。

決策者的指示很直接：改成寫 md → 共用轉換 → 產 HTML。四個階段做完之後，寫稿者只需要寫 markdown 加一段 YAML front matter，render_index.py 掃整個需求資料夾，一次產出互連的靜態網站——左側常駐檔案樹、頁尾上下篇、mermaid 自動渲染、深淺主題切換。

python scripts/deliverables/render_index.py docs/features/FR-060-2608-.../   # 單站
python scripts/deliverables/render_index.py --all                            # 全部四站
python3 -m http.server 8099                                                  # 開檔要 HTTP server

已建站四個共 117 頁：FR-060 / FR-011.2 / FR-011.3 / FR-026。本頁自己也是用這套機制產的——收尾文件用剛做好的機制產出，等於再走一次完整流程當驗收。

機制的操作規範（front matter 欄位、可用版面語法、開檔方式、動 script 的驗收清單）在 .claude/skills/doc-site-build/SKILL.md，那份是 single source of truth，本頁不重複。實作經過、決策脈絡與教訓見下方 handoff SUMMARY。

以下全部由 build 掃資料夾產生，新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML，md 連向源檔。

本資料夾目前只有 README，尚無其他文件。

交接與收口時間軸（handoff/，1 份）

由新到舊。每份是某一棒次交接當下的完整現況快照，看某個時間點「當時知道什麼」請從這裡進。

卡片內容（決策紀錄、驗收條件）以 Notion 為準，本頁只記座標。

相關需求：

• FR-060 — detection-profile-content-management
• FR-011.2 — ssp-import-export-phase2
• FR-011.3 — ssp-edit-in-project
• FR-026 — project-flow-engine-integrate