Worktree Flow

Decide when and how to use git worktrees for isolated parallel work

LucasSantana-Dev Updated 1 repo stars

File contents

Worktree Flow

Decide whether a task deserves an isolated git worktree, create it with a proper branch name, and keep the original checkout clean.

Steps

  1. Evaluate isolation need — does this task risk conflicting with current work?
  2. Choose branch name — use feature/, fix/, chore/, or refactor/ prefix
  3. Create worktree — git worktree add ../<repo>-<branch> -b <branch>
  4. Report — branch name, worktree path, isolation reason

Output

Branch:    <prefix/short-name>
Path:      ../<repo>-<branch>
Reason:    <why isolation was needed>

Rules

  • Stop if the directory is not a git repo
  • Never create throwaway branches without a clear reason
  • Prefer worktrees over stashing for multi-day parallel work
  • Keep the original checkout on its current branch

LucasSantana-Dev/ai-dev-toolkit-library/tree/main/catalog/skills/adt-worktree-flow commit 7438791c57

Frequently asked questions

npx skillmds@latest add lucassantana-dev/worktree-flow