merge-review

Analyze pending fleet worktree merge queue entries for file-level conflicts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mferris77/SpringBoard --skill merge-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: merge-review
Source: https://github.com/mferris77/SpringBoard/tree/main/vscode-citadel-harness/skills/merge-review
Command: npx skills add https://github.com/mferris77/SpringBoard --skill merge-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fleet agents produce worktrees that may overlap or conflict when merged back to main, creating risk of broken builds or lost changes. This Skill reads the merge-check queue, detects file-level overlaps and contradictory edits between branches, and provides actionable reconciliation guidance so maintainers can merge safely.

Core Features & Use Cases

  • Queue-driven review: Reads .planning/telemetry/merge-check-queue.jsonl and processes either the full queue or a single specified branch.
  • Conflict detection: Compares git diffs pairwise to identify overlapping files and classifies overlaps as additive, overlapping edits, or contradictory changes.
  • Risk assessment & ordering: Produces per-branch risk levels, detailed conflict pairs with recommended resolutions, and a proposed merge order while avoiding automatic merges.
  • Operational safety: Marks reviewed or merged entries in the queue, handles missing branches or worktrees gracefully, and escalates circular conflicts to the user.

Quick Start

Run the merge review across pending fleet worktrees by invoking /merge-review to generate a conflict report, recommendations, and an updated queue.

Frequently Asked Questions about merge-review

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

FAQPage Schema
How do I detect git merge conflicts across multiple worktree branches before merging?

To detect git merge conflicts across worktree branches, analyze the pending merge-check queue and compare git diffs pairwise to identify overlapping files, classifying them as additive, overlapping edits, or contradictory changes. This produces per-branch risk assessments and conflict pair reports without performing automatic merges.

What is a safe merge order for fleet agent worktrees with file-level overlaps?

A safe merge order for fleet worktrees is determined by analyzing file-level overlaps and contradictory edits between queued branches to propose a sequence that minimizes risk. The workflow reads queue entries, assesses per-branch risk levels, and outputs a recommended merge order to prevent broken builds.

Can I review a single branch from the merge-check queue instead of the full queue?

Yes, you can review a single specified branch from the merge-check queue instead of processing the full queue. The analysis reads the queue file and allows you to target individual branches, producing a specific conflict report and risk assessment while updating that entry's queue status.

How does queue-driven code review handle missing worktrees or circular conflicts?

Queue-driven code review handles missing worktrees or branches gracefully by skipping them without failing the process. When it encounters circular conflicts that cannot be automatically reconciled, it escalates the conflict report to the user for manual intervention rather than proceeding with an unsafe merge.

Do I need a specific queue file format to automate conflict resolution for my branches?

Yes, you need the .planning/telemetry/merge-check-queue.jsonl file format to automate conflict resolution. This queue file stores the pending fleet worktree merge entries that the analysis reads to detect file-level overlaps, classify edits, and produce reconciliation guidance.