diff --git a/docs/web-ui.md b/docs/web-ui.md
index e1f40c5a..07ac9e7b 100644
--- a/docs/web-ui.md
+++ b/docs/web-ui.md
@@ -37,7 +37,9 @@ This doc has been split for readability. Pick the section you need:
   [`web-ui/dashboard.md`](web-ui/dashboard.md) (Dashboard
   endpoints, Dashboard event channel).
 - **"How does the per-agent terminal render tool calls?"** →
-  [`web-ui/agent.md`](web-ui/agent.md) (Live view).
+  [`terminal-rendering.md`](terminal-rendering.md) (full row
+  taxonomy + dispatch walkthrough); for a high-level summary see
+  [`web-ui/agent.md`](web-ui/agent.md) (Per-stream rendering).
 - **"What slash commands does the agent accept?"** →
   [`web-ui/agent.md`](web-ui/agent.md) (Terminal-embedded prompt).
 - **"What are the per-agent HTTP endpoints?"** →