| name | branch |
| description | 이슈 설명을 받아서 팀의 브랜치 네이밍 컨벤션에 맞춰 브랜치명을 자동으로 생성합니다. |
| context | inline |
| allowed-tools | [] |
Git Branch Naming Convention
핵심 원칙
- 하나의 Issue = 하나의 Branch
- 형식:
label/issue-number[-description]
- 소문자 + 하이픈만 사용 (언더스코어/점/공백 금지)
브랜치 라벨 → 커밋 타입 매핑 (단일 소스)
이 표는 /commit skill도 참조한다.
| 브랜치 라벨 | 커밋 타입 | 용도 |
|---|
| feature | feat | 새 기능 추가 |
| bug | bug | 버그 수정 |
| refactor | refactor | 리팩터링 |
| test | test | 테스트 작성/수정 |
| chore | chore | 빌드, 설정, 의존성 |
| docs | docs | 문서 작성/수정 |
형식 규칙
- label: 위 6종 중 하나 (소문자)
- issue-number: 숫자만 (예: 1, 45, 102)
- description (선택): 영문 소문자 + 하이픈, 3~4 단어 권장
올바른 예시
feature/1
feature/1-add-layout
bug/45-fix-login-error
refactor/102-optimize-user-query
test/51-add-payment-tests
chore/76-update-dependencies
docs/130-write-api-documentation
잘못된 예시
Feature/1 ❌ 대문자
feature_1 ❌ 언더스코어
feature/1.add-layout ❌ 점
feature 1 ❌ 공백
feature/add-layout ❌ 이슈 번호 누락
1-add-layout ❌ 라벨 누락
Workflow
- 사용자 입력에서 다음을 추출:
- 작업 타입 (FEATURE/BUG/REFACTOR/TEST/CHORE/DOCS)
- 이슈 번호
- 설명(선택)
- 설명이 길면 핵심 키워드 2~4개로 간결화 (예: "사용자가 로그인할 때 이메일과 비밀번호로 JWT 받는 플로우" →
add-login-auth)
- 형식에 맞춰 브랜치명 생성
- 브랜치 생성 명령어를 함께 출력 (사용자가 복사해서 실행)
출력 형식
✅ 추천 브랜치명:
{label}/{issue-number}-{description}
📋 브랜치 생성 명령어:
git checkout -b {label}/{issue-number}-{description}
사용 예시
예시 1: 태그 + 이슈 번호 + 설명
입력:
FEATURE 사용자 로그인 기능 추가 45 브랜치명 만들어줘
출력:
✅ 추천 브랜치명:
feature/45-add-login
📋 브랜치 생성 명령어:
git checkout -b feature/45-add-login
예시 2: 한글 설명 압축
입력:
REFACTOR: SeatBooking 엔티티를 역정규화하고 좌석 조회 쿼리를 최적화하려고. 이슈 122번.
출력:
✅ 추천 브랜치명:
refactor/122-seatbooking-query
예외 처리
1. 이슈 번호가 없는 경우
⚠️ 이슈 번호가 필요합니다.
GitHub 이슈를 먼저 생성하고 번호와 함께 다시 요청해주세요.
예시: "FEATURE 사용자 로그인 기능 45 브랜치명 만들어줘"
2. 타입을 알 수 없는 경우
⚠️ 작업 타입을 명확히 알려주세요.
사용 가능한 타입: FEATURE, BUG, REFACTOR, TEST, CHORE, DOCS