🤝 협업 중심 Git & GitHub 특강

충돌 없이 빠르고 안전한 협업 가이드 여러 명이 함께하는 협업 흐름을 이해하고, 실제로 적용해보는 4시간 특강

📌 소개

우리FIS 아카데미에서 진행한 Git & GitHub 협업 특강 자료 저장소입니다. 이 특강은 단순히 Git 명령어를 소개하는 강의가 아니라, 실제 협업에서 덜 헤매기 위한 흐름과 기준을 함께 익히는 세션으로 구성했습니다.

🧭 왜 이 특강을 만들었나요?

처음에는 Git을 명령어 위주로 익혀서 사용하는 데 그쳤습니다. 하지만 실제 협업 과정에서 여러 충돌과 시행착오를 겪으면서, 단순히 명령어를 아는 것보다 브랜치 전략, PR의 역할, 충돌 해결 순서 같은 형상관리의 개념과 흐름을 이해하는 것이 훨씬 중요하다는 것을 깨달았습니다. 그 이후로는 Git을 더 덜 불안하게, 더 정확하게 사용할 수 있게 되었습니다.

그래서 이 특강에서는 Git을 처음 접하거나 협업이 익숙하지 않은 사람도 핵심 개념을 빠르게 이해할 수 있도록, 비유를 활용해 꼭 필요한 개념들을 보다 쉽게 전달하고자 했습니다.

이 특강은

• 처음 Git 협업을 시작할 때 막막했던 지점을 줄이고
• 충돌을 무조건 피하는 것이 아니라 이해하고 해결할 수 있게 만들고
• 팀 프로젝트에서 바로 적용할 수 있는 실전 협업 루틴을 전달하는 것

에 초점을 맞춰 설계했습니다.

🎯 특강 목표

• 팀원들과 Git으로 효율적으로 협업하기
• 문제가 발생했을 때 코드 손실 없이 해결하기
• GitHub 기반 협업 규칙을 실제 프로젝트에 적용하기

🗂 목차

1. 오프닝 & 세팅
2. 최소 이론 & 보안
3. 유연한 커밋 관리
4. 브랜치 전략
5. 협업 환경 세팅
6. merge 전략 비교
7. 실전 충돌(conflict) 해결
8. 마무리

🎯 다룬 내용

1. Git 기본 흐름 이해

• Working Directory / Staging Area / Repository
• git add, git commit의 의미
• 장바구니 비유로 이해하는 Git 3영역

2. 보안과 .gitignore

• .env, API Key, DB 비밀번호 관리
• 실수로 비밀 파일을 커밋했을 때 대처 방법
• git rm --cached를 활용한 추적 제거
• 유출된 키는 삭제가 아니라 폐기 및 재발급이 필요함

3. 좋은 커밋 습관 만들기

• 커밋 히스토리의 중요성

• git add -p로 기능 단위 커밋 나누기

• Conventional Commits 적용

  • feat
  • fix
  • docs
  • refactor
  • chore

4. 브랜치 전략

• Git Flow 핵심 브랜치 이해

  • main
  • develop
  • feature
  • release
  • hotfix

• Git Flow vs GitHub Flow 비교

• 배포 주기에 따라 전략 선택하는 기준

5. GitHub 협업 세팅

• Issue / PR 템플릿 구성
• .github 폴더 구조 설정
• Labels 활용
• 브랜치 네이밍 규칙 적용
• 이슈 번호 기반 작업 추적

6. 병합 전략과 충돌 해결

• Merge / Squash / Rebase 차이
• 상황별 병합 방식 선택
• 충돌(conflict) 발생 시 해결 흐름 이해

🛠 사용한 도구

• Git
• GitHub
• GitKraken

초보자가 복잡한 브랜치 흐름과 머지 과정을 시각적으로 이해할 수 있도록 GUI 도구를 함께 사용했습니다.

💡 실습 포인트

이 특강에서는 설명만 하지 않고, 아래 내용을 직접 실습했습니다.

• Git 설치 및 사용자 정보 설정
• GitKraken 로그인 및 기본 사용법
• .gitignore 설정 실습
• 이슈 생성 → 브랜치 생성 → 커밋 → PR 작성 흐름 실습
• PR / Issue 템플릿 적용 실습
• 브랜치 네이밍 규칙 실습
• 자기소개 README 작성 실습

🧩 이런 분들께 추천합니다

• Git을 쓰고 있지만 협업 흐름이 아직 헷갈리는 분
• merge, rebase, squash 차이가 모호한 분
• 팀 프로젝트에서 브랜치 전략을 어떻게 잡아야 할지 고민 중인 분
• GitHub 이슈 / PR / 라벨 / 템플릿까지 정리하고 싶은 분

📂 추천 저장소 구조

.
├── README.md
├── practice/
│   ├── gitignore-demo/
│   ├── commit-history-demo/
│   ├── branch-strategy-demo/
│   └── conflict-demo/
└── .github/
    ├── pull_request_template.md
    └── ISSUE_TEMPLATE/
        ├── bug_report.md
        └── feature_request.md

📝 배운 점

이 특강을 준비하고 진행하면서, Git은 단순한 버전 관리 도구가 아니라 팀의 소통 비용을 줄이고 협업 품질을 높이는 시스템이라는 점을 다시 확인할 수 있었습니다.

특히 다음 관점을 중심으로 구성했습니다.

• 명령어 자체보다 흐름을 이해하게 만들기
• 어려운 개념도 비유를 통해 쉽게 설명하기
• 실무에서 자주 나는 실수를 사고 사례 중심으로 설명하기
• 이론 설명보다 실제 협업 루틴으로 연결하기

🙌 기대 효과

특강 이후 수강생이 아래 흐름을 스스로 수행할 수 있도록 하는 것을 목표로 했습니다.

• 이슈를 생성하고
• 이슈 번호 기반 브랜치를 만들고
• 명확한 커밋 메시지를 남기고
• PR 템플릿에 맞춰 작업 내용을 정리하고
• 충돌이 나더라도 안전하게 해결하는 것

📎 발표자

이조은 우리FIS 아카데미 Git & GitHub 협업 특강

📁 특강 자료

⛓️자료링크

---

✨ 한 줄 요약

Git 명령어를 외우는 강의가 아니라, 팀이 실제로 덜 헤매게 만드는 협업 특강입니다.