diff --git a/docs/swarm/ui.md b/docs/swarm/ui.md
index 4d43f5d9..83c75584 100644
--- a/docs/swarm/ui.md
+++ b/docs/swarm/ui.md
@@ -39,7 +39,9 @@ terminal, and below it the agent's **subagents**: every subagent the swarm
 queue holds terminal rows for from the last 24 hours. Picking one shows its
 terminal in the same preview, and **expand** opens it in its own tab, as it
 does for the agent. The list refreshes every 10 seconds, so a subagent the
-agent spawns shows up once it writes output.
+agent spawns shows up once it writes output. A subagent that drops out of the
+list closes its terminal, and a later subagent with the same name starts
+unpicked.
 
 On a terminal's own page (`/agents/<name>/terminal`, or a subagent's) the
 header has an **N running subagents** badge. It opens a list of the agent's