branch-merge

Merge jj bookmarks or git branches into main with rebase and CI checks.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Cognitivemesh/pyarnes --skill branch-merge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-merge
Source: https://github.com/Cognitivemesh/pyarnes/tree/main/template/.claude/skills/branch-merge
Command: npx skills add https://github.com/Cognitivemesh/pyarnes --skill branch-merge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Merges can be error-prone and time-consuming when coordinating feature branches and jj bookmarks with main. This skill automates a safe, deterministic merge flow that preserves working state, validates changes via pre-merge CI, and updates specs accordingly.

Core Features & Use Cases

  • Safe merge of jj bookmarks or git branches into main with automatic rebase when needed.
  • Pre-merge CI validation and optional browser/test gates to ensure code health.
  • Post-merge spec updates, archiving, and INDEX/Tier updates to reflect merged work.

Quick Start

Run the safe-merge.sh script with the source ref to merge into main and observe pre-merge validation and post-merge specs.

Frequently Asked Questions about branch-merge

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

FAQPage Schema
How do I safely merge jj bookmarks into a git main branch?

To safely merge jj bookmarks into a git main branch, this skill automates a deterministic flow with status checks, rebase-forward logic, and a git fallback. It preserves working state while validating changes.

What is the best way to automate pre-merge CI validation for feature branches?

Automating pre-merge CI validation requires enforcing deterministic checks before integration. This skill applies pre-merge CI validation and optional test gates to ensure code health before safely merging feature branches into main.

Does this merge automation handle uncommitted work during a rebase?

Yes, this merge automation handles uncommitted work during a rebase by preserving your working state. It enforces a deterministic flow through status checks and rebase-forward logic to prevent data loss.

Can I update specs and archive branches automatically after a git merge?

Yes, you can update specs and archive branches automatically after a git merge. This skill handles post-merge spec updates, archiving, and INDEX/Tier updates to keep branches and specs synchronized.

When should I use a git fallback for branch merging instead of jujutsu?

You should use a git fallback for branch merging when operating outside jj-managed repositories. This skill applies across both jj-managed repositories and standard Git workflows to ensure safe merges.