2026年4月30日下午。Rembrandt項(xiàng)目的/admin頁(yè)面第三次背叛我。管理員Blandine看不到"簽到"標(biāo)簽頁(yè)，可權(quán)限網(wǎng)格里明明勾選了"簽到"。三十分鐘前我搞明白了：那個(gè)勾選框往dashboard_cards里寫(xiě)數(shù)據(jù)（顯示偏好），卻從來(lái)不碰can_access_emargement（權(quán)限標(biāo)志）。兩層語(yǔ)義堆在同一個(gè)網(wǎng)格里，被當(dāng)成一回事處理。

同事Niran在工位上啃漢堡，沒(méi)看我屏幕。我本該打開(kāi)app/admin/page.tsx開(kāi)修。但我新建了一個(gè)空文件：docs/adr/0040-admin-rbac-vs-dashboard-cards.md。一行代碼沒(méi)動(dòng)，先寫(xiě)Markdown。

這個(gè)順序——ADR先于首次提交，絕不事后補(bǔ)——是Rembrandt架構(gòu)唯一能立住的紀(jì)律。

事后補(bǔ)寫(xiě)的ADR是謊言。我堅(jiān)持的短版本只有四欄：最終決策、被否決的備選方案及理由、正負(fù)后果、參考資料。一頁(yè)紙。陷阱在于事后寫(xiě)：代碼已推送，決策憑直覺(jué)做出，ADR只是給既成事實(shí)披上連貫的外衣。與最終決策不符的細(xì)節(jié)被抹平，備選方案明知會(huì)被拒絕才寫(xiě)上去，負(fù)面后果因?yàn)檎诮?jīng)歷所以措辭謹(jǐn)慎。

這是禮貌的謊言。更糟的是它有用：讓未來(lái)的讀者誤以為在讀經(jīng)過(guò)檢驗(yàn)的決策，實(shí)際上只是在讀第一反應(yīng)的事后合理化。

有了Claude Code，風(fēng)險(xiǎn)成倍放大。我描述問(wèn)題，代理幾分鐘內(nèi)給出看似合理的架構(gòu)，我因?yàn)槟芘芡ň徒邮?。我沒(méi)測(cè)試過(guò)備選方案，甚至沒(méi)意識(shí)到存在備選。事后ADR把這種"非選擇"合法化。前置ADR則禁止這樣做——因?yàn)槟惚仨氃谥滥膫€(gè)方案會(huì)被采納之前，就把備選寫(xiě)出來(lái)。

形式強(qiáng)迫你誠(chéng)實(shí)。0040號(hào)ADR的生產(chǎn)環(huán)境版本長(zhǎng)這樣：日期、狀態(tài)、決策者、背景（三層語(yǔ)義分離、Blandine事件、約30分鐘診斷）、決策（四項(xiàng)具體措施）、被否決的備選方案。第一項(xiàng)備選是"表面修補(bǔ)（重命名標(biāo)簽）"——不處理根本問(wèn)題，已被拒絕。