github-merge-stack

name	github-merge-stack
description	Merge stacked feature branches from Ralph into main, preserving full feature history. Handles PR base updates, sequential squash merges, and branch cleanup.
argument-hint	[--dry-run] [--no-cleanup]
allowed-tools	Bash, Read

Purpose

After Ralph completes with RALPH_CREATE_PR=true, merge all stacked PRs into main while preserving visibility of when and why each feature was implemented.

Arguments

• --dry-run — Show what would be merged without making changes
• --no-cleanup — Skip local branch cleanup after merging

Prerequisites

• gh CLI authenticated (gh auth status)
• On a branch in the repo with open PRs
• PRs created by Ralph with stacked branches

Template

The merge logic is implemented in templates/merge-stack.sh. This script can be:

1. Run directly from the skill's templates folder
2. Copied to a project's scripts/ directory for convenience

Workflow

1. Copy Script to Project (Optional)

cp /path/to/skills/shared/github-merge-stack/templates/github-merge-stack.sh scripts/
 +x scripts/github-merge-stack.sh