emma-hermes/docs/gateway-resilience/gateway-team-announcement.md

Gateway Resilience 團隊公告（可直接貼）

用途：這份是可直接貼到 Telegram / LINE / email / 團隊群組的公告版本，用來正式宣布 gateway-resilience 規格包啟用。

各位，為了避免 Hermes Agent update、gateway restart、或程式修改後，再次反覆出現「綁定遺失、LINE 長任務異常、email 附件/下載連結錯誤、治理後台認知不一致」這類問題，現在已整理並啟用一套 `gateway-resilience` 規格包。

這套的目的不是增加文書，而是把「改 code → 驗收 → 回報 → 快速修復」制度化，減少反覆排查與 token 浪費。

## 什麼情況必用
只要改動可能影響以下任一主線，就必須照這套流程：
- principal / verified email 綁定
- LINE 長任務 / pending / replay / heartbeat
- LINE quota fallback 到 email
- email 附件 / 副檔名 / 下載連結 / managed downloads
- principal / quota / role / admin / governance 後台

## 最短使用方式
1. 改前：先看 `gateway-change-impact-checklist.md`
2. 改後驗收：跑 `gateway-update-restart-sop.md`
3. 出錯排查：看 `gateway-recovery-playbook.md`
4. 對外回報：用 `gateway-validation-template-compact.md`
5. 若不知道先看哪份：先看 `gateway-entrypoint.md`

## 內外回報方式
- 內部完整驗收：`gateway-validation-template-full.md`
- Telegram / LINE / email 快速回報：`gateway-validation-template-compact.md`
- 不會填時：參考 `examples-principal-profile-routing-validation-full.md` / `examples-principal-profile-routing-validation-compact.md`

## 團隊規則
- 沒做 impact 判斷，不要直接改
- 改了 code，不要只看服務有起來
- pytest 綠燈，不等於功能真的正常
- PARTIAL 不要寫成 PASS
- 文件不是事後補，是變更的一部分

## 一頁入口
如果不想先記整包檔名，直接從這份開始：
- `gateway-entrypoint.md`

之後凡是 gateway 相關修改、update 後驗收、restart 後確認、或異常排查，都以這套文件為準，不再靠歷史對話與臨場試錯處理。

---

超短公告版

已啟用 `gateway-resilience` 規格包。之後只要動到綁定、長任務、fallback、附件/下載連結、governance 後台，改前先勾 `gateway-change-impact-checklist.md`，改後跑 `gateway-update-restart-sop.md`，回報用 `gateway-validation-template-compact.md`。若不知道先看哪份，直接從 `gateway-entrypoint.md` 開始。