좋은 Git 브랜치명을 만드는 5가지 규칙
브랜치명은 작업의 명함입니다. 잘 작성된 브랜치명 하나만 봐도 "이게 어떤 작업인지, 어떤 이슈에 연결돼 있는지, 누가 작업 중인지"가 한 번에 파악되어 코드 리뷰·CI/CD·릴리즈 노트 자동 생성까지 매끄럽게 흘러갑니다. 이 도구는 작업 유형(feature, fix, hotfix, release, chore, docs, refactor, test, style, perf), 선택적 스코프, 이슈 트래커 ID, 한국어 또는 영어 설명을 입력받아 git-flow·GitHub flow·Trunk-based development 세 가지 대표 컨벤션의 브랜치명을 동시에 생성합니다.
한글 설명을 입력해도 자동으로 영문 음역(transliteration)을 거쳐 kebab-case 슬러그로 변환됩니다. 예를 들어 "사용자 로그인 추가"는 "sayongja-rogin-chuga" 같은 로마자 슬러그로 바뀌고, 영문 설명을 직접 적으면 그대로 슬러그화됩니다. 브랜치명에는 공백·특수문자·대문자가 들어가지 않아야 하며, 끝에 마침표가 붙거나 / 로 끝나는 등 Git이 거부하는 패턴도 자동으로 정리됩니다.
3가지 대표 컨벤션 비교
git-flow는 feature/, release/, hotfix/, bugfix/ 같이 슬래시(/)로 구분하는 가장 전통적인 방식입니다. develop 브랜치에서 시작해 main으로 머지하는 흐름이 명확합니다. GitHub flow는 main만 유지하고 짧은 수명의 feature 브랜치만 사용합니다. 보통 username/feature-name 또는 issue-123-description 형태를 씁니다. Trunk-based development는 main에 자주 머지하는 방식으로 브랜치명은 더욱 짧고 명료해야 합니다(예: tbd/login-fix).
자주 묻는 질문 (FAQ)
Q. 브랜치명에 한글을 그대로 써도 되나요?
A. Git 자체는 UTF-8 한글 브랜치명을 허용하지만, CI 시스템이나 일부 IDE에서 인코딩 문제가 발생하므로 영문 슬러그로 변환하는 것이 표준입니다. 본 도구는 자동으로 변환해 줍니다.
Q. 이슈 ID를 브랜치명 앞에 두는 게 좋나요, 뒤에 두는 게 좋나요?
A. 정해진 답은 없지만, Jira·Linear처럼 자동 연결 봇이 있는 경우 type/ABC-123-description 형태(슬래시 뒤, 설명 앞)가 가장 잘 인식됩니다. GitHub Issues는 종종 issue-42-fix-login처럼 issue- 접두어를 씁니다.
Q. 브랜치명에 마침표(.) 두 개나 ..가 들어가면 안 되는 이유는?
A. Git 내부에서 ".."는 범위 지정 문법이라 reference 이름에는 사용할 수 없습니다. 끝에 .lock 으로 끝나도 안 되고, @, ~, ^, : 같은 문자도 금지됩니다. 본 도구는 모두 자동으로 제거합니다.