diff --git a/scripts/stage-colibri-iso.sh b/scripts/stage-colibri-iso.sh
index 1be0ac59..ebfb5cfa 100755
--- a/scripts/stage-colibri-iso.sh
+++ b/scripts/stage-colibri-iso.sh
@@ -157,7 +157,12 @@ BW_SERVER="https://vault.smilepowered.org"
 #
 # Behavior toggles (non-secret):
 # COLIBRI_AUTOSPAWN_PI="YES"            # auto-spawn one Pi on daemon startup
-# COLIBRI_PI_BINARY="pi"               # Pi executable name/path
+# COLIBRI_PI_BINARY="pi"               # Pi executable name/path; zot is staged on
+#                                      # the image but needs the zot-rpc driver
+#                                      # before it can autospawn (spawner uses
+#                                      # stdin(Stdio::null()) — zot needs stdin).
+#                                      # See: ADR-agent-harness-consolidation.md
+#                                      # + colibri issue zot-rpc-driver.
 # COLIBRI_AUTOSPAWN_PI_ARGS="--mode json"   # Pi argv
 # COLIBRI_MCP_EXTERNAL_CALL="1"        # allow Pi (via colibri-mcp) to call
 #                                      # external MCP servers; set by