voidzero-dev
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -6,6 +6,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
@@ -4,7 +4,7 @@
   "scripts": {
     "dev": "vp dev",
     "build": "vp build",
-    "prepare": "vp config"
+    "prepare": "vp config && void prepare"
   },
   "devDependencies": {
     "@types/node": "catalog:",