project-orchestrator:worktree

Create and manage isolated git worktrees for parallel plan execution.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/GigaFyde/project-orchestrator --skill project-orchestrator-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-orchestrator:worktree
Source: https://github.com/GigaFyde/project-orchestrator/tree/main/skills/worktree
Command: npx skills add https://github.com/GigaFyde/project-orchestrator --skill project-orchestrator-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates and manages isolated git worktrees to run multiple plan implementations in parallel, preventing file collisions in both single-repo (monorepo) and multi-repo (polyrepo) setups.

Core Features & Use Cases

  • Isolates each plan by mapping a plan slug to a dedicated worktree, enabling concurrent work.
  • Auto-detects repository structure (monorepo or polyrepo), and runs per-service setup in the appropriate worktree.
  • Validates worktree health, updates the living state document with created paths, and returns the results to the caller.

Quick Start

Create a worktree for a given plan slug to isolate parallel plan implementations.

Frequently Asked Questions about project-orchestrator:worktree

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

FAQPage Schema
How do I isolate parallel plan implementations in a git monorepo without file conflicts?

Git worktrees isolate parallel plan implementations by mapping each plan slug to a dedicated working directory, preventing file collisions. The system auto-detects monorepo or polyrepo setups and runs per-service configuration in each isolated branch.

Can I use git worktrees to run parallel plans across a polyrepo setup?

Yes, git worktrees support polyrepo setups by auto-detecting the repository structure and running per-service setup in the appropriate isolated worktree. This enables concurrent plan execution across multiple repositories without file collisions.

How do I manage worktree creation failures and validate branch health?

To manage worktree creation failures, the system validates branches explicitly and handles creation failures directly. It checks worktree health, updates the living state document with created paths, and returns the final worktree paths to the caller.

What is the best way to track created worktree paths for parallel plan execution?

The best way to track created worktree paths is by updating a living state document. The system records all created worktree paths in this design doc, ensuring isolated parallel plans remain synchronized and traceable throughout execution.

Does setting up isolated git worktrees require manual per-service configuration?

No, setting up isolated git worktrees does not require manual per-service configuration. The system auto-detects the repository structure and automatically applies the necessary per-service setup within the appropriate worktree.