From b676cd4a3b97e45b8a3ae66fcc2f033ce48f1b66 Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Sun, 30 Aug 2026 13:54:40 +0200
Subject: [PATCH] CLAUDE.md: add comment/PR-description length pointer

mara, PR#3759: follow-up after internal/knowledge#82 merged.
---
 CLAUDE.md | 3 +++
 1 file changed, 3 insertions(+)

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`.