diff --git a/hive-claude/src/lib.rs b/hive-claude/src/lib.rs
index 40cde76a..8c5404c6 100644
--- a/hive-claude/src/lib.rs
+++ b/hive-claude/src/lib.rs
@@ -53,6 +53,9 @@
 //! }
 //! # }
 //! ```
+// The crate-level `//!` overview above is the rustdoc entry point — it belongs
+// in source, not docs/, so the comment-block length lint should not flag it.
+// lint:allow-long-comment
 
 mod classify;
 mod config;