diff --git a/CLAUDE.md b/CLAUDE.md
index 46ae352b..103b67cd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -91,6 +91,10 @@ This project is using Vite+, a unified toolchain built on top of Vite, Rolldown,
 
 Docs are local at `node_modules/vite-plus/docs` or online at https://viteplus.dev/guide/.
 
+## Built-in Commands vs Scripts
+
+`vp <name>` runs a built-in command. `vp run <name>` runs a `package.json` script or a `vite.config.ts` task. Scripts cannot overwrite built-ins, so `vp dev` and `vp run dev` may do different things. Check `package.json` and `vite.config.ts` first, and run `vp run <name>` when the project defines a script or task with that name.
+
 ## Review Checklist
 
 - [ ] Run `vp install` after pulling remote changes and before getting started.
diff --git a/package.json b/package.json
index 47496afb..da3e66c7 100644
--- a/package.json
+++ b/package.json
@@ -112,5 +112,5 @@
   "engines": {
     "node": ">= 22.19.0"
   },
-  "packageManager": "pnpm@11.8.0"
+  "packageManager": "pnpm@11.17.0"
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index a82abc45..66f1d846 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -87,7 +87,7 @@ importers:
         version: 0.7.3
       proxy:
         specifier: ^1.0.2
-        version: 1.0.2
+        version: 1.0.2(supports-color@7.2.0)
       selfsigned:
         specifier: ^3.0.1
         version: 3.0.1
@@ -2601,9 +2601,11 @@ snapshots:
       shebang-command: 2.0.0
       which: 2.0.2
 
-  debug@4.4.3:
+  debug@4.4.3(supports-color@7.2.0):
     dependencies:
       ms: 2.1.3
+    optionalDependencies:
+      supports-color: 7.2.0
 
   delayed-stream@1.0.0: {}
 
@@ -3005,11 +3007,11 @@ snapshots:
       ansi-styles: 5.2.0
       react-is: 17.0.2
 
-  proxy@1.0.2:
+  proxy@1.0.2(supports-color@7.2.0):
     dependencies:
       args: 5.0.1
       basic-auth-parser: 0.0.2
-      debug: 4.4.3
+      debug: 4.4.3(supports-color@7.2.0)
     transitivePeerDependencies:
       - supports-color