diff --git a/README.md b/README.md
index a1a9921..35be5fe 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,7 @@ AI/
 └── preferences/
     ├── articles.md                    # Blog post writing guide for chns.tech (Hugo/Markdown)
     ├── communication.md               # How I like responses structured and how to interact
+    ├── hooks-setup.md                 # Required Claude Code hooks and setup instructions
     ├── powershell-wpf.md              # Standards for PowerShell and WPF applications
     ├── python-web.md                  # Standards for FastAPI, SQLAlchemy, Docker Compose
     └── project-structure.md           # Standard folder layouts per project type
@@ -117,6 +118,8 @@ Copy-Item "CLAUDE.md" "$env:USERPROFILE\.claude\CLAUDE.md" -Force
 Copy-Item -Path "preferences" -Destination "$env:USERPROFILE\.claude\preferences" -Recurse -Force
 ```
 
+> **Hooks are not synced automatically.** `~/.claude/settings.json` is machine-local and not part of this repo. After syncing preferences on a new machine, set up hooks by telling Claude Code: *"Read preferences/hooks-setup.md and configure my ~/.claude/settings.json with the required hooks."*
+
 - If you've **copied** `CLAUDE.md` into other project repos, re-copy the updated version to those projects
 - If you're using **ChatGPT/Claude.ai** manually, you'll be pasting the updated file next time