啟用合約
用於設計、評審或改造終端介面（面板、側欄、狀態列、卡片、提示），特別針對 Gentle Shell。目標風格是將 IDE 放入終端機：密集、沉穩、以開發者為優先，絕非復古 TUI 風格的裝扮。不適用於網頁（請使用 gentle-design）。
硬性規則
- 絕不單從程式碼或記憶來評斷終端 UI：請先截圖（
references/visual-loop.md）並在每次修改前後查看 PNG。 - 在進行任何 UI 編輯前，務必閱讀
references/terminal-craft.md；這是基本底線，而非建議。 - 操作模式：熟悉度勝過表現力。使用 IDE 的詞彙（窗格、樹狀結構、分頁、狀態列、命令面板）；品牌存在於色板、密度和一個標誌性動作中。
- 每一行都有代價。層次結構來自於顏色角色、字重和對齊，而非空白行或巢狀外框。
- 每個畫面只陳述一個事實一次。在標題中顯示的資料不會在面板中重複。
- 一個指令，一個目標。精煉保留系統；重新設計則取代系統。絕不美化即將被拋棄的外觀。
- 渲染保持輕量：渲染路徑中不可有 I/O 或重新計算，快取鍵包含所有會改變輸出的因素（樣式、寬度、主題）。
- 模型（透過
gentle-design）必須能以終端機表達：使用ch單位的等寬字元網格，僅有前景/背景色、粗體/暗淡/斜體/底線/刪除線、框線繪製字元及字形。
決策關卡
| 提問 | 指令 | 載入 |
|---|---|---|
| 尚無產品/設計脈絡 | document | references/design-doc.md |
| 新介面或重新設計 | shape，然後模型，最後實作 | references/commands.md |