Vibe coding

07강. Git 워크플로우 통합

🎯 학습 목표

  • Claude와 함께 의미 있는 커밋 메시지를 작성한다.
  • 변경 내용을 바탕으로 PR(풀 리퀘스트) 설명을 생성한다.
  • Claude에게 코드 리뷰를 요청하는 방법을 익힌다.
  • Git 기본 워크플로우를 Vibe Coding에 자연스럽게 녹인다.

📖 개념 설명

Git은 협업과 버전 관리의 핵심입니다. Claude Code는 git diff나 git status를 읽어 변경 사항을 이해하고, 그에 맞는 커밋 메시지와 PR 설명을 작성할 수 있습니다. 사람이 일일이 변경 요약을 쓰는 수고를 덜어주면서도, 좋은 컨벤션을 유지하도록 돕습니다.

좋은 커밋 메시지는 ‘무엇을’ 바꿨는지뿐 아니라 ‘왜’ 바꿨는지를 담습니다. Claude는 변경된 코드를 분석해 이 둘을 자연스럽게 정리해 줍니다. 단, 커밋·푸시 같은 되돌리기 어려운 작업은 사람이 최종 확인하는 것이 안전합니다.

코드 리뷰 요청도 강력합니다. 커밋 전에 “이 변경을 리뷰해줘”라고 하면, Claude가 잠재적 버그, 누락된 예외 처리, 더 단순한 대안 등을 짚어줍니다. 이는 동료 리뷰를 받기 전 1차 점검으로 매우 유용합니다.

Git의 기본 개념을 잠깐 정리해 봅시다. Git은 코드의 변경 이력을 스냅샷으로 남기는 버전 관리 시스템입니다. 작업한 내용을 ‘add(스테이징)’로 모으고, ‘commit’으로 하나의 의미 있는 묶음으로 기록하며, ‘push’로 원격 저장소(예: GitHub)에 올립니다. 각 커밋은 되돌아갈 수 있는 체크포인트가 되므로, 실험적인 변경도 안심하고 시도할 수 있습니다. Vibe Coding처럼 AI가 빠르게 코드를 바꾸는 환경일수록, 자주 커밋해 안전망을 촘촘히 두는 것이 중요합니다.

PR(풀 리퀘스트)은 “내가 만든 변경을 메인 코드에 합쳐 달라”고 제안하는 절차입니다. 팀에서는 PR 단위로 리뷰하고 머지하므로, PR 설명이 곧 변경의 얼굴이 됩니다. 좋은 PR 설명은 무엇을 왜 바꿨는지, 어떻게 테스트했는지를 담아 리뷰어가 빠르게 이해하도록 돕습니다. Claude는 브랜치의 변경 내역(diff)을 분석해 이런 설명을 초안으로 만들어 주므로, 사람은 검토와 다듬기에만 집중하면 됩니다.

다만 한 가지 원칙을 기억하세요. 커밋·푸시·머지처럼 이력에 영향을 주거나 되돌리기 어려운 작업은 항상 사람이 최종 실행을 확인해야 합니다. AI가 메시지를 잘 써 주더라도, ‘무엇을 기록으로 남길지’ 결정하는 책임은 개발자에게 있습니다.

💻 실습

변경 사항을 스테이징한 뒤 Claude에게 커밋 메시지를 요청합니다.

# 변경 사항 확인 및 스테이징
git status
git add .

# Claude에게 커밋 메시지 작성 요청
> 지금 스테이징된 변경을 보고 적절한 커밋 메시지를 한국어로 작성해줘.
> 제목은 50자 이내, 본문에 무엇을 왜 바꿨는지 설명을 넣어줘.

Claude가 제안한 메시지를 검토하고 커밋합니다.

git commit -m "To-Do 항목 삭제 시 확인 창 추가

사용자가 실수로 항목을 지우는 것을 막기 위해 삭제 전 confirm 창을 띄우도록 변경."

커밋 전 코드 리뷰를 요청할 수도 있습니다.

> 커밋하기 전에 지금 변경된 코드를 리뷰해줘.
> 버그 가능성, 빠진 예외 처리, 더 단순한 방법이 있으면 알려줘.

원격에 올린 뒤 PR 설명을 생성합니다.

> 이번 브랜치의 변경 사항을 바탕으로 PR 설명을 작성해줘.
> 개요, 변경 내용, 테스트 방법 섹션으로 나눠서.

⚠️ Windows 환경 주의사항

  • Windows에서 Git을 처음 쓰면 줄바꿈(CRLF/LF) 경고가 뜹니다. git config --global core.autocrlf true로 설정하면 자동 변환됩니다.
  • 커밋 메시지에 한글을 쓸 때 깨지면 git config --global i18n.commitEncoding utf-8을 설정하세요.
  • 여러 줄 커밋 메시지를 PowerShell에서 입력할 때는 -m을 두 번 쓰거나, 따옴표 안에서 줄바꿈을 직접 넣으세요.
  • GitHub PR을 다루려면 gh CLI 설치를 권장합니다: winget install GitHub.cli.

💡 팁

  • 커밋은 작게, 자주 하세요. 한 커밋에 한 가지 변경만 담으면 메시지도 명확해집니다.
  • “왜 바꿨는지”를 강조해 달라고 요청하면 미래의 나에게 도움이 되는 메시지가 나옵니다.
  • 푸시·머지 같은 파괴적 작업은 항상 사람이 최종 확인하세요.
  • 리뷰 요청 시 “확신이 높은 것만 알려줘”라고 하면 노이즈가 줄어듭니다.
  • 커밋 메시지 컨벤션(예: 제목/본문 구분, 동사로 시작)을 한 번 정해 두고 매번 동일하게 요청하세요.
  • 되돌리고 싶을 때를 대비해, 큰 변경 전에는 별도 브랜치를 만들어 작업하세요.
  • PR 설명에는 ‘테스트 방법’을 꼭 넣어, 리뷰어가 직접 확인할 수 있게 하세요.
  • 커밋 직전 리뷰는 습관으로 만드세요. 작은 점검 한 번이 나중의 큰 수정 비용을 아껴 줍니다.