diff --git a/.gitignore b/.gitignore
index 4188f0d..adce806 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,8 +1,9 @@
 # Dependencies
 node_modules/
 
-# Git worktrees
-.worktrees/
+# Git worktrees — Claude Code's native worktree tool writes here; this is the
+# canonical location (gitignored). Narrow ignore: the rest of .claude/ stays tracked.
+.claude/worktrees/
 
 # Docusaurus
 build/
diff --git a/CLAUDE.md b/CLAUDE.md
index 7722d7e..8a74488 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -34,6 +34,10 @@ pnpm lint         # Linting
 5. Use conventional commits: `feat:`, `fix:`, `docs:`, `chore:`
 6. Prefer incremental commits over amending
 
+## Worktrees
+
+Use **`.claude/worktrees/`** for git worktrees — this is the canonical location across all trakrf repos. Claude Code's native worktree tool (`EnterWorktree`) writes there and cannot be redirected, so the convention matches the tool rather than fighting it. The directory is gitignored (narrowly — the rest of `.claude/` stays tracked). Do not reintroduce a root-level `.worktrees/` or a symlink bridge.
+
 ## Style & Conventions
 
 - **TypeScript** for any config or custom components