worktree-setup

Create isolated git worktrees with feature branches for PACT workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create an isolated git worktree with a feature branch for PACT workflows. This provides filesystem isolation so multiple features or sub-scopes can run in parallel without interference.

Core Features & Use Cases

  • Isolate workspaces for new features or orchestrator flows (or comPACT).
  • Prevent cross-feature interference by using dedicated .worktrees/, ensuring clean separation for ATOMIZE or manual isolation of a feature branch.
  • Return a ready-to-use path and branch information for subsequent steps in the workflow.

Quick Start

Create a new worktree for the feature branch and report its path.

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 for parallel git workflows?

You isolate feature branches for parallel git workflows by creating dedicated git worktrees under a .worktrees directory, providing filesystem isolation so multiple features run without interference.

Why use git worktrees to prevent cross-feature interference?

Git worktrees prevent cross-feature interference by providing separate filesystem paths for each feature branch, allowing parallel development to run cleanly without overlapping uncommitted changes.

Can I reuse an existing worktree if one is already set up?

Yes, the orchestration logic robustly handles existing worktrees by reusing them instead of creating duplicates, returning the ready-to-use path and branch information with clear error messages.

Does git worktree isolation work for PACT orchestration flows?

Yes, git worktree isolation supports PACT orchestration flows, including comPACT and ATOMIZE sub-scopes, by generating isolated workspaces that prevent concurrent processes from conflicting.

What is the best way to manage multiple feature branches simultaneously?

The best way to manage multiple feature branches simultaneously is creating isolated git worktrees, which allows each feature to operate in a dedicated directory and returns a ready-to-use path for subsequent workflow steps.