diff --git a/CLAUDE.md b/CLAUDE.md
index 6da66e31..b88d9d3b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -38,11 +38,9 @@ hand-maintained per-file tree drifts out of sync with the code.
   and the axum operator dashboard (`dashboard.rs`). Largest crate.
 - **`hivectl/`** — standalone operator CLI (`hivectl` binary). Talks to
   the `hive-c0re` daemon over the host admin socket (`hive-host-sock`
-  wire types) — does NOT link `hive-c0re`. Verbs: `list-agents`,
-  `agent <name> <start|create|request-create|stop|kill|destroy|rebuild|
-  restart|set-parent|choom|watch|…>`, `approvals <pending|approve|deny>`,
-  `forge`/`matrix`/`github`/`gateway` provisioning, `stop`/`start`,
-  `wg`/`peer-config`.
+  wire types) — does NOT link `hive-c0re`. Full, always-current verb
+  reference (CI-enforced against the clap tree, see `docs/conventions.md`):
+  [`docs/tools/hivectl-cli.md`](docs/tools/hivectl-cli.md).
 - **`hive-agent/`**, **`hive-agent-mcp/`** —
   in-container harness, two sibling crates for every agent (not a
   single `hive-ag3nt/` dir — that's the runtime/binary-family nickname,