setup-worktrees

Create git worktrees for each ticket in a feature plan.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/nand1234/Agentic-workflow-builder --skill setup-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-worktrees
Source: https://github.com/nand1234/Agentic-workflow-builder/tree/main/ai-dev-worflow/.claude/skills/setup-worktrees
Command: npx skills add https://github.com/nand1234/Agentic-workflow-builder --skill setup-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates dedicated git worktrees for each ticket in a feature plan, enabling parallel development without cross-contamination and making it easy to work on multiple tickets locally.

Core Features & Use Cases

  • Deterministic worktree creation: generates a dedicated worktree per ticket off the CP branch.
  • Branch hygiene: ensures per-ticket branches are created in a controlled manner and worktrees are organized under .worktrees.
  • Use Case: When implementing multiple tickets in a single feature, automatically scaffold development contexts and avoid cross-talk.

Quick Start

Run the setup-worktrees skill after planning to scaffold worktrees for all planned tickets.

Frequently Asked Questions about setup-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate git worktree creation for multiple feature tickets?

Automating git worktree creation for multiple tickets is handled by scaffolding a dedicated worktree per ticket off a CP branch. This organizes parallel development contexts under a local .worktrees directory and prevents cross-contamination between features.

How does deterministic branch management work when setting up worktrees?

Deterministic branch management creates per-ticket branches exclusively off the CP branch using hard-coded rules. It strictly prevents creating branches off main or master and reports clear outcomes if any git operation fails during the worktree setup.

Can I use git worktrees to manage parallel development without branch cross-talk?

Yes, git worktrees isolate parallel development by generating a separate working directory for each ticket. Keeping ticket branches off the CP branch and organized locally prevents cross-talk and cross-contamination during feature implementation.

What is the best way to structure worktrees for a multi-ticket feature plan?

The best way to structure worktrees for a feature plan is to scaffold them locally under a .worktrees directory. Running the setup process after planning automatically generates these worktrees off the CP branch for consistent organization.

Does this worktree setup process prevent creating branches off main?

Yes, the worktree setup process enforces branch hygiene by applying hard rules to never create branches off main or master. It ensures per-ticket branches are only created in a controlled manner off the CP branch.

Why does my git worktree setup fail when branching off master?

Git worktree setup intentionally fails when branching off master because the process enforces hard rules against it. To maintain branch hygiene, per-ticket branches must be created off the CP branch instead of main or master.