🔧Tool Prompts/git
Enter Worktree Tool
src/tools/EnterWorktreeTool/prompt.ts
Prompt Engineering Insight
Strict gating on the word 'worktree' to avoid conflating with normal branch workflows; documents hook-based path for non-git VCS.
Techniques Used
behavioral-constraintsnegative-examplesscope-limitingtool-use-guidance
prompt
Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
When to Use
- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
When NOT to Use
- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
- Never use this tool unless the user explicitly mentions "worktree"
Requirements
- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
- Must not already be in a worktree
Behavior
- In a git repository: creates a new git worktree inside
.claude/worktrees/with a new branch based on HEAD - Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
- Switches the session's working directory to the new worktree
- Use ExitWorktree to leave the worktree mid-session (keep or remove). On session exit, if still in the worktree, the user will be prompted to keep or remove it
Parameters
name(optional): A name for the worktree. If not provided, a random name is generated.
Tags
gitworktreeisolation