OpenSpec SDD 實踐 — 讓 AI 不漂走的文件驅動開發

OpenSpec v1.3 的 SDD（Software Design Document）實踐有幾條核心原則：文件要精，只給 UML 工程藍圖，不給廢話；每次改 code 之前先改文件；每張票結束前讓 AI 確認 code 與文件一致。

複雜專案的後期有個常見現象：AI 開始「漂走」——產出的 code 開始偏離原本的設計意圖。這時候的解法不是繼續 prompt，而是重新用 wireframe 把架構畫一遍，讓 agent「回魂」。Wireframe 重畫等於強制把 agent 的注意力拉回架構層，避免它在細節裡迷失。

文件先於 code 的核心邏輯：AI 寫 code 速度很快，但方向錯了改起來代價更高，文件是方向的錨。