merge-reconciler

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

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

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, then applies the correct resolution strategy per hunk. - Impartiality Contract: Enforces strict rules — never favor the spawning side, touch only conflicted regions, and surface every design decision explicitly in the hand-back summary. - Kanban-Native Workflow: Integrates with hermes kanban cards so a third neutral profile can be assigned reconciliation tasks with both conflicted cards linked as parents. - Use Case: During a parallel-PR wave, two agents modify the same module and the merge halts. Spawn a neutral subagent with both branch names and intent summaries; it classifies each hunk, resolves conflicts, runs the build/tests, commits the merge, and reports every decision for human veto. ## Quick Start Ask the agent to act as a neutral reconciler for the halted merge in this repository, using the completion summaries from both conflicting branches, and follow the merge-reconciler procedure to produce a verified merge commit.

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 third-party 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, resolves accordingly, runs tests, and commits the merge.

How to handle merge conflicts in a multi-agent kanban pipeline?▼

Create a reconciliation kanban card assigned to a third profile, not either worker's profile, with both conflicted cards linked as parents. The parent links carry both completion summaries into the reconciler's context automatically.

When should I not use a neutral merge reconciler?▼

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 only for collisions between two distinct agents' branches.

Why do agents fail at resolving their own merge conflicts?▼

Agents resolving conflicts against a peer's work lack the peer's context and are structurally biased toward their own side, so they reliably overwrite the peer or abandon their own change. A neutral reconciler with both stated intents avoids this failure mode.

What happens when both sides of a conflict have equally valid intents?▼

If intents genuinely tie on a design question, the reconciler escalates by blocking the kanban card or reporting back rather than guessing. It never splits the difference into a hybrid neither side designed.