diff --git a/CLAUDE.md b/CLAUDE.md
index fd9f92db..6dc8f00d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -170,7 +170,7 @@ canonical, maintained source; this file only summarizes. See
 | [09-security.md](docs/architecture/09-security.md) | Token storage, secure storage, network security |
 
 Release process lives in [docs/release-checklist.md](docs/release-checklist.md)
-and [docs/build-release.md](docs/build-release.md).
+and [docs/build/build-release.md](docs/build/build-release.md).
 
 ### Core principles (from the architecture docs)
 
diff --git a/scripts/build-windows-cross.sh b/scripts/build-windows-cross.sh
index 568613c3..e482a858 100755
--- a/scripts/build-windows-cross.sh
+++ b/scripts/build-windows-cross.sh
@@ -8,7 +8,7 @@
 # it can bundle the NSIS installer from a Linux host.
 #
 # Playback on Windows: video renders via WebView2 and audio via the webview
-# <audio> backend (WebviewAudioBackend) — see docs/build-windows.md.
+# <audio> backend (WebviewAudioBackend) — see docs/build/build-windows.md.
 #
 # Requirements (present in the Docker windows-cross target / unified builder):
 #   - rustup target x86_64-pc-windows-msvc
diff --git a/scripts/check-doc-links.sh b/scripts/check-doc-links.sh
index 1c60fd1d..a8a4a12b 100755
--- a/scripts/check-doc-links.sh
+++ b/scripts/check-doc-links.sh
@@ -56,6 +56,10 @@ EXCLUDES=(
   "./src-tauri/gen/*"
   "./src-tauri/target/*"
   "./.git/*"
+  # Agent/dev scratch worktrees (.claude/worktrees is itself git-ignored). These
+  # are full checkouts of the repo, so without this the checker walks every
+  # in-flight branch and reports its links as if they were ours.
+  "./.claude/*"
 )
 
 # Targets that do not exist in the repo *by design* because the publish-docs job