worktree-setup

Create isolated Git worktrees for feature branches in PACT workflows.

71|14|Updated Jun 26, 2025
One-click install
npx skills add https://github.com/ProfSynapse/PACT-Plugin --skill worktree-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-setup
Source: https://github.com/ProfSynapse/PACT-Plugin/tree/main/pact-plugin/skills/worktree-setup
Command: npx skills add https://github.com/ProfSynapse/PACT-Plugin --skill worktree-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides isolated git worktrees for feature branches so multiple features or sub-scopes can run in parallel without interfering with each other.

Core Features & Use Cases

  • Create an isolated worktree for a feature branch to enable parallel development with filesystem isolation.
  • Reuse an existing worktree when applicable and prune stale worktrees as needed.
  • Ensure the repository is configured correctly by placing .worktrees in the gitignore and reporting the final path to subsequent steps.

Quick Start

Start a new feature worktree by running: git worktree add "$REPO_ROOT/.worktrees/{branch}" -b {branch}.

Frequently Asked Questions about worktree-setup

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

FAQPage Schema
How do I isolate feature branches with git worktrees for parallel workflows?

Git worktrees isolate feature branches by creating separate working directories, allowing parallel feature development without filesystem interference. This skill automates worktree creation, handles reuse of existing worktrees, and safely falls back if directory issues arise.

When do I need git worktrees during PACT orchestrate and compact phases?

Git worktrees are needed during PACT orchestrate and compact phases to maintain strict filesystem isolation for each feature branch. This skill automates worktree setup for these phases, ensuring parallel sub-scope execution does not overwrite or conflict with your main repository state.

Can I reuse an existing git worktree if one is already set up for my branch?

Yes, you can reuse an existing git worktree. This skill checks for current worktrees and reuses the applicable directory instead of duplicating, while pruning stale worktree references to keep your repository configuration clean and accurate.

Does setting up isolated git worktrees require any external dependencies?

Setting up isolated git worktrees requires no external dependencies beyond standard Git tooling. This skill validates your repository structure, such as checking for the .worktrees directory, and automatically configures your gitignore to ensure worktrees are properly excluded from version tracking.

What is the best way to manage multiple isolated feature branches in a single repository?

The best way to manage multiple isolated feature branches is using dedicated git worktrees. This skill automates the creation of a .worktrees directory, provides filesystem isolation for each branch, and reports the final path so you can immediately begin parallel development.