diff --git a/docs/web-ui.md b/docs/web-ui.md
index 0bd34739..78f55e7f 100644
--- a/docs/web-ui.md
+++ b/docs/web-ui.md
@@ -482,9 +482,11 @@ Three fixed-position layers frame a full-viewport terminal:
 glass — `backdrop-filter: blur` lets scrolled terminal rows show
 through. Three flex columns (#394 redesign):
 
-- **Agent icon** (`<img class="agent-icon">`): full-height square
-  identity anchor (6em, `height: 100%; aspect-ratio: 1`). Falls back
-  to the dimmed hyperhive mark on load error.
+- **Agent icon** (`<img class="agent-icon">`): fixed-size square
+  identity anchor (5em, `width: 5em; aspect-ratio: 1;
+  align-self: flex-start` — capped so a tall state-row doesn't
+  inflate the icon, #411). Falls back to the dimmed hyperhive mark
+  on load error.
 - **Main column** (`.agent-header-main`): two rows.
   - Row 1 (`.agent-header-title-row`): title (`<h2 id="title">`) +
     meta-nav (`<nav id="meta-links">`). Meta-nav renders