Skip to content

6장. PR과 리뷰 — 합치기 전에 한 번 더 보기 ​

필수 이 단계를 따라가려면 꼭 읽으세요.

한 줄 요약: PR(Pull Request)은 내 브랜치의 변경을 main에 합치자고 제안하는 것입니다. 합치기 전에 논의하고 검토할 자리를 줍니다. 혼자 만들어도 리뷰는 합니다. AI 리뷰(/code-review)도 받되, "문제 없음"이 안전하다는 뜻은 아니고 합칠지는 내가 정합니다.

이 장은 2026년 11월 1일에 확인한 GitHub·Claude Code 공식 문서를 바탕으로 썼습니다.

PR이란 ​

PR은 한 브랜치의 변경을 다른 브랜치에 합치자고 제안하는 것입니다. 프로젝트에 들어가기 전에 논의하고 검토할 자리를 줍니다.[1]

PR 화면에는 이런 탭이 있습니다.[2]

탭보여 주는 것
Conversation설명·댓글·리뷰
Commits브랜치가 바뀐 과정
Checks자동 테스트·빌드 결과(5장)
Files changed리뷰어가 의견을 다는 바뀐 내용

출처: GitHub 공식 문서(일부만 옮김)[2:1]

PR을 만들 때는 무엇을 바꿨고 어떤 문제를 푸는지 적습니다.[3]

나중에 8장에서는 이슈(할 일이나 버그를 적어 두는 GitHub의 기록)를 씁니다. 이슈를 해결하는 PR이라면 PR 설명에 fixes #번호 같은 정해진 단어로 이슈를 적어 연결하세요. 그러면 PR이 합쳐질 때 그 이슈가 자동으로 닫힙니다.[3:1] 지금은 이런 연결이 있다는 것만 알아 두면 됩니다.

작은 PR이 리뷰하기 쉽고 합치기 안전합니다. 남에게 리뷰를 부탁하기 전에 먼저 스스로 검토합니다. 바뀐 내용을 읽고, 실수로 바꾼 것이 없는지 보고, 빌드와 테스트가 돌았는지 확인합니다.[4]

Claude Code에게 PR을 만들어 달라고 할 수도 있습니다. 공식 문서는 제출하기 전에 Claude가 만든 PR을 검토하고, 위험한 점을 짚어 달라고 하라고 권합니다.[5]

first-board 브랜치로 PR을 만들어 줘. 제출하기 전에, 이 변경에서 위험할 수 있는 점을 먼저 짚어 줘.

확인 퀴즈

PR(Pull Request)에 대한 설명으로 맞는 것은 무엇일까요?

혼자여도 리뷰한다 ​

GitHub 튜토리얼은 혼자 일해도 합치기 전에 의도적으로 리뷰하는 습관이 프로젝트를 건강하게 하고, 나중의 협업을 쉽게 한다고 말합니다.[6]

리뷰는 세 가지 결정 중 하나로 끝납니다.[7]

결정뜻
Comment의견만 남김
Approve합칠 준비가 됨
Request changes합치기 전에 고쳐야 함

출처: GitHub 공식 문서[7:1]

리뷰의 기준은 3장의 SPEC.md입니다. Claude Code 공식 모범 사례 문서는 다 만든 뒤 이렇게 리뷰하라고 예를 듭니다.[8]

  • SPEC.md와 대조해 모든 요구가 구현됐는지 본다.
  • 정확성에 영향을 주는 빈틈만 보고한다.
  • 글자 모양·이름 짓기 같은 스타일은 건너뛴다.

왜 스타일을 건너뛸까요? 문제를 찾으라고 하면 리뷰어는 늘 무언가를 찾아냅니다.[9] 그걸 다 고치다 보면 쓸데없는 군더더기가 생깁니다. 정확성만 보게 하면 꼭 고칠 것만 남습니다.

새 세션에서 지금 브랜치의 변경을 SPEC.md와 대조해 리뷰해 줘. 요구가 다 구현됐는지, 확인 기준마다 검사가 있는지 보고, 정확성에 영향을 주는 빈틈만 알려 줘. 스타일은 건너뛰어.

확인 퀴즈

SPEC.md와 대조해 리뷰를 받을 때 공식 문서가 "스타일은 건너뛰라"고 하는 이유는 무엇일까요?

AI에게 리뷰받기 ​

Claude Code에는 리뷰 명령 /code-review가 있습니다. 작업 중인 세션에서 치면, 내 브랜치의 변경을 읽고 정확성 문제를 찾아 대화로 알려 줍니다.[10] 어느 요금제에서나 쓸 수 있습니다.[11]

