Git으로 협업하기

기획자도 개발자도

버전 관리는 모든 팀원의 공통 언어입니다

모노레포 + 서브모듈 구조

우리 팀의 저장소 전략

workshop-monorepo/  (public)
├── planning/       ← 기획자: React 와이어프레임
├── app/            ← 개발자: React Native 앱
└── api/            ← Submodule (private 저장소)

• 기획 내용은 외부에 공개 (포트폴리오, 피드백)
• API·키·DB는 private 저장소로 보안 확보

Git Submodule 사용법

API 저장소를 서브모듈로 연결

# 서브모듈 추가
git submodule add git@github.com:team/api.git api

# 클론 시 서브모듈 포함
git clone --recurse-submodules [repo-url]

# 서브모듈 업데이트
git submodule update --remote

GitHub Flow

main → feature branch → PR → merge

main ─────●─────────────────●─────────── (항상 배포 가능)
            \               ↑
             \  feature/    /
              ●──●──●──●──● (PR & merge)

GitHub Flow 단계

1. main에서 feature branch 생성
2. 작업 후 commit & push
3. Pull Request 생성
4. 코드 리뷰 후 merge

GitHub Flow vs Git Flow

워크샵에서는 GitHub Flow를 사용합니다

PR 기반 코드 리뷰

생성 → 리뷰 → Approve → Merge

# 1. 브랜치 생성 & 작업
git checkout -b feature/login-screen
git add . && git commit -m "feat: 로그인 화면 구현"
git push -u origin feature/login-screen

# 2. PR 생성
gh pr create --title "feat: 로그인 화면" --body "..."

기획자도 PR 리뷰를!

코드를 몰라도 할 수 있는 리뷰

• UI/UX가 기획 의도대로 구현되었는지 확인
• 카피(텍스트)가 올바른지 검토
• 스크린샷이나 영상 첨부를 요청

PR 템플릿

팀에서 사용할 PR 양식

## 변경 사항
-
## 스크린샷
(캡처 첨부)
## 체크리스트
- [ ] 기획 문서와 일치하는지 확인
- [ ] 모바일에서 테스트 완료

Claude + Git 통합 (1)

커밋 메시지 자동 작성

# Claude Code에서 변경사항 분석 후 커밋 메시지 생성
claude /commit

Claude + Git 통합 (2)

커밋 메시지 컨벤션

Claude + PR 설명 생성

변경사항 자동 요약

# Claude가 변경사항을 분석하여 PR 본문 작성
claude "이 브랜치의 변경사항을 요약해서
       PR 설명을 작성해줘"

주의사항

Claude가 생성한 커밋 메시지와 PR 설명도
반드시 사람이 검토한 후 사용하세요.
자동 생성된 내용이 실제 변경 의도와 다를 수 있습니다.

실습: Git 워크플로우

팀 내 최소 1회 실행

1. git checkout -b feature/내이름-작업내용
2. 작업 후 git add . && git commit -m "feat: ..."
3. git push -u origin feature/...
4. gh pr create 로 PR 생성

실습: 리뷰 & 머지

PR 리뷰 후 머지하기

5. GitHub에서 팀원의 PR에 코멘트 작성
6. Approve 후 Squash & Merge

협업은 연습할수록 자연스러워집니다