diff --git a/build-linuxcnc-wasm-probe-objects.sh b/build-linuxcnc-wasm-probe-objects.sh
index 5711ac1..b4528ad 100755
--- a/build-linuxcnc-wasm-probe-objects.sh
+++ b/build-linuxcnc-wasm-probe-objects.sh
@@ -3,6 +3,11 @@ set -euo pipefail
 
 cd "$(dirname "$0")"
 
+# LinuxCNC source basis: object probes compile the core entries selected from
+# linuxcnc-rs274-wasm-source-files.txt, including src/emc/rs274ngc,
+# src/emc/tooldata/tooldata_common.cc, src/emc/ini/inifile.cc, and
+# src/emc/nml_intf/emcops.cc, together with wasm-safe shims that replace the
+# manifest's blocked Python, dlopen, tooldata mmap, HAL, and runtime edges.
 usage() {
     echo "usage: $0 --mode source-objects|rs274ngc-pre|runtime [manifest]" >&2
 }
diff --git a/list-linuxcnc-wasm-manifest-sources.sh b/list-linuxcnc-wasm-manifest-sources.sh
index a477020..e67eb9e 100755
--- a/list-linuxcnc-wasm-manifest-sources.sh
+++ b/list-linuxcnc-wasm-manifest-sources.sh
@@ -3,6 +3,9 @@ set -euo pipefail
 
 cd "$(dirname "$0")"
 
+# LinuxCNC source basis: linuxcnc-rs274-wasm-source-files.txt enumerates the
+# RS274, tooldata, INI, NML, RTAPI, HAL, and PythonPlugin LinuxCNC files that
+# are compile-checked or shimmed for the browser/WASM source-link path.
 manifest=${1:-linuxcnc-rs274-wasm-source-files.txt}
 filter_group=${2:-core}
 output_mode=${3:-relative}
diff --git a/test-linuxcnc-wasm-blockers.sh b/test-linuxcnc-wasm-blockers.sh
index 504777e..4fa7877 100755
--- a/test-linuxcnc-wasm-blockers.sh
+++ b/test-linuxcnc-wasm-blockers.sh
@@ -3,6 +3,11 @@ set -euo pipefail
 
 cd "$(dirname "$0")"
 
+# LinuxCNC source basis: this guardrail locks the blocker categories reported
+# by analyze-linuxcnc-wasm-blockers.sh for the RS274/WASM manifest. The locked
+# groups cover LinuxCNC Python/Boost.Python module bindings, tooldata mmap,
+# dlopen use, and native filesystem calls found in src/emc/rs274ngc and
+# src/emc/tooldata.
 manifest=${1:-linuxcnc-rs274-wasm-source-files.txt}
 self_checks=${CNC_SIM_WASM_BLOCKERS_SELF_CHECKS:-0}
 if [[ "$self_checks" != "0" && "$self_checks" != "1" ]]; then