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.