所有標籤團隊文件要長得差不多、看得懂,靠的是兩份模板和一條原則。原則是寧可少而新鮮:Google 的文件指南說,少量但新鮮正確的文件,勝過大量年久失修的文件,別處有的就連過去。how-to 模板照「先決條件、步驟、怎麼確認成功、出問題找誰」排;一項研究裡,照模板改寫的安裝說明在讀者評分的十個面向中有八個較好。決策紀錄(ADR)記下當時為什麼這樣決定,推翻時不刪、標成「已被取代」並連到新決定。研究也看到 ADR 常常試了沒繼續、「考慮過的選項」那段問題最多,常常沒寫或寫錯地方,所以模板要短,那一段要留著。
不是每個人都該直接用 coding agent 改 code。AI Native 團隊要搞定 interface 規格、測試先行、monorepo、security guardrail、human-in-the-loop 與 token 預算管控,在 coding agent 上面再建一層 agent platform 並明確開發者角色轉型才是正途。
當 AI agent 能在幾分鐘內把 intent 變成 PR,軟體工程的瓶頸就從「規劃該做什麼」翻轉成「評估做出來的東西對不對」。Ticketing 時代的產物(sprint、story point、backlog grooming)正在壓縮歸零,取而代之的核心實踐是 review。