shared-worktree

Create per-agent git worktrees to isolate code changes and prevent conflicts.

1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/feliperyba/ralph-orchestra --skill shared-worktree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shared-worktree
Source: https://github.com/feliperyba/ralph-orchestra/tree/main/.claude/skills/shared-worktree
Command: npx skills add https://github.com/feliperyba/ralph-orchestra --skill shared-worktree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git worktrees enable isolated development contexts so Developer and Tech Artist can work in parallel without stepping on each other's changes. This skill provides a clear workflow for creating and using per-agent worktrees to avoid merge conflicts and improve traceability.

Core Features & Use Cases

  • Initial Setup: Create agent-specific worktrees and configure the corresponding branches.
  • Daily Workflow: Stage all edits within the designated worktree, validate against the main branch, and prepare for merging.
  • Coordination: Enforce the {agent}-worktree naming convention and provide guidance for synchronized validation and merging.

Quick Start

Create your agent worktree using the prescribed naming convention and begin development in that dedicated directory.

Frequently Asked Questions about shared-worktree

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

FAQPage Schema
How do I use git worktrees for parallel development without causing merge conflicts?

Git worktrees isolate code changes in per-agent directories to prevent cross-agent conflicts during parallel development. Each agent works in a dedicated worktree and coordinates merging at checkpoints to maintain isolation and traceability.

What is the naming convention required for setting up agent-specific git worktrees?

Agent-specific git worktrees require the {agent}-worktree naming convention to maintain isolation and traceability. Correct worktree naming ensures coordinated merging at checkpoints and prevents cross-agent conflicts during parallel development workflows.

How do I merge code changes from separate git worktrees into the main branch?

To merge code changes from separate git worktrees, stage edits within the designated worktree, validate against the main branch, and coordinate merging at checkpoints. This synchronized workflow prevents cross-agent conflicts and preserves traceability.

Can I run multiple agents modifying shared code in parallel without them overwriting each other?

Yes, multiple agents can modify shared code in parallel without overwriting each other by using isolated git worktrees. This workflow prevents cross-agent conflicts by keeping iterative changes in separate per-agent directories until checkpoint merging.

Do I need a configured Git repository to start an agent workflow with isolated worktrees?

Yes, a configured Git repository is required to start an agent workflow with isolated worktrees. The repository provides the necessary branching structure to enforce the {agent}-worktree naming convention and coordinate synchronized merges at checkpoints.

What are the limitations of using git worktrees for parallel agent development?

Git worktrees for parallel agent development require strict adherence to workflow rules and the {agent}-worktree naming convention to maintain isolation. Without synchronized validation and coordination at checkpoints, traceability and cross-agent conflict prevention can break down.