diff --git a/packages/opencode/src/tool/enter-worktree.txt b/packages/opencode/src/tool/enter-worktree.txt
index bf4a28e76..8cce1d75c 100644
--- a/packages/opencode/src/tool/enter-worktree.txt
+++ b/packages/opencode/src/tool/enter-worktree.txt
@@ -1,5 +1,11 @@
 Bind this session to a git worktree. Once entered, every subsequent tool call resolves relative paths from inside the worktree until ExitWorktree is called.
 
+Use this tool whenever the user asks to create, start, enter, open, or switch the session to a worktree.
+
+This is the authoritative PawWork mechanism for session worktrees. Prefer it over skill-based worktree workflows and over shell-based `git worktree` commands, because only this tool binds the session execution context and makes subsequent tool calls resolve inside the worktree.
+
+Do not invoke a worktree skill first when this tool directly satisfies the user's request.
+
 Use only when the user explicitly asks for worktree usage, or project instructions require it.
 
 Modes: