branch-fix-strategy

Commit fixes on a feature branch and cherry-pick them to environment branches.

Updated Jan 30, 2026
One-click install
npx skills add https://github.com/takemi-ohama/ai-plugins --skill branch-fix-strategy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-fix-strategy
Source: https://github.com/takemi-ohama/ai-plugins/tree/main/plugins/ndf/skills/branch-fix-strategy
Command: npx skills add https://github.com/takemi-ohama/ai-plugins --skill branch-fix-strategy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Propagates fixes across multiple branches by committing on a feature branch and cherry-picking to environment branches, ensuring consistent changes across qa/staging/etc.

Core Features & Use Cases

  • Automates cross-branch fix propagation using a feature-branch-first commit followed by cherry-pick onto environment branches.
  • Enforces environment isolation by avoiding merges from environment branches back into feature branches and ensuring origin/main is up-to-date before finalizing changes.
  • Provides a repeatable workflow for PR creation and versioned suffix handling when environment branches require separate workstreams.

Quick Start

Execute the automated workflow to apply a fix from feature/xxx to qa/staging branches following the defined cherry-pick-pr process.

Frequently Asked Questions about branch-fix-strategy

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

FAQPage Schema
How do I cherry-pick a fix from a feature branch to multiple environment branches like qa and staging?

Propagating fixes across branches involves committing on a feature branch first, then cherry-picking that commit onto qa, staging, and other environment branches. This ensures consistent changes without manually duplicating commits across each branch.

What is the best way to apply the same git fix across qa, staging, and other environment branches?

The best way to apply a git fix across environment branches is committing on a feature branch and cherry-picking to short-lived environment branches. This maintains consistency and avoids the complexity of merging environment branches back into the feature branch.

Why should I avoid merging environment branches back into my feature branch?

Avoiding merges from environment branches back into a feature branch maintains environment isolation and prevents environment-specific code from polluting feature work. This keeps qa, staging, and feature development cleanly separated throughout the fix propagation process.

Do I need to merge origin/main before creating a PR for a cherry-picked fix?

Yes, the workflow enforces merging origin/main before PR creation to ensure the feature branch is up-to-date. This prevents merge conflicts and ensures the cherry-picked fix integrates cleanly with the latest codebase before finalizing the pull request.

How do I handle versioned suffixes when cherry-picking commits to separate environment workstreams?

When environment branches require separate workstreams, versioned suffix handling provides a repeatable workflow for tracking cherry-picked commits. This keeps fixes organized and traceable across qa, staging, and other branches without losing commit history.

Can I automate cross-branch fix propagation instead of manually cherry-picking to each environment branch?

Yes, cross-branch fix propagation can be automated by committing on a feature branch and running a cherry-pick workflow that applies the fix to environment branches. This reduces manual effort and ensures consistency across qa, staging, and other targets.