integration-branch

Create a disposable integration branch and merge the testing branch to surface conflicts.

Updated Sep 3, 2025
One-click install
npx skills add https://github.com/DominionZA2/claude-config --skill integration-branch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-branch
Source: https://github.com/DominionZA2/claude-config/tree/main/skills/integration-branch
Command: npx skills add https://github.com/DominionZA2/claude-config --skill integration-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a throwaway integration branch off the current feature/hotfix branch, merge the testing branch into it, and surface conflicts for resolution — without polluting the original branch. Auto-detects GitHub (staging) vs Bitbucket (develop) from the remote URL.

Core Features & Use Cases

  • Creates a disposable integration branch (dev/<suffix>) off the source branch to isolate integration work.
  • Merges the testing branch into the integration branch and surfaces conflicts for manual resolution with prompts and guided steps.
  • Detects host (GitHub vs Bitbucket) from the remote URL to choose the correct testing branch and preserves the source branch clean for final PRs.

Quick Start

Use the integration-branch skill to create an integration branch, merge the testing branch, and surface conflicts for resolution without touching the original feature/hotfix branch.

Frequently Asked Questions about integration-branch

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

FAQPage Schema
How do I test merge conflicts without polluting my feature branch?

To test merge conflicts safely, you can create a disposable integration branch off your feature branch. This isolates the merge process and surfaces conflicts for resolution without touching or polluting the original source branch.

How do I automate integration branch creation and merge testing?

You can automate integration branch creation by using a skill that creates a branch off your feature or hotfix branch and merges the testing branch into it. It auto-detects your host to select the correct target and runs build verification.

Does the integration branch workflow work with both GitHub and Bitbucket?

Yes, the workflow works with both GitHub and Bitbucket. It auto-detects the host platform from the remote URL, automatically selecting the staging branch for GitHub or the develop branch for Bitbucket to merge into.

What is the best way to surface merge conflicts before a pull request?

The best way to surface merge conflicts before a pull request is to merge the testing branch into a disposable integration branch. This guides you through conflict resolution with prompts while keeping your original branch clean for final PRs.

Can I push changes directly from my source branch during conflict resolution?

No, you cannot push changes directly from the source branch. The workflow enforces safety constraints by preventing pushes from the source branch, avoiding forced updates, and requiring user approval before applying conflict resolution or pushing.

Why should I use a disposable branch for merge conflict resolution?

You should use a disposable branch for merge conflict resolution to keep your original feature or hotfix branch clean for final pull requests. It isolates integration work, runs build verification, and discards the branch after conflict resolution.