diff --git a/CLAUDE.md b/CLAUDE.md
index a94d60543..c3f3615f2 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -49,7 +49,7 @@ When bumping the version, update **all** of these locations to keep them in sync
 - `package.json` → `version`
 - `.claude-plugin/plugin.json` → `version`
 - `.claude-plugin/marketplace.json` → `plugins[0].version`
-- `public/index.html` → hero version link text + new changelog entry
+- `public/index.html` → hero version link text + new changelog entry (user-facing changes only, not internal build/tooling details)
 
 ## Adding New Skills