diff --git a/CLAUDE.md b/CLAUDE.md
index cf4349c70..5768491eb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,3 +14,5 @@
 - NEVER assume clippy warnings are pre-existing, it is very rare that `main` has warnings
 - ALWAYS read and copy the style of similar tests when adding new cases
 - PREFER top-level imports over local imports or fully qualified names
+- AVOID shortening variable names, e.g., use `version` instead of `ver`, and `requires_python`
+  instead of `rp`