diff --git a/.gitignore b/.gitignore
index 694c9dc679..9023b5fbe6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -126,4 +126,6 @@ examples/app-crm/storage/
 
 # Local agent tooling
 .codex/
-.claude/worktrees/
\ No newline at end of file
+.claude/worktrees/
+# an agent worktree is git plumbing, never repo content: a `.git` FILE reading `gitdir:` plus a whole second checkout
+.worktrees/