docs: add cross-contamination prevention section to AGENTS.md

AGENTS.md

@@ -29,6 +29,32 @@ Rust-based digital asset management system with video analysis and RAG capabilit
 | Production | 3002 | ❌ 禁止修改 | `cargo run -- server` (僅 release 時) |
 | Portal (Tauri) | 1420 | 前端開發 | `npm run tauri dev` |
 
+## ⚠️ 交叉污染防制 (Cross-Contamination Prevention)
+
+**每個執行前必須評估是否會汙染其他獨立作業。**
+
+### Scope Isolation Matrix
+
+| 執行內容 | 允許的 Scope | 禁止影響 | 檢查事項 |
+|----------|-------------|----------|----------|
+| M4 delivery binary | `target/release/momentry` | Playground (3003), Production (3002) | 確認舊 process 未被誤殺 |
+| Playground server | `localhost:3003`, `dev.*` schema | Production (3002), `public.*` schema | `DATABASE_SCHEMA=dev` |
+| Production deploy | `localhost:3002`, `public.*` schema | Playground (3003), `dev.*` schema | 先停 production，不影響 playground |
+| Git commit | 只包含意圖修改的檔案 | 無關的 untracked files | `git status` 確認 stage 內容正確 |
+| CI / packaged tests | 測試環境 | 正式資料 | 測試用 DB 不能連到 production |
+| Doc changes | 指定文件 | 其他文件、程式碼 | `git diff --stat` 檢查 scope |
+| SQL migration | 目標 schema | 其他 schema、無關 table | `WHERE` clause 要精準 |
+| `sed` / `grep` / mass edit | 目標檔案集 | 非目標檔案 | 先用 `grep -c` 確認只有目標檔案匹配 |
+
+### Recent Violations / Near-Misses
+
+| 事件 | 問題 | 防止方式 |
+|------|------|----------|
+| `sed` API doc 編號 | `sed -i '' 's/.../.../g'` 改到所有行 | 先 `grep -c` 確認匹配，`git diff` 再提交 |
+| 亂加 `/api/v1/register` route | 不必要的 API 別名，汙染路由表 | 角色切換：路由設計不該由實作方決定 |
+| `DESIGN/` vs `STANDARDS/` vs `REFERENCE/` | 文件放到錯誤分類 | 先確認文件性質（草稿/標準/參考/記錄） |
+| Build release binary in plan mode | 浪費時間，無意義 | 嚴格遵守 plan/build mode 規定 |
+
 ### ⛔ 嚴格測試隔離規則 (Strict Test Isolation)
 - **所有測試 (Test) 必須在 Dev (3003) 進行**。
 - **絕對禁止 (ABSOLUTELY FORBIDDEN)** 在任何測試指令、Demo 流程或 API 檢查中使用 `localhost:3002`。