new-feature-branch

What problem does it solve?

Creating a new feature branch can accidentally start from stale local state, modify the main checkout, or leave untracked worktrees that clutter the repository. This Skill ensures new work begins from the latest remote main/master in an isolated worktree so the primary checkout remains untouched and safe.

Core Features & Use Cases

• Repo layout detection: Detects normal working trees versus bare repositories and adapts git invocations accordingly.
• Safe branching workflow: Fetches the remote default branch, updates the local reference, checks for uncommitted changes (skip for bare repos), and prevents branching from dirty worktrees.
• Isolated worktrees: Creates branches as worktrees under $PROJECT_ROOT/.worktrees, ensures the directory exists and is ignored in normal repos, and changes the working directory into the new worktree.
• Use Case: Ideal when starting a new feature, bugfix, or experimental change where you want an isolated, up-to-date branch without touching the main checkout.

Quick Start

Create a new feature worktree named feature/auth-flow from the latest main and switch into it.