예를 들어 첫 화면을 다 만든 뒤 입력창에 /code-review만 치면 됩니다. 따로 설명을 붙이지 않아도 지금 브랜치의 변경을 봅니다.

AI 리뷰에는 분명한 한계가 있습니다.

  • AI 리뷰는 버그나 보안 문제를 놓칠 수 있습니다. 발견이 없다고 오류가 없거나 안전하다는 뜻은 아닙니다.[12]
  • GitHub PR에 자동으로 리뷰를 다는 관리형 리뷰도 PR을 승인하거나 막지 않습니다. 합칠지는 사람이 정합니다.[13]
자세히 (눌러서 펼치기)
  • 사용량: 리뷰도 내 세션 안에서 돌기 때문에, 세션의 나머지와 똑같이 내 요금제 사용량으로 계산됩니다.[14]
  • 데스크톱 앱: 커밋하기 전에 입력창에 /code-review를 쳐서 리뷰를 받을 수 있습니다.[15] PR을 연 뒤에는 세션 정보 패널에서 PR과 자동 검사 상태를 볼 수 있습니다. 이 기능은 GitHub CLI(gh, GitHub을 명령어로 다루는 프로그램)가 설치되고 로그인돼 있어야 합니다.[16]
  • 관리형 리뷰: GitHub PR에 자동으로 리뷰를 다는 기능은 Team·Enterprise 요금제용입니다. 개인은 어느 요금제에서나 /code-review를 씁니다.[11:1]

3단계에서 "쓴 사람과 확인하는 사람을 나눈다"를 배웠다면, 같은 Claude라도 새 세션에서 리뷰하게 하는 편이 낫습니다. 만든 대화의 맥락에 끌려가지 않기 때문입니다.

확인 퀴즈

AI 리뷰에서 발견된 문제가 없을 때 어떻게 받아들여야 할까요?

합치고 정리하기 ​

리뷰를 마치고 확인 장치가 통과하면 PR을 합칩니다(Merge). GitHub flow의 마지막은 브랜치를 지우는 것입니다. 브랜치를 지워도 PR과 커밋 기록은 지워지지 않으니 걱정하지 않아도 됩니다.[17]

나중에 사람이 늘어나면 "승인이 있어야 합칠 수 있다" 같은 보호 규칙을 걸 수 있습니다.[18] 혼자 연습하는 지금은 몰라도 됩니다.

확인 퀴즈

PR을 합친 뒤 브랜치를 지우면 어떻게 될까요?

직접 해 보기 ​

  1. first-board 브랜치가 GitHub에 올라가 있는지 확인한다(4장). 저장소 첫 화면에서 Pull requests → New pull request를 누르고, 비교할 브랜치로 first-board를 고른 뒤 Create pull request를 누른다.[19] 제목과 설명에 무엇을 왜 바꿨는지 적는다.
  2. 만들기 전에 Claude에게 위험한 점을 짚어 달라고 한다.
  3. 새 세션에서 SPEC.md와 대조한 리뷰를 받는다. 정확성 문제만 고친다.
  4. /code-review를 한 번 더 받고, 발견이 없어도 직접 Files changed 탭을 훑어본다.
  5. 확인 장치가 통과하면 PR을 합치고, 브랜치를 정리한다.

이어지는 과제: 7장에서는 합친 할 일 보드를 GitHub Pages로 인터넷에 공개합니다.

정리 ​

  • PR은 합치기 전에 논의하고 검토하는 자리다. 작게 만들고, 무엇을 왜 바꿨는지 적고, 먼저 스스로 검토한다.
  • 혼자여도 리뷰한다. 기준은 SPEC.md, 정확성 빈틈만 고치고 스타일은 건너뛴다.
  • /code-review는 어느 요금제에서나 쓴다. 발견이 없다고 안전한 것은 아니고, 합칠지는 사람이 정한다.
  • 합친 뒤 브랜치를 지워도 PR과 커밋 기록은 남는다.

용어 정리 ​

용어읽는 법한 줄 뜻
Pull Request(PR)풀 리퀘스트브랜치의 변경을 합치자는 제안
Review리뷰합치기 전에 변경을 검토하기
Merge머지브랜치의 변경을 합치기
/code-review코드 리뷰Claude Code의 리뷰 명령

이 장을 다 읽었나요?

기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.

다음 장: 7장. 배포

