GitHub Stacked PR 공개 프리뷰, 큰 변경을 작은 리뷰로 나눠요

GitHub Stacked PR 공개 프리뷰, 큰 변경을 작은 리뷰로 나눠요

GitHub Stacked PR 공개 프리뷰 썸네일

GitHub가 큰 변경을 여러 개의 작은 PR로 쌓아 관리하는 Stacked pull requests를 모든 저장소에 공개 프리뷰로 순차 제공해요. 각 계층의 diff를 따로 검토하면서도 전체 변경은 한 번에 병합할 수 있어, 리뷰 범위와 브랜치 관리 부담을 함께 줄이는 기능이에요. 1

핵심 요약

구분	핵심	왜 볼 만한가요
변경 구조	큰 작업을 의존 순서가 있는 작은 PR로 나눠요	리뷰어가 한 번에 읽어야 할 diff가 줄어요
검토 방식	계층별 PR을 서로 독립적으로 검토해요	여러 리뷰어가 다른 계층을 병렬로 볼 수 있어요
병합 방식	전체 스택이나 아래쪽 일부 계층을 골라 병합해요	일부 병합 뒤 남은 PR은 자동으로 리베이스되고 대상이 바뀌어요
기존 규칙	필수 검사와 브랜치 보호, 리뷰 요건을 그대로 적용해요	기존 저장소 정책을 크게 바꾸지 않고 시험할 수 있어요
지원 환경	웹, CLI, 모바일 앱, Copilot에서 스택을 다뤄요	팀이 쓰던 작업 환경 안에서 접근할 수 있어요

1. 거대한 PR 대신 작은 변경을 순서대로 쌓아요

Stacked PR은 하나의 큰 기능을 여러 PR로 나누되, 각 PR이 바로 아래 계층을 대상으로 삼는 구조예요. 첫 번째 변경 위에 두 번째 변경을 올리고, 다시 그 위에 다음 변경을 더해 의존 순서를 표현해요. 리뷰어는 전체 기능의 거대한 diff를 한꺼번에 읽지 않아도 돼요. 현재 계층에서 추가된 코드만 확인할 수 있어요. PR 상단의 스택 맵에서는 해당 변경이 전체 작업 중 어디에 놓였는지도 볼 수 있어요. 1

여러 리뷰를 동시에 진행할 수 있어요

기존에는 앞선 브랜치가 병합될 때까지 다음 PR 검토가 밀리거나, 개발자가 여러 브랜치를 직접 리베이스하며 관계를 맞춰야 했어요. 스택에서는 팀원들이 서로 다른 계층을 독립적으로 검토할 수 있어요. GitHub가 소개한 Next.js 팀도 큰 기능을 출시하는 동안 개별 변경 크기를 작게 유지해 리뷰하기 쉬워졌다고 설명했어요. 다만 변경 사이의 의존성이 복잡하다면 PR을 어떤 논리 단위로 나눌지 먼저 합의해야 해요.

728x90

전체 스택과 일부 계층을 골라 병합해요

가장 위에 있는 준비된 PR을 병합하면 그 아래에 남은 계층도 한 번에 반영할 수 있어요. 아래쪽 계층만 먼저 병합하는 방식도 지원해요. 이 경우 위쪽 PR은 열린 상태를 유지하고, 병합된 변경에 맞춰 자동으로 리베이스돼요. 대상 브랜치도 새 기준으로 바뀌어요. 기존의 브랜치 보호, 필수 검사, 리뷰와 병합 요건은 계속 적용돼요. 2

웹과 CLI에서 바로 시작할 수 있어요

GitHub.com과 GitHub 모바일 앱에서 스택을 만들고 관리할 수 있어요. 터미널에서는 `gh extension install github/gh-stack` 명령으로 공식 CLI 확장을 설치해요. GitHub Copilot 같은 코딩 에이전트는 `gh-stack` 스킬을 이용할 수 있어요. 기능은 공개 프리뷰 단계라 모든 저장소에 며칠에 걸쳐 순차 적용돼요. Merge queue 연동은 이후 몇 주 동안 차례로 제공될 예정이에요. 1

왜 중요한가요

AI 코딩 도구가 작성 속도를 높여도 리뷰어가 읽어야 할 변경량까지 자동으로 줄어들지는 않아요. 큰 PR이 자주 생기는 팀이라면 작성 속도보다 검토 대기 시간이 병목이 될 수 있어요. Stacked PR은 기능 단위를 유지하면서 리뷰 범위를 작게 쪼개고, 각 계층의 검사와 승인을 따로 관리할 수 있게 해요. GitHub가 인용한 TED 사례에서도 AI 도입 뒤 PR이 커지면서 리뷰가 느려졌고, 의존 순서에 따라 변경을 나눠 검토 범위를 줄였다고 설명해요. 1

도입할 때는 자동 리베이스만 믿기보다 스택의 경계를 먼저 정하는 편이 좋아요. 데이터 모델 변경, 호출부 수정, 테스트처럼 검토 순서가 분명한 작업은 계층으로 나누기 쉬워요. 반대로 여러 방향으로 의존하는 변경은 선형 스택과 잘 맞지 않을 수 있어요. 공개 프리뷰에서는 작은 기능 브랜치부터 시험하고, 필수 리뷰 재승인이나 Merge queue 동작이 팀 규칙과 맞는지 확인해 보는 게 안전해요. 사용법과 지원 범위는 공식 문서에서 확인할 수 있어요. 3

참고 자료

1. Stacked pull requests are now in public preview — GitHub Changelog
2. GitHub Stacked PR 공개 프리뷰 시작 — GeekNews
3. Working with stacked pull requests — GitHub Docs