diff --git a/CLAUDE.md b/CLAUDE.md
index f551917..23185e6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -26,12 +26,16 @@ npm run lint     # ESLint on TypeScript/JavaScript sources
 npm run anylize  # Build with webpack-bundle-analyzer
 ```
 
-After building, copy the output to the repo root:
-```bash
-cp "client/dist/3CX TAPI.prod.user.js" 3CX_TAPI.user.js
-```
+## Versioning & Release
 
-The root `3CX_TAPI.user.js` is the committed distribution artifact installed via Tampermonkey.
+**Never edit these files manually — they are auto-generated:**
+- `client/package-lock.json` (generated by `npm install`)
+- `3CX_TAPI.user.js` (generated by build)
+
+To release a new version:
+1. Bump `version` in `client/package.json` (1st digit = major, 2nd = feature, 3rd = bugfix/minor)
+2. Build: `npm run build` (from `client/`)
+3. Copy: `cp "dist/3CX TAPI.prod.user.js" ../3CX_TAPI.user.js`
 
 ## Server Commands