merge-reconciler

Resolves git merge conflicts between two agent branches as a neutral third party.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill merge-reconciler-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: merge-reconciler
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/autonomous-ai-agents/merge-reconciler
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill merge-reconciler-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When two AI agents working in parallel produce conflicting git branches, neither agent can fairly resolve the conflict — each lacks the peer's context and is biased toward its own changes, leading to overwritten work or abandoned features. This Skill provides an impartial reconciliation procedure that merges both sides based on their stated intents. ## Core Features & Use Cases - Hunk Classification: Categorizes every conflicted hunk as disjoint-intent, same-question-different-answer, or superseded, with per-hunk rationale. - Impartiality Contract: Enforces rules against self-favoring, drive-by edits, and splitting the difference on design decisions. - Kanban Integration: Supports spawning a neutral third-profile reconciler agent via kanban cards linked to both conflicted tasks. - Use Case: During a parallel-PR campaign, two agents modify the same module and the merge halts. Spawn a reconciler subagent with both branch names and intent summaries; it classifies each hunk, merges disjoint changes, picks one answer per design collision, verifies with the build, and hands back a summary listing every decision. ## Quick Start Ask the agent to act as a neutral merge reconciler for the halted merge in this repo, using the completion summaries from both conflicted branches to classify and resolve each conflicted hunk.

Frequently Asked Questions about merge-reconciler

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

FAQPage Schema
How do I resolve git merge conflicts between two AI agent branches?▼

Spawn a neutral reconciler agent with the repo path, both branch names, and both sides' intent summaries. It classifies each conflicted hunk as disjoint-intent, same-question-different-answer, or superseded, then merges accordingly and verifies with the project build.

Why shouldn't an agent resolve conflicts against another agent's work?▼

Agents lack the peer's context and are biased toward their own changes, so they reliably either overwrite the peer's work or abandon their own. A neutral third-party reconciler with both stated intents produces a fair merged result.

When should I not use a merge reconciliation workflow?▼

Do not use it for conflicts within a single agent's own work or for trivial lockfile and generated-file conflicts, which should simply be regenerated. It is designed for genuine collisions between two agents' parallel branches.

What information does a merge reconciler need to work?▼

It needs a repo checkout with the halted merge or both branch names, plus both sides' intent sources such as kanban completion summaries, PR bodies, or commit messages, and the project's build or test command for verification.

How are design decisions handled during agent merge reconciliation?▼

When both sides answered one design question differently, the reconciler picks the answer that best serves the stated intents rather than splitting the difference. Every such decision is explicitly surfaced in the hand-back summary so a human can veto it.