diff --git a/.claude/settings.json b/.claude/settings.json
index 1c4278213..aa02e6f88 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -1,5 +1,17 @@
 {
   "includeCoAuthoredBy": false,
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "printf 'Current cueckoo guidance-hash: %s\\n' \"$(cueckoo guidance --hash)\""
+          }
+        ]
+      }
+    ]
+  },
   "permissions": {
     "allow": [
       "Bash(go build:*)",
diff --git a/CLAUDE.md b/CLAUDE.md
index 8605949b6..cb3346141 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,7 +4,9 @@
 
 Use the cueckoo MCP server's `guidance` tool to get the latest common
 guidance for CUE project repos. The server is registered as the
-`cueckoo` MCP server (via `cueckoo mcp`). Follow all instructions
+`cueckoo` MCP server (via `cueckoo mcp`). The response includes a
+guidance-hash — if a later system-reminder reports a different hash,
+re-invoke the tool to pick up the changes. Follow all instructions
 returned by the `guidance` tool. See https://github.com/cue-lang/contrib-tools
 for more information on `cueckoo` and related tooling.