diff --git a/lib/src/lib/platform/types.ts b/lib/src/lib/platform/types.ts
index bf1636dc..8abd7e5b 100644
--- a/lib/src/lib/platform/types.ts
+++ b/lib/src/lib/platform/types.ts
@@ -176,8 +176,8 @@ export interface PlatformAdapter {
   // URL; absent or null falls back to ws://127.0.0.1:<port>.
   getAgentBrowserStreamUrl?(port: number): Promise<string | null>;
 
-  // iframe surface support (see docs/specs/dor-browser.md → "The transparent
-  // proxy"). Stands up a loopback proxy in front of a `dor iframe` target and
+  // iframe surface support (see docs/specs/dor-browser.md → "Iframe
+  // Renderer"). Stands up a loopback proxy in front of a `dor iframe` target and
   // returns the proxy URL the panel should frame, or a structured reason it
   // could not. Absent on hosts with no process to run a proxy (e.g. the web
   // host), where the panel falls back to a raw, uninstrumented `<iframe>`.
diff --git a/vscode-ext/src/iframe-proxy-host.ts b/vscode-ext/src/iframe-proxy-host.ts
index c4c49ee9..6f92886b 100644
--- a/vscode-ext/src/iframe-proxy-host.ts
+++ b/vscode-ext/src/iframe-proxy-host.ts
@@ -2,8 +2,8 @@
  * VS Code extension-host binding for the iframe transparent proxy.
  *
  * The proxy itself is host-agnostic and lives in `lib/src/host/iframe-proxy.ts`
- * (shared with the Tauri sidecar — see docs/specs/dor-browser.md → "The
- * transparent proxy"). This file only injects the VS Code logger; the
+ * (shared with the Tauri sidecar — see docs/specs/dor-browser.md → "Iframe
+ * Renderer"). This file only injects the VS Code logger; the
  * message-router calls `createIframeProxyUrl` exactly as before.
  */
 import { createIframeProxyUrl as createProxy } from '../../lib/src/host/iframe-proxy';