diff --git a/docs/developer-guide.md b/docs/developer-guide.md
index 8b5935a4..7212f0ed 100644
--- a/docs/developer-guide.md
+++ b/docs/developer-guide.md
@@ -91,11 +91,10 @@ source $HOME/.cargo/env
 curl -fsSL https://deno.land/x/install/install.sh | sh
 export DENO_INSTALL="/home/$USER/.deno"
 export PATH="$DENO_INSTALL/bin:$PATH"
-
-# Install ReScript
-npm install -g rescript
 ```
 
+ReScript is pinned in `deno.json` (`npm:rescript@^12.0.0`) and resolved on first `deno task res:build` — no global install required.
+
 ### Clone and Build
 
 ```bash
diff --git a/docs/guides/QUICKSTART-FOR-SON.md b/docs/guides/QUICKSTART-FOR-SON.md
index 9ec30c32..50264a3f 100644
--- a/docs/guides/QUICKSTART-FOR-SON.md
+++ b/docs/guides/QUICKSTART-FOR-SON.md
@@ -16,7 +16,7 @@ On top of these, there are **overlay panels** you can open from the panel bar (v
 cd ~/Documents/hyperpolymath-repos/panll
 
 # Terminal 1: Start the ReScript compiler (watches for changes)
-npx rescript-legacy -w
+deno task res:watch
 
 # Terminal 2: Bundle the JS and serve
 just bundle && just serve:dev