鐵人檔案
AI coding agent 越會寫程式，架構的約束力反而越重要——沒有清楚邊界時，AI 會用最短路徑寫出能動但難維護的東西。這系列主張架構的角色從「規範怎麼寫」變成「限制能改到哪裡」：怎麼把 Repository 分層、介面切分、依賴方向這些規則，從文件裡的建議變成 AI 動手時真的會撞到的邊界，並用真實案例說明沒有約束力的架構會怎麼失控。
前言：把 ADR 寫進 CLAUDE.md，是不是更方便？ 「昨天講的 ADR 聽起來很有用，那乾脆把每個 ADR 的重點都摘要進 CLAUDE.md，AI 每...
前言：邊界立好了，怎麼反而更難改了？ 「我們已經把架構邊界講清楚了，AI 也照著寫，為什麼程式碼變得更難懂，不是更好維護？」 這是把架構邊界建立起來之後，很容易...
前言：規則立對了，就一定用對了嗎？ 「我們已經把架構規則寫清楚了：業務邏輯一律經過 Service 層，不能讓 Controller 直接處理。這樣 AI 應該...
前言：用了 DI 容器，架構就自動變乾淨了嗎？ 「我們全面導入依賴注入容器了，所有類別都透過建構子拿依賴，架構應該乾淨很多了吧？」 這句話只對了一半。依賴注入容...
前言：型別提示介面，換實作應該很安全吧？ 「建構子依賴的是一個介面，不是具體類別，換掉底層實作應該不會影響到呼叫端吧？」 昨天談到，依賴注入容器本身是一把雙面刃...
前言：寫測試變慢，是不是測試框架的問題？ 「這段程式碼的測試，每次都要啟動整個系統、連上資料庫、跑完一整條請求鏈路才能測到，是不是測試工具沒選對？」 這個問題背...
前言：CLAUDE.md 都寫了，為什麼 AI 還是違反架構規則？ 「架構分層規則已經寫進 CLAUDE.md 了，這條規則不是就一直存在嗎，怎麼還會被違反？」...
前言：規則寫進文件那天,它最有效 「這條規則我已經寫進 CLAUDE.md 了，AI 應該會一直遵守吧？」 如果你也這樣想過，先別急著放心。昨天講到架構規則要盡...
前言：拆得越細，AI 是不是就越好用？ 「把系統拆成微服務，是不是就代表可以放心讓 AI 到處改，反正邊界已經分好了？」 這句話只對了一半。拆分本身不會自動讓...
前言：「順便看一下」跟「專門檢查」是兩件事 「反正 code review 都交給 AI 了，架構有沒有違規，AI 應該也會順便看到吧？」 這句話聽起來合理，卻...
