diff --git a/docs/swarm.md b/docs/swarm.md
index 37da4125..54c074ec 100644
--- a/docs/swarm.md
+++ b/docs/swarm.md
@@ -66,10 +66,10 @@ environment and forwarded to agent containers.
    peer linking to `https://{domain}/`. See
    `docs/web-ui/dashboard.md` § P33RS tab.
 
-2. **Agent identity** — `identity::peers()` in `hive-ag3nt` reads
-   the same env var and exposes the peer list to agents via
-   `get_agent_meta` so agents can address peers with qualified names
-   (`agent@peer-domain`).
+2. **Agent identity** — the same `HYPERHIVE_PEERS` env var is
+   forwarded to agent containers by `meta.rs`; agent code can call
+   `identity::peers()` to discover peer hives and address them with
+   qualified names (`agent@domain`).
 
 3. **Matrix federation** — when `matrix.enable` is on, tuwunel
    federates with the peer's matrix server at