Git Convention

Git 컨벤션

최초 작성: 2026-10-09

---

브랜치 전략

main      ← 릴리즈 (직접 push 금지)
develop   ← 통합 브랜치 (직접 push 금지)
feat/*    ← 기능 개발
fix/*     ← 버그 수정
chore/*   ← 설정, 패키지 등 기타

• 모든 작업은 develop에서 분기한다
• 작업 완료 후 develop으로 PR을 올린다
• develop → main은 릴리즈 시점에만 병합한다

---

브랜치 네이밍

feat/기능명
fix/버그명
chore/작업명

예시: feat/login, fix/token-refresh, chore/eslint-config

---

커밋 메시지

형식

타입: 한 줄 요약

(선택) 본문 — 왜 변경했는지, 무엇이 달라지는지

(선택) Closes #이슈번호

• 한 줄 요약은 50자 이내, 마침표 없이 작성한다
• 본문이 필요할 때만 한 줄 띄고 작성한다
• 이슈와 연결할 때는 footer에 Closes #번호를 붙인다

타입

타입	설명
feat	새 기능
fix	버그 수정
chore	설정, 패키지, 기타
style	포맷, 세미콜론 등 로직 변경 없음
refactor	리팩터링
docs	문서 수정
test	테스트 코드 추가·수정
perf	성능 개선

예시

feat: 로그인 페이지 구현

Closes #12

fix: 토큰 만료 시 리다이렉트 오류 수정

만료된 토큰으로 요청 시 401 응답을 받으면 /login으로 이동하도록 처리

Closes #34

---

이슈 작성

GitHub Issue 탭에서 템플릿을 선택해 작성한다.

템플릿	용도
기능 추가	새 기능 구현
버그 리포트	버그 신고
작업	설정, 문서, 리팩터링 등

이슈 제목은 커밋 타입 형식을 따른다.

예시: feat: 회원가입 폼 유효성 검사, bug: 모바일에서 네비게이션 메뉴가 닫히지 않음

---

PR 작성

PR을 열면 템플릿이 자동으로 채워진다.

항목	설명
연관 이슈	Closes #번호 형식으로 연결. 이슈 없이 시작한 작업은 생략 가능
변경 사항	bullet로 핵심 변경만 나열
테스트 체크리스트	로컬 확인 항목 체크
리뷰어에게	리뷰 포인트나 결정 이유. 없으면 삭제

PR 규칙

• 셀프 merge 금지 — 상대방 approve 1개 필수
• PR 제목은 커밋 컨벤션과 동일한 형식으로 작성한다
• 리뷰어는 24시간 내 리뷰한다
• develop → main PR은 릴리즈 메모를 본문에 포함한다