From b676cd4a3b97e45b8a3ae66fcc2f033ce48f1b66 Mon Sep 17 00:00:00 2001 From: iris Date: Sun, 30 Aug 2026 13:54:40 +0200 Subject: [PATCH 1/3] 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`. From c79b191b4f6aa4704fc111137dab68f3505371ef Mon Sep 17 00:00:00 2001 From: iris Date: Sun, 30 Aug 2026 14:09:27 +0200 Subject: [PATCH 2/3] CLAUDE.md: drop the hive-specific /knowledge link mara: hyperhive isn't tied to one hive/swarm's knowledge repo. --- CLAUDE.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 02402f05..400e2014 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -278,5 +278,6 @@ The docs below own the details — this section just points at them. 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`. + is, not to how much investigation it took to find it. (Fuller guidance + lives in this hive's own knowledge base, not this repo — hyperhive + isn't tied to one hive/swarm's `/knowledge` mount.) From 5593fa76bb698b53e34aae38f1ffd2095f2bbc4c Mon Sep 17 00:00:00 2001 From: iris Date: Sun, 30 Aug 2026 14:19:52 +0200 Subject: [PATCH 3/3] CLAUDE.md: cut the meta-commentary, just state the rule mara: 'you did what the docs are trying to get rid of.' The prior edit explained where the fuller guidance lives instead of just being the two-sentence essence itself. --- CLAUDE.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 400e2014..66f1b934 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -277,7 +277,7 @@ 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. (Fuller guidance - lives in this hive's own knowledge base, not this repo — hyperhive - isn't tied to one hive/swarm's `/knowledge` mount.) +- **Comment/PR-description length**: size it to how non-obvious the + thing is, not to how much investigation it took to find it — a + mechanical fix gets a one-line comment, a genuinely non-obvious + invariant or decision earns real prose.