GitHub Stacked PRs

Stacked PRs를 통해 큰 변경을 여러 개의 작은 pull request로 나눠, 서로를 기반으로 쌓아 올린 뒤 한 번에 병합할 수 있다.

핵심은 각 PR이 독립적으로 리뷰 가능하면서도 전체 변경은 하나의 흐름으로 이어지게 만드는 것이다. GitHub는 이를 native support로 제공하며, gh stack CLI로 로컬 작업까지 연결한다.

주요 기능은 다음과 같다.

• Stack map: GitHub PR UI에서 스택 구조를 한눈에 보고 레이어 간 이동이 가능하다.
• Cascading rebase: 스택 전체에 대해 한 번의 리베이스로 연쇄 반영할 수 있다.
• 병합 유연성: 스택의 일부만 먼저 병합할 수도 있고, merge queue도 사용할 수 있다.
• 브랜치 보호 규칙: 직접 base가 아니라 최종 target branch 기준으로 적용된다.
• CI 동작: 스택의 각 PR은 최종 브랜치를 대상으로 하는 것처럼 CI가 실행된다.

gh stack CLI는 선택 사항이다. UI, API, 일반 Git 워크플로만으로도 스택을 만들고 관리할 수 있으며, CLI를 쓰면 브랜치 생성, 리베이스, push, PR 생성까지 더 매끄럽게 처리한다.

사용 흐름은 대략 다음과 같다.

• gh extension install github/gh-stack로 설치
• gh stack alias로 gh stack을 gs로 별칭 설정
• gs init, gs add로 스택의 각 레이어 생성
• gs push로 모든 브랜치 push
• gs submit으로 스택 PR을 열기

GitHub는 이 기능이 private preview 상태라고 밝히며, waitlist 신청을 안내하고 있다.