diff --git a/hive-ag3nt/src/web_ui.rs b/hive-ag3nt/src/web_ui.rs
index e81021c4..98579a74 100644
--- a/hive-ag3nt/src/web_ui.rs
+++ b/hive-ag3nt/src/web_ui.rs
@@ -438,11 +438,11 @@ struct StateSnapshot {
     swarm_name: Option<String>,
 }
 
-/// One navigation link in the agent page header row. Same JSON
-/// shape feeds the dashboard's icon-only nav strip via the host's
-/// `GET /api/agent/{name}/links` passthrough proxy, so the agent
-/// backend is the single source of truth for what links an agent
-/// exposes.
+/// One navigation link in the agent page header row. The same JSON
+/// shape appears in both `StateSnapshot.links` (`GET /api/state`,
+/// per-agent page) and `DashboardState.links` (`GET /api/dashboard-state`,
+/// dashboard card icon strip). `agent_links()` is the single source
+/// of truth for what links an agent exposes.
 #[derive(Serialize)]
 struct AgentLink {
     /// `kind = Container | Forge` → path; `kind = External` → full URL.