참고 자료 (19개)
  1. GitHub 공식 문서, 「About pull requests」. "A pull request proposes merging code changes from one branch into another. As a collaborative feature, pull requests give you a place to discuss and review work before it becomes part of a project." docs.github.com (확인일 2026-11-01) ↩︎

  2. GitHub 공식 문서, 「About pull requests」. "Checks shows the results of automated tests, builds, and other validations." / "Files changed shows the diff that reviewers comment on." docs.github.com (확인일 2026-11-01) ↩︎

  3. GitHub 공식 문서, 「GitHub flow」. "When you create a pull request, include a summary of the changes and what problem they solve." / "If you link with a keyword, the issue will close automatically when the pull request merges." docs.github.com (확인일 2026-11-01) ↩︎

  4. GitHub 공식 문서, 「Helping others review your changes」. "Small, focused pull requests are easier to review and safer to merge." / "A self-review can include reading the diff, checking for accidental changes, and making sure relevant builds or tests have run." docs.github.com (확인일 2026-11-01) ↩︎

  5. Claude Code 공식 문서, 「Common workflows」. "Review Claude's generated PR before submitting and ask Claude to highlight potential risks or considerations." code.claude.com (확인일 2026-11-01) ↩︎

  6. GitHub 공식 문서, 「Reviewing your proposed changes」. "Even when you work alone, a deliberate review builds a habit that keeps your software projects healthy and makes collaboration easier later." docs.github.com (확인일 2026-11-01) ↩︎

  7. GitHub 공식 문서, 「Quickstart for reviewing pull requests」. "Approve signals that the changes are ready to merge." / "Request changes flags feedback the author must address before merging." docs.github.com (확인일 2026-11-01) ↩︎

  8. 공식 예시는 이 리뷰를 하위 에이전트(subagent, Claude가 일을 따로 떼어 맡기는 또 다른 Claude)에게 맡기지만, 이 가이드는 새 세션으로 바꿔 씁니다. Claude Code 공식 문서, 「Best practices for Claude Code」. "use a subagent to review the rate limiter diff against SPEC.md, check every requirement is implemented and the listed edge cases have tests, report gaps that affect correctness and skip style" code.claude.com (확인일 2026-11-01) ↩︎

  9. Claude Code 공식 문서, 「Best practices for Claude Code」. "A reviewer that's asked to find problems will always find something." code.claude.com (확인일 2026-11-01) ↩︎

  10. Claude Code 공식 문서, 「Review locally with /code-review」. "Claude reviews the changes on your branch, looks for correctness bugs, and reports what it found in your conversation." code.claude.com (확인일 2026-11-01) ↩︎

  11. Claude Code 공식 문서, 「Code Review」. "Plans: Team and Enterprise" / "Run /code-review in your Claude Code session on any plan, or compare all the options." code.claude.com (확인일 2026-11-01) ↩︎

  12. Claude Code 공식 문서, 「Code Review」. "Code Review uses AI to review code and may miss bugs, security vulnerabilities, or other issues. A review with no findings doesn't mean your code is error-free or secure." code.claude.com (확인일 2026-11-01) ↩︎

  13. Claude Code 공식 문서, 「Code Review」. "A review never approves or blocks the pull request, so the decision to merge stays with your team." code.claude.com (확인일 2026-11-01) ↩︎

  14. Claude Code 공식 문서, 「Review locally with /code-review」. "The review runs in your own session, so it counts toward your plan's usage or API billing the same way the rest of the session does." code.claude.com (확인일 2026-11-01) ↩︎

  15. Claude Code 공식 문서, 「Desktop application」. "To have Claude review your changes before you commit, enter /code-review in the prompt box." code.claude.com (확인일 2026-11-01) ↩︎

  16. Claude Code 공식 문서, 「Desktop application」. "After you open a pull request, it appears in the Changes card of the session details panel with the status of its CI checks." / "PR monitoring requires the GitHub CLI (gh) to be installed and authenticated on your machine." code.claude.com (확인일 2026-11-01) ↩︎

  17. GitHub 공식 문서, 「GitHub flow」. "Don't worry about losing information. Your pull request and commit history will not be deleted." docs.github.com (확인일 2026-11-01) ↩︎

  18. 보호 규칙은 기본으로 강제 덮어쓰기(force push, 기록을 억지로 덮어 올리기)와 브랜치 삭제를 막습니다. GitHub 공식 문서, 「About protected branches」. "By default, each branch protection rule disables force pushes to the matching branches and prevents the matching branches from being deleted." docs.github.com (확인일 2026-11-01) ↩︎

  19. GitHub 공식 문서, 「Quickstart for pull requests」. "then click New pull request." / "For the compare branch, select the branch that contains your changes." / "Click Create pull request." docs.github.com (확인일 2026-11-01) ↩︎