diff --git a/CLAUDE.md b/CLAUDE.md
index 4bbc4b9..217210d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -54,3 +54,4 @@ Installers (`install/*.sh`) MUST be idempotent — check before installing.
 ## Commits
 
 Do not add `Co-Authored-By` lines to commit messages.
+Prefer one-line commit messages. Add a longer description only when necessary for better understanding.