fix(web): align approvals with controlled automation language

docs/HARD_RULES.md

@@ -68,6 +68,71 @@
 | **🔴🔴🔴 IwoooS 資安治理** | **UI 可見 / AwoooP approval 當 runtime 授權** | **只讀證據 + allowlist + check-mode + controlled apply；critical 才 break-glass** | [→ IwoooS Security Governance](#iwooos-security-governance) |
 | **🔴🔴🔴 高價值配置** | **手改 Nginx / workflow / secret / runtime config 後直接 reload 或部署** | **source-of-truth + controlled gate + diff + rollback + verifier** | [→ High Value Config Control](#high-value-config-control) |
 | **🔴🔴🔴 AI Agent 執行** | **把告警丟回人工、或繞過 check-mode 亂寫** | **allowlist + check-mode + controlled apply + verifier + KM / PlayBook trust** | [→ AI Agent Controlled Runtime Authorization](#ai-agent-controlled-runtime-authorization) |
+| **🔴🔴🔴 Codex 額度 / 上下文** | **在舊長視窗反覆餵長 log / 多支線除錯** | **context_budget_gate + 短 handoff + New Chat 分流** | [→ Codex Context Budget](#codex-context-budget) |
+
+---
+
+## 🔴🔴🔴 Codex Context Budget
+
+> 2026-06-27 統帥要求：避免 Codex Pro 20x 額度因「重複讀取長上下文」暴跌。所有專案都必須把上下文預算視為工程資源；長 log、舊對話、多支線 debug 不得混在同一工作視窗反覆讀取。
+
+### 開工必跑 `context_budget_gate`
+
+每個新任務、除錯支線、部署驗證或跨產品切換開始前，Codex 必須先列出：
+
+```text
+context_budget_gate:
+- new_chat_recommended: true|false
+- reason: ...
+- long_context_risks: ...
+- token_spend_priority: goal_and_relevant_files_first
+- safe_next_action: ...
+- handoff_ready: true|false
+```
+
+### 必須建議 New Chat 的情況
+
+1. 任務已切換產品、服務、錯誤類型、部署層或資料層。
+2. 目前視窗已累積 Playwright、SSH、CI、K8s、browser HTML、stack trace 或重複錯誤 log。
+3. 需要讀取 / 貼入超過約 200 行 log、20KB 輸出，或同一錯誤已重試 3 輪以上。
+4. 需要重新建模問題，而不是延續同一個 patch。
+5. 同一視窗已有多條未關閉支線，且使用者只說「繼續」或「下一步」。
+
+### 正確做法
+
+1. 長 log 必須落地成檔案，用 `rg` / 精準搜尋讀關鍵段，不得整段貼入對話。
+2. New Chat handoff 必須控制在 20 行內，包含目標、cwd、已確認事實、已改檔案、驗證結果、blocker、下一步命令。
+3. 只同步 handoff、治理 snapshot、repo 檔案與明確指定 log 檔；禁止讀取、複製、同步 raw Codex / ChatGPT conversations、sessions、SQLite、auth、`.env`、runtime volumes。
+4. 若判斷不需 New Chat，必須明確說明原因：同一主題、上下文仍短、可用檔案精準搜尋延續。
+
+### Token 花費優先順序
+
+1. 第一優先：任務目標、成功條件、相關檔案路徑、精準錯誤摘要。
+2. 第二優先：必要程式碼片段、測試名稱、route / component / function 名稱、最小可重現命令。
+3. 第三優先：用 `rg` 找出的關鍵 log 段落、diff、失敗 stack trace 的最短關鍵段。
+4. 第四優先：大型文件、完整 CI 輸出、browser HTML、長截圖 OCR、全量 JSON。
+5. 禁止優先花 Token 在 raw conversation、完整 sessions、整份 SQLite、整段重複 log、無關 repo 掃描。
+
+### 官方做法對應
+
+1. `AGENTS.md` 保持短、穩定、可重用；細節文件需要時才讀。
+2. 複雜任務先 plan / scope，再讀檔、跑測試或修改。
+3. 只提供相關檔案、選取範圍與摘要；不要把整包歷史當上下文。
+4. 長內容先 chunk / summarize / preprocess，再餵必要片段。
+5. 使用 progressive disclosure：先索引、再摘要、最後才完整內容。
+6. 重複錯誤才升級成永久規則，避免規範膨脹吃掉上下文。
+7. 多小時任務用 `PLANS.md` / execution plan / handoff 承接。
+8. 小任務用低推理 / 輕量模型；高風險架構、資安、跨系統才升級推理力。
+
+### 禁止
+
+```text
+❌ 把 Playwright / SSH / CI / K8s 完整長 log 直接貼進同一視窗反覆分析
+❌ 為了接續任務讀 raw Codex sessions、ChatGPT conversations 或 SQLite
+❌ 多產品、多部署層、多錯誤型態混在同一視窗追到底
+❌ 沒有 handoff 就要求下一個視窗靠舊對話記憶
+❌ 把一次性任務細節塞進全域 AGENTS.md 造成每次開工都重複讀取
+```
 
 ---