diff --git a/template/CLAUDE.md b/template/CLAUDE.md
index 7290f7e..afb377e 100644
--- a/template/CLAUDE.md
+++ b/template/CLAUDE.md
@@ -34,6 +34,29 @@
 
 ---
 
+## 🔴 第一鐵律：wiki 是判準，不准跳過（2026-07-20/21 leo 兩度點破）
+
+**要查任何東西之前，先搜尋 wiki——用 grep，不是只讀開頭幾行。**
+
+> leo：「花很多力氣去產生 wiki，最重要的就是要可以查詢，**結果要查的時候就跳過，那就白寫了**。」
+> 「重點是你自己的記憶對嗎？而你有按照規定去切實讀 wiki 嗎？」
+
+```bash
+grep -rin "<本題關鍵字>" system-dev/wiki/
+```
+
+**三條硬規則**：
+1. **wiki 與程式碼/歷史文件衝突 → 以 wiki 為準**。程式碼反映「還沒清乾淨」，不等於「還在用」。
+2. wiki 寫「不可動／待廢除／進行中」→ **讀它的解除條件並逐條核對**。那是當時狀態，不是永久禁令。
+3. 翻原文後得到新結論 → **回頭更新 wiki**（wiki 過時是債，要還）。
+
+**動外部系統（部署／curl／wrangler／acr／gh）前**：先找 repo 有沒有**現成腳本或 README 部署段**，
+別自創方法。（實例：2026-07-21 明明有 `npx wrangler deploy` 這條驗過的路，卻自己 curl 硬幹踩坑。）
+
+> hook `wiki-first-search.sh` 會在你查 code／下高風險指令時自動推 wiki 命中行；
+> **但機制只是提醒，判斷是你的責任**。
+
+
 ## Wiki 讀取順序
 
 | 檔案 | 時機 | 用途 |