領域建模 是做什麼的?
在設計過程中主動建立並精煉專案的領域模型。這是主動的紀律——挑戰術語、發明邊界案例,並在概念成形的當下立即寫下術語表和決策。(僅僅閱讀 CONTEXT.md 以取得詞彙並非此技能——那是任何技能都能做到的一行習慣。這個技能是為了當你在改變模型,而不只是消費它。)
檔案結構
大多數儲存庫只有一個上下文:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
如果根目錄存在 CONTEXT-MAP.md,則表示儲存庫有多個上下文。該地圖指向每個上下文的存放位置:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← 系統級別決策
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← 上下文特定決策
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
懶人建立檔案——僅當有內容可寫時才建立。如果 CONTEXT.md 不存在,則在首個術語確定時建立。如果 docs/adr/ 不存在,則在需要第一個 ADR 時建立。
會議期間
對照術語表挑戰
當使用者使用的術語與 CONTEXT.md 中的現有語言衝突時,立即指出來。「你的術語表將『取消』定義為 X,但你似乎指的是 Y——到底是哪一個?」
精煉模糊語言
當使用者使用模糊或過載的術語時,提出精確的標準術語。「你說『帳戶』——你指的是客戶還是使用者?它們是不同的東西。」
討論具體情境
當討論領域關係時,用具體情境進行壓力測試。發明能夠探索邊界案例、迫使使用者精確定義概念間邊界的情境。
與程式碼交叉比對
當使用者陳述某事物如何運作時,檢查程式碼是否一致。如果發現矛盾,提出來:「你的程式碼取消了整個訂單,但你剛才說可以部分取消——哪個才是對的?」
即時更新 CONTEXT.md
當一個術語確定後,立刻更新 CONTEXT.md。不要批量處理——在它們發生時就捕捉。使用 CONTEXT-FORMAT.md 中的格式。
CONTEXT.md 應完全不含實作細節。不要把 CONTEXT.md 視為規格、便條紙或實作決策的存放庫。它只是一個術語表,僅此而已。
謹慎提供 ADR
僅在以下三個條件都成立時才提議建立 ADR:
- 難以逆轉——將來改變主意的成本很高
- 缺乏上下文會令人驚訝——未來的讀者會疑惑「他們為什麼這樣做?」
- 是真實權衡的結果——存在真正的替代方案,而你基於特定原因選擇了其中一個
如果缺少任一條件,跳過 ADR。使用 ADR-FORMAT.md 中的格式。