Worktree Manager Skill

Complete worktree lifecycle management for parallel development environments with isolated ports, databases, and configuration.

When to use this skill

Use this skill when the user wants to:

• Create a new worktree for parallel development
• Remove an existing worktree
• List all worktrees and their status
• Check worktree configuration or status
• Manage multiple parallel development environments

Do NOT use this skill when:

• User asks for a specific subagent or skill delegation
• User wants to manually use git commands directly
• The task is unrelated to worktree management

Operations Overview

This skill manages three core worktree operations:

Decision Tree: Which Command to Use

1. User wants to CREATE a worktree

Keywords: create, new, setup, make, build, start, initialize Action: Use /git-simple:createworktreeprompt <branch-name>

2. User wants to LIST worktrees

Keywords: list, show, display, what, which, status, check, view Action: Use /git-simple:listworktreesprompt

3. User wants to REMOVE a worktree

Keywords: remove, delete, cleanup, destroy, stop, kill, terminate Action: Use /git-simple:removeworktreeprompt <branch-name>

Quick Start

For step-by-step operation instructions, see [OPERATIONS.md](OPERATIONS.md).

For detailed examples and usage patterns, see [EXAMPLES.md](EXAMPLES.md).

For troubleshooting and common issues, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).

For technical details and quick reference, see [REFERENCE.md](REFERENCE.md).

Important Notes

Do NOT attempt to:

• Create worktrees manually with git commands
• Manually configure ports or environment files
• Use bash to remove directories directly
• Manage worktree processes manually

Always use the slash commands because they:

• Handle all configuration automatically
• Ensure port uniqueness
• Validate operations
• Provide comprehensive error handling
• Clean up properly on removal