What problem does it solve? Managing multiple Git worktrees for parallel development often leads to orphaned folders, stale registrations, and inconsistent states between Git's records and the actual filesystem. This Skill provides a complete operational guide for creating, listing, cleaning, and diagnosing worktrees without triggering unwanted GitHub authentication. ## Core Features & Use Cases - Create Worktrees: Add new worktrees based on the current HEAD with story-based branch naming, supporting batch creation for multi-agent parallel scenarios. - Orphan and Ghost Detection: Compare git-registered worktrees against actual folders to identify orphans (folder exists, not registered) and ghosts (registered, folder missing). - Smart Cleanup: Automatically choose the correct removal method (git worktree remove, rm -rf, or git worktree prune) based on the detected state, plus bulk clean-all with a structured report. - Health Diagnosis: Check .gitignore coverage, orphan branches, disk usage, and uncommitted changes across all worktrees. - Use Case: You are running three parallel agents on stories ba-3, ba-6, and ba-9. Use this Skill to batch-create their worktrees, then later run clean-all to remove everything and verify only the main directory remains. ## Quick Start Ask the AI to create a new worktree named ba-3 and then list all worktrees to verify it was registered correctly.
