用文件與 loop 守住決策

概要

• 人和 LLM 都有脈絡限制Michal 用猴子與香蕉的故事開場，說人會離職、LLM 沒有記憶，團隊久了就沒人答得出某個流程或程式碼為什麼長這樣。
• ADR 記下決定與執行方式ADR 寫的是為什麼這樣做、怎麼強制執行。Michal 舉的例子是程式碼分層來避免 n plus one queries，並用 lint 檢查 import；他們有大約 50 份 ADR。
• PRD 和 BDD 補上產品面PRD 寫一個功能為什麼存在、解決什麼問題、使用者怎麼走完流程，可以很輕。BDD 用 Cucumber 寫成人看得懂又能執行的場景，補上 spec-driven development 沒解決的驗證問題。
• 設計系統讓 UI 一致先把元件的語言與規則寫下來，例如同一頁只能有一個 primary button，再用元件、預覽和規則檢查來確保 agent 做出來的畫面一致。
• 用 loop 把規則變成強制的git hooks 與 CI 跑同一批檢查，agent 要交 pull request 就得通過；被擋下時會連到對應文件，讓它讀完再修。
• 代價是很吃脈絡這套做法會用掉大量 context，但 Michal 說重要的東西會留下來、agent 會重新查，所以不怕 context compact。

原話

• “One thing harder than reading an AI code is reading AI tests.”

  比讀 AI 寫的程式更難的，是讀 AI 寫的測試

  ▶ 04:28

• “because there is no space for discussion about these anymore”

  因為這些事已經沒有討論的空間了，風格與格式都是自動執行的規則

  ▶ 08:32

• “You cannot keep finding them. You need to prevent them entirely.”

  不能一直找問題，要徹底防止它發生

  ▶ 09:28

• “I have no fear of context compacts”

  我不怕 context compact

  ▶ 11:13

• “So may the spec be with you.”

  願規格與你同在

  ▶ 12:16

延伸

• Michal 曾在 Microsoft、Red Hat 工作，也花了十年做同一個產品，這些筆記就是從那段經驗整理出來的。
• ADR 也會寫明涵蓋哪些檔案或資料夾；工具擋下 agent 時會告訴它違反哪條規則、為什麼、該怎麼修，agent 再回頭去找那份文件。
• PRD 不只寫給 agent 看，也是寫給六週後忘了當初為什麼這樣做的自己。
• Michal 說這套 loop 用了大約半年，一個 session 裡會有 20 到 50 次 context compact。