What problem does it solve? Working on multiple branches in a single checkout forces constant stashing, context switching, and risks mixing unrelated changes. This Skill keeps every branch in its own isolated worktree under a predictable mirrored path, so implementation work never touches the primary checkout. ## Core Features & Use Cases - Predictable mirrored layout: Source checkouts live under ~/git/<provider>/<user>/<repo> and branch worktrees mirror them at ~/worktree/<provider>/<user>/<repo>/<branch-name>, so every checkout is easy to find. - Guarded lifecycle script: The bundled worktree-lifecycle.sh synchronizes clean worktrees with their upstream, removes only merged and clean worktrees, and refuses to touch dirty, detached, or non-mirrored checkouts. - Automated merge cleanup: An opt-in post-merge hook runs the same guarded cleanup after local merges or pulls, removing merged branches without deleting remote branches. - Use Case: You are asked to implement a feature on branch feature/add-search. The Skill derives the target path, creates the worktree from the source checkout, verifies the branch and status, and performs all edits there while the primary checkout stays untouched. ## Quick Start Ask the agent to implement the requested change in a new worktree for a named branch and it will create, verify, and work inside the mirrored checkout.
