메타데이터
- 발신자: TLDR
- 원문 URL: https://github.blog/changelog/2026-07-30-stacked-pull-requests-are-now-in-public-preview/
- 발행일: 2026-07-31
- 카테고리: dev-engineering
직역 전문
스택 pull request(Stacked Pull Requests)는 큰 변경 사항을 작고 리뷰하기 쉬운 pull request들로 나눕니다. 이는 각각 변경 사항의 특정 계층(layer)을 나타내는, 순서가 있는 pull request 묶음입니다. 스택을 사용하면 각 pull request를 독립적으로 리뷰하고 검사한 뒤, 한 번의 클릭으로 전체를 병합할 수 있습니다. 더 이상 리뷰하는 데 오랜 시간이 걸리는 하나의 거대한 pull request를 열거나, 수동으로 계속 리베이스(rebase)해야 하는 여러 브랜치로 작업을 나눌 필요가 없습니다.
"지난 몇 달간 Next.js 작업에 GitHub 스택 PR을 사용해 왔습니다. 덕분에 더 큰 기능을 출시하면서도 개별적으로는 더 작은 변경 사항을 도입할 수 있게 되었고, PR 리뷰도 더 쉬워졌습니다." — Tim Neutkens, Next.js 리드, Vercel
스택 pull request를 사용하면 팀은 다음과 같은 것을 할 수 있습니다.
- 범위가 좁은 짧은 pull request들을 병렬로 리뷰하여 큰 변경 사항의 진행 속도를 유지합니다.
- 기존의 브랜치 보호 규칙과 함께 계층별로 집중된 pull request 리뷰를 사용하여 모든 계층에서 품질을 유지합니다.
- 스택 전체를 한 번에 병합하거나, 개별 계층을 하나씩 병합하는 방식으로 하나, 일부, 또는 전체를 병합합니다.
그리고 스택 pull request는 GitHub에 내장된 기능이기 때문에, 기존의 리뷰, 체크(checks), 병합 요구사항이 모두 별도 설정 없이(out-of-the-box) 그대로 작동합니다.
"새로운 GitHub 스택 PR 프리뷰는 정말 놀랍습니다. 5개의 스택 PR을 머지 큐(merge queue)에 한 번에 바로 랜딩시킬 수 있다니! 정말 훌륭합니다. 이 기능은 정말 많은 마찰을 없애줍니다(gh cli 도구와 에이전트 스킬도 큰 도움이 됩니다)." — John Resig, jQuery 창시자
CLI 확장 프로그램으로 시작하기
CLI 확장 프로그램을 설치하고 1분 안에 첫 번째 스택을 만들어보세요.
gh extension install github/gh-stack
터미널이나 github.com에서 스택 만들기
github.com, GitHub CLI, GitHub 모바일 앱, 또는 gh-stack 스킬을 사용하는 GitHub Copilot 같은 코딩 에이전트로 스택 작업을 할 수 있습니다. 첫 번째 변경 사항에 대한 브랜치와 pull request로 시작합니다. 그런 다음 그 위에 브랜치와 pull request를 추가합니다. 각 pull request는 자신의 아래 계층을 대상(target)으로 합니다.
각 계층을 독립적으로 리뷰하기
스택 안의 어떤 pull request든 열어서 해당 계층의 diff만 리뷰할 수 있습니다. pull request 상단의 스택 맵(stack map)을 사용하면 지금 리뷰 중인 변경 사항이 전체 작업 안에서 어떻게 맞물리는지 확인할 수 있습니다. 팀원들과 각자 다른 계층을 병렬로 리뷰하면서도 서로의 작업을 막지 않을 수 있습니다.
"AI 덕분에 TED의 개발자들은 훨씬 더 생산적이 되었지만, 그로 인해 새로운 병목현상이 생겼습니다. PR이 점점 커져서 리뷰어들이 감당하기 어려워진 것입니다. 스택 PR은 이 문제를 해결하는 데 도움이 됩니다. 큰 변경 사항을 의존 관계 순서에 따라 정렬된 작은 조각들로 나눔으로써, 리뷰가 더 작은 논리적 단위로 이루어질 뿐만 아니라 더 정확해집니다. 스택 PR은 우리의 피드백 루프를 조여주고 안정적인 코드를 더 빠르게 ted.com에 반영하도록 도와줍니다." — Andy Merryman, TED CTO
한 번의 클릭으로 전체 병합하기
가장 최근에 준비가 끝난(ready) pull request를 병합하면 그 아래에 있는 병합되지 않은 모든 계층도 함께 랜딩됩니다. 스택의 일부만 랜딩하고 싶다면 하위 계층 중 하나 이상을 병합하면 되며, 그 위에 있는 pull request들은 열린 채로 남아 자동으로 리베이스되고 대상을 다시 지정합니다. 기존의 브랜치 보호 규칙과 필수 체크는 여전히 무엇이 main에 도달할 수 있는지를 통제합니다.
"예전에는 큰 변경 사항이라고 하면 아무도 리뷰하고 싶어하지 않는 하나의 거대한 PR을 의미했습니다. 이제는 리뷰어가 실제로 따라갈 수 있는 작은 PR들의 스택이 되었고, 스택 전체가 한 번에 병합됩니다. 더 이상 GitHub 위에 얹힌 도구처럼 느껴지지 않고, GitHub 자체처럼 느껴지기 시작했습니다." — Mayank Saini, WHOOP 커넥티비티 엔지니어
스택 pull request는 앞으로 며칠에 걸쳐 모든 저장소에 퍼블릭 프리뷰로 순차 배포됩니다. 스택 pull request에 대한 머지 큐(merge queue) 지원은 앞으로 몇 주에 걸쳐 점진적으로 배포됩니다.
4계층 심층 요약
1. 핵심 주장
GitHub이 큰 변경 사항을 여러 개의 작고 순서가 있는 pull request로 나누어 관리하는 "스택 pull request" 기능을 퍼블릭 프리뷰로 출시했다. 각 pull request는 하나의 계층을 담당하며 독립적으로 리뷰·체크할 수 있고, 준비가 되면 한 번의 클릭으로 스택 전체 또는 일부를 병합할 수 있다. 이 기능은 GitHub에 네이티브로 내장되어 기존 리뷰·체크·머지 요구사항과 그대로 호환된다.
2. 근거
- 큰 PR 하나를 리뷰하는 데 걸리는 시간과 여러 브랜치를 수동으로 리베이스해야 하는 번거로움을 스택 구조로 해결한다.
- 팀원들이 스택의 서로 다른 계층을 병렬로 리뷰할 수 있어 작업이 블로킹되지 않는다.
- 상위 계층의 pull request는 하위 계층 병합 시 자동으로 리베이스·재대상(retarget)되므로 수작업 부담이 줄어든다.
- 기존 브랜치 보호 규칙, 필수 체크, 머지 큐가 스택 PR에도 그대로 적용되어 별도 설정이 필요 없다.
gh extension install github/gh-stackCLI 확장과 GitHub Copilot의 gh-stack 스킬을 통해 터미널이나 코딩 에이전트에서도 스택을 다룰 수 있다.
3. 사례
- Vercel의 Next.js 팀은 지난 몇 달간 스택 PR을 사용해 큰 기능을 여러 개의 작은 변경으로 쪼개 출시해왔다(Tim Neutkens, Next.js 리드).
- jQuery 창시자 John Resig는 5개의 스택 PR을 머지 큐에 한 번에 랜딩시킨 경험을 언급하며 마찰이 크게 줄었다고 평가했다.
- TED는 AI로 개발 생산성이 높아지며 PR이 커져 리뷰 병목이 생겼는데, 스택 PR로 더 작고 정확한 단위 리뷰가 가능해졌다고 밝혔다(Andy Merryman, TED CTO).
- 웨어러블 기업 WHOOP의 엔지니어는 "이제 GitHub 위의 도구가 아니라 GitHub 자체처럼 느껴진다"고 평가했다(Mayank Saini).
4. 시사점
개발팀, 특히 AI 코딩 도구로 변경 규모와 속도가 빨라진 팀에게 리뷰 병목은 이미 현실적인 문제다. 스택 PR은 별도 서드파티 도구(Graphite 등) 없이 GitHub 네이티브로 이 문제를 해결할 수 있게 해, 작은 스타트업이나 1인 개발자도 큰 기능을 안전하게 잘게 쪼개 출시하는 습관을 들이기 쉬워진다. 토니처럼 여러 프로젝트를 동시에 운영하는 개발자라면 gh-stack CLI와 Copilot 스킬을 활용해 리뷰 사이클을 단축하고, 협업자에게 검토 부담을 분산할 수 있는 좋은 기회다.
핵심 요약 (20줄)
- GitHub이 "스택 pull request(Stacked Pull Requests)" 기능을 퍼블릭 프리뷰로 출시했다.
- 스택 pull request는 큰 변경 사항을 여러 개의 작고 리뷰하기 쉬운 PR로 나눈 것이다.
- 각 PR은 순서가 있는 계층(layer) 구조를 이루며, 아래 계층을 대상으로 열린다.
- 개발자는 각 PR을 독립적으로 리뷰하고 체크한 뒤 한 번의 클릭으로 전체를 병합할 수 있다.
- 기존에는 하나의 거대한 PR을 리뷰하거나 여러 브랜치를 수동으로 리베이스해야 했던 문제를 해결한다.
- Next.js 팀(Vercel)은 몇 달간 스택 PR을 사용해 큰 기능을 작은 변경으로 나눠 출시했다.
- Next.js 리드 Tim Neutkens는 스택 PR이 PR 리뷰를 더 쉽게 만들었다고 말했다.
- 팀은 좁은 범위의 짧은 PR을 병렬로 리뷰해 큰 변경 사항의 진행 속도를 유지할 수 있다.
- 브랜치 보호 규칙과 계층별 리뷰를 함께 사용해 모든 계층에서 품질을 유지할 수 있다.
- 스택 전체 또는 일부(하나, 일부, 전체)를 선택적으로 병합할 수 있다.
- 스택 PR은 GitHub에 네이티브로 내장돼 있어 기존 리뷰·체크·머지 요구사항이 그대로 작동한다.
- jQuery 창시자 John Resig는 5개의 스택 PR을 머지 큐에 한 번에 랜딩한 경험을 극찬했다.
gh extension install github/gh-stack명령으로 CLI 확장을 설치해 1분 안에 첫 스택을 만들 수 있다.- github.com, GitHub CLI, 모바일 앱, 또는 gh-stack 스킬을 쓰는 코딩 에이전트로도 스택을 다룰 수 있다.
- 스택 안의 PR을 열면 해당 계층의 diff만 볼 수 있고, 상단 스택 맵으로 전체 구조를 파악할 수 있다.
- TED CTO Andy Merryman은 AI로 인해 PR이 커지며 생긴 리뷰 병목을 스택 PR로 해결했다고 밝혔다.
- 최신 준비 완료 PR을 병합하면 그 아래 미병합 계층까지 한 번에 랜딩된다.
- 하위 계층만 병합해도 상위 PR은 자동으로 리베이스·재대상되어 열린 채 유지된다.
- WHOOP 엔지니어 Mayank Saini는 스택 PR이 "GitHub 위의 도구가 아니라 GitHub 자체처럼 느껴진다"고 평가했다.
- 스택 PR은 앞으로 며칠간 모든 저장소에 순차 배포되며, 머지 큐 지원은 몇 주에 걸쳐 점진적으로 추가된다.