diff --git a/CLAUDE.md b/CLAUDE.md
index 85486055..54aa3453 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -295,6 +295,8 @@ docs/
   boundary.md          operator/agent trust model rationale
   agent-hierarchy.md   tree-shape topology design + manager-privilege audit (#361)
   damocles-migration.md  future migration plan for damocles → hyperhive
+  gateway.md           nginx vhost map, matrix discovery flow, firewall posture,
+                       HIVE_FORGE_URL loopback rationale (#764, #772, #793)
 ```
 
 ## Reading paths
@@ -316,6 +318,8 @@ read them à la carte.
   pattern."** → [`docs/conventions.md`](docs/conventions.md).
 - **"Why does the nspawn flag look like that?"** →
   [`docs/gotchas.md`](docs/gotchas.md).
+- **"What nginx vhosts does the gateway serve? How does matrix
+  discovery work?"** → [`docs/gateway.md`](docs/gateway.md).
 
 ## Conventions & process