diff --git a/scripts/audit-seams.mjs b/scripts/audit-seams.mjs
index 6ad14966455e..bda525118d2f 100644
--- a/scripts/audit-seams.mjs
+++ b/scripts/audit-seams.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Audits repo ownership seams, optional plugin leaks, and nearby test coverage signals.
 
 import { promises as fs } from "node:fs";
 import path from "node:path";
diff --git a/scripts/bench-test-changed.mjs b/scripts/bench-test-changed.mjs
index 1045c529bdb3..d7cd7c51ab91 100644
--- a/scripts/bench-test-changed.mjs
+++ b/scripts/bench-test-changed.mjs
@@ -1,3 +1,4 @@
+// Benchmarks `pnpm test:changed` planning/runtime behavior across repeated runs.
 import { spawnSync } from "node:child_process";
 import path from "node:path";
 import { parseFlagArgs, stringFlag } from "./lib/arg-utils.mjs";
diff --git a/scripts/build-all.mjs b/scripts/build-all.mjs
index 08576c2436b2..888e8b9054c4 100644
--- a/scripts/build-all.mjs
+++ b/scripts/build-all.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Builds OpenClaw packages and plugin SDK artifacts with cache-aware orchestration.
 
 import { spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
diff --git a/scripts/build-docs-list.mjs b/scripts/build-docs-list.mjs
index a827b67e821a..16e80b5dea71 100644
--- a/scripts/build-docs-list.mjs
+++ b/scripts/build-docs-list.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Writes the `bin/docs-list` wrapper used by package scripts and docs tooling.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
diff --git a/scripts/check-changed.mjs b/scripts/check-changed.mjs
index 556a271eb7fb..4c98f2260de7 100644
--- a/scripts/check-changed.mjs
+++ b/scripts/check-changed.mjs
@@ -1,3 +1,4 @@
+// Runs the changed-file check lanes selected by `scripts/changed-lanes.mjs`.
 import {
   accessSync,
   chmodSync,