github

name	github
description	GitHub patterns using gh CLI for pull requests, stacked PRs, code review, branching strategies, and repository automation. Use when working with GitHub PRs, merging strategies, or repository management tasks.
license	MIT
metadata	{"author":"Callstack","tags":"github, gh-cli, pull-request, stacked-pr, squash, rebase"}

GitHub Patterns

Tools

Use gh CLI for all GitHub operations. Prefer CLI over GitHub MCP servers for lower context usage.

Quick Commands

# Create a PR from the current branch
gh pr create --title "feat: add feature" --body "Description"

# Squash-merge a PR
gh pr merge <PR_NUMBER> --squash --title "feat: add feature (#<PR_NUMBER>)"

# View PR status and checks
gh pr status
gh pr checks <PR_NUMBER>

Stacked PR Workflow Summary

When merging a chain of stacked PRs (each targeting the previous branch):

1. Merge the first PR into main via squash merge
2. For each subsequent PR: rebase onto main, update base to main, then squash merge
3. On conflicts: stop and ask the user to resolve manually

# Rebase next PR's branch onto main, excluding already-merged commits
git rebase --onto origin/main <old-base-branch> <next-branch>
git push --force-with-lease origin <next-branch>
gh pr edit <N> --base main
gh pr merge <N> --squash --title "<PR title> (#N)"

See stacked-pr-workflow.md for full step-by-step details.

Quick Reference

File	Description
stacked-pr-workflow.md	Merge stacked PRs into main as individual squash commits

Problem → Skill Mapping

Problem	Start With
Merge stacked PRs cleanly	stacked-pr-workflow.md