diff --git a/CLAUDE.md b/CLAUDE.md
index 768e5e4f..02402f05 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -277,3 +277,6 @@ The docs below own the details — this section just points at them.
 - **Pre-push lint hook** (catches tracker-tag and comment-block failures
   before CI does — install once per clone):
   `ln -sf ../../scripts/pre-push .git/hooks/pre-push`
+- **Comment/PR-description length**: size it to how non-obvious the thing
+  is, not to how much investigation it took to find it. Full guidance +
+  worked example: `/knowledge/comment-style.md`.