diff --git a/CLAUDE.md b/CLAUDE.md
index 222fdf8f..fbbba080 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -37,6 +37,9 @@ hive-c0re/         host daemon + sibling operator CLI (lib + 2 bins)
   src/server.rs         host admin socket (HostRequest → dispatch)
   src/client.rs         admin-socket client
   src/manager_server.rs manager-privileged socket (ManagerRequest)
+  src/agent_ports.rs    writes `/var/lib/hyperhive/agent-ports.json` on
+                         meta sync; gateway reads port→name map for
+                         per-agent `/agent/<name>/` routing (#15).
   src/agent_server.rs   per-sub-agent socket listener (long-poll Recv)
   src/broker.rs         sqlite Message store + intra-process broadcast
                          channel (`MessageEvent`) for `recv_blocking_batch` +