Plan Worktree Skill

Extract implementation stages from plans and create git worktrees.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/grumps/claude-dotfiles --skill plan-worktree-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Plan Worktree Skill
Source: https://github.com/grumps/claude-dotfiles/tree/main/skills/plan-worktree
Command: npx skills add https://github.com/grumps/claude-dotfiles --skill plan-worktree-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing complex features often involves multiple, interdependent stages. This skill helps developers break down large plans into manageable, isolated Git worktrees, enabling parallel development and reducing merge conflicts. It streamlines the process of setting up and managing these isolated environments.

Core Features & Use Cases

  • Stage-based Worktree Creation: Automatically create separate Git worktrees and branches for each stage of an implementation plan, based on structured plan metadata.
  • Plan-driven Workflow: Link the original plan directly into each worktree, ensuring developers always have context and can track stage dependencies.
  • Status Tracking & Cleanup: Easily view the status of all plan stages and their associated worktrees, and remove them once stages are complete.
  • Use Case: You're building a new feature with 3 distinct stages (e.g., API, UI, Database). Use this skill to set up 3 separate worktrees, allowing you to work on each stage in isolation or even assign different stages to team members, accelerating development without messy branches.

Quick Start

Ask Claude to "Set up worktrees for the plan located at .claude/plans/2025-11-17-my-feature.md."

Frequently Asked Questions about Plan Worktree Skill

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

FAQPage Schema
How do I set up parallel development with Git worktrees for multi-stage features?

Git worktrees enable parallel development by creating isolated working directories for each stage of your implementation plan. This Skill automatically extracts stages from a structured plan file and creates separate worktrees and branches for each stage, letting you work on multiple stages simultaneously without merge conflicts.

What's the best way to organize a feature plan for worktree creation?

Structure your plan as a stage-based template with a JSON metadata block that defines each implementation stage and its dependencies. This Skill reads that metadata to validate the plan structure and automatically generate worktrees, branches, and symlinks for each stage in dependency order.

Can I use Git worktrees to assign different development stages to team members?

Yes. This Skill creates isolated worktrees for each stage of your plan, allowing different team members to work on separate stages concurrently. Each worktree includes a symlink to the original plan, so developers maintain context and can track cross-stage dependencies while working independently.

How do I track dependencies between stages when using multiple worktrees?

This Skill maintains stage dependency order as defined in your plan's JSON metadata block. It creates worktrees and branches respecting those dependencies, and symlinks the plan into each worktree so developers can reference upstream stages and understand blockers before proceeding.

What do I need to do after completing individual stages in separate worktrees?

After finishing each stage in its isolated worktree, you can view status across all plan stages and remove completed worktrees using this Skill. Changes in each worktree remain on their respective branches and can be merged back into the main branch once dependencies are satisfied.