Specs

每個 .md 是一份基礎 spec（一個主題一份）。後續要更新或修改就改同一份檔，不另開 addendum。

慣例

• 一主題一檔、扁平：specs/<topic>.md，無子資料夾。
• 不放 frontmatter、不放完成度、不放 changelog：spec 只描述設計 —— # 標題 + 內容。
• 「做了 / 沒做」記在 ../roadmap.md，不寫進 spec。
• 變更史：查 git log --follow specs/<topic>.md，不手寫 changelog。
• 連結：相對 md link（例 [訂單派發](./order-assignment.md)、[ADR 0005](../docs/adr/0005-pii-mask-tail3.md)）。不用 wiki-style link。
• 新 spec 從 _TEMPLATE.md 複製。

維護規則（code is truth、現行架構事實、spec 分類、跨 spec 待協調）見 CLAUDE.md。 完整 spec 清單與實作狀態見 ../roadmap.md。