diff --git a/scripts/layout-probe.py b/scripts/layout-probe.py
index 1dc8ae1..6b89f30 100755
--- a/scripts/layout-probe.py
+++ b/scripts/layout-probe.py
@@ -19,7 +19,14 @@ USAGE
     <a python with playwright> scripts/layout-probe.py [URL ...]
 
 Exits 0 if every control is hittable, 1 if any is occluded. No arguments
-probes the booth index and every booth linked from it.
+probes the INDEX ONLY — it does not follow booth links, and the docstring
+claimed it did until 2026-09-22. Pass booth URLs explicitly to cover them:
+
+    scripts/layout-probe.py http://10.100.10.50:8090/{,b/my-run/}
+
+⚠ In zsh an unquoted `$URLS` does NOT word-split, so a variable holding
+several URLs arrives as ONE argument and the probe silently reports
+"2 page(s)" while covering two. Use an array and `"${URLS[@]}"`.
 """
 import sys
 from playwright.sync_api import sync_playwright