diff --git a/docs/FRICTION.md b/docs/FRICTION.md
index b8d58ca..76e74f9 100644
--- a/docs/FRICTION.md
+++ b/docs/FRICTION.md
@@ -35,3 +35,7 @@ earning its keep.
 - `[friction]` Long sessions: I make a batch of edits but can't commit until you
   `rbw unlock`. The 5h timeout + pre-flight check address the symptom; watch whether
   it still bites.
+- `[gotcha]` Hooks (or any new `.claude/settings.json`) added mid-session don't
+  activate until a Claude Code **restart** — the settings watcher only tracks settings
+  files that existed at session start. Opening `/hooks` and dismissing did *not* load
+  them. → Fresh sessions load them normally; restart after adding hooks.