diff --git a/AGENTS.md b/AGENTS.md
index 6267a8a..11dc489 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -108,6 +108,11 @@ git add -A && git commit -m "session: $(date +%Y-%m-%d_%H%M%S) — <project>" &&
 
 **No cron, no daemons** — just two git commands per session. Zero overhead when idle.
 
+### Docs Portal Rule (Every Session)
+- When any infrastructure service is added, removed, or changed (new domain, new port, new container), the docs portal at `https://docs.dzonicasa.xyz` MUST be updated.
+- The portal HTML is at `~/nginx-proxy/docs/index.html` on oracle-vps.
+- Push the updated HTML to Gitea repo `codex-cli-shared` alongside other changes.
+
 ### Handoff protocol (when switching models mid-project):
 - Example: codex started building an API, then crashed. User opens deepseek.
 - Deepseek reads HANDOFF.md → sees: "FastAPI app, 4 endpoints, SQLite, pending: add auth".