merging-worktrees

Merge parallel worktrees into a unified branch with 3-way conflict resolution.

8|5|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/axiomantic/spellbook --skill merging-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: merging-worktrees
Source: https://github.com/axiomantic/spellbook/tree/main/skills/merging-worktrees
Command: npx skills add https://github.com/axiomantic/spellbook --skill merging-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidate parallel worktrees into a single, coherent branch without feature loss or regressions.

Core Features & Use Cases

  • 3-way conflict analysis and resolution to protect contracts
  • Dependency-aware merge ordering to prevent cascading failures
  • Post-merge verification and cleanup to ensure a stable unified branch

Quick Start

Provide the base_branch and the list of worktrees, then execute the merge workflow to produce a unified branch.

Frequently Asked Questions about merging-worktrees

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

FAQPage Schema
How do I merge parallel git worktrees into one branch without losing features?

To merge parallel git worktrees safely, you need a 3-way merge integration process that consolidates concurrent branches into a single, feature-complete branch. This ensures dependency-aware merge ordering and verifies interface contracts remain intact.

What is 3-way conflict analysis for branch management?

3-way conflict analysis for branch management examines the base branch and two diverging worktrees to resolve conflicts while protecting explicit interface contracts. It prevents feature loss during multi-team consolidation by analyzing the three distinct branch states.

How to consolidate multiple worktrees using dependency-aware merge ordering?

Consolidate multiple worktrees by applying dependency-aware merge ordering, which sequences branch integrations based on their dependencies to prevent cascading failures. You provide a base branch and a list of worktrees to execute the merge workflow.

Can I use this worktree merge workflow for multi-team version control environments?

Yes, this worktree merge workflow is specifically designed for multi-team version control environments where multiple worktrees evolve concurrently. It enforces mandatory tests after each merge round and produces detailed merge logs for team tracking.

What are the limitations of merging worktrees with concurrent branch updates?

Merging worktrees with concurrent branch updates requires explicit interface contracts and mandatory testing after each round to prevent regressions. The process is limited by the need for dependency-aware ordering to avoid cascading failures during consolidation.