claude-instructions/commands/git/branch.md

description, allowed-tools

description	allowed-tools
브랜치 생성, 전환, 삭제 등 브랜치 관리 작업을 수행합니다	Bash(git branch:*) Bash(git checkout:*) Bash(git switch:*) Bash(git status:*) Bash(git stash:*) Bash(git log:*) Bash(git fetch:*)

Claude 명령어: Branch

브랜치 생성, 전환, 삭제 등 Git 브랜치 관리를 위한 종합 도구입니다.

사용법

/git:branch [브랜치명]           # 새 브랜치 생성 및 전환
/git:branch                    # 대화형 브랜치 관리 메뉴

주요 기능

1. 브랜치 생성 및 전환

• 새 브랜치 생성과 동시에 전환
• 브랜치명 규칙 자동 검증
• 프리픽스 자동 제안 (feature/, fix/, hotfix/, docs/, chore/)

2. 안전한 브랜치 전환

• 전환 전 uncommitted 변경사항 자동 감지
• 필요시 자동 stash 생성
• 원격 브랜치 추적 설정

3. 브랜치 관리

• 현재 브랜치 상태 및 목록 확인
• 로컬/원격 브랜치 동기화
• 안전한 브랜치 삭제 (병합 여부 확인)

프로세스

브랜치 생성 플로우

1. 현재 Git 상태 확인
2. uncommitted 변경사항 처리 (stash 또는 커밋 권장)
3. 브랜치명 검증 및 규칙 적용
4. 최신 main/develop 브랜치에서 분기
5. 새 브랜치 생성 및 전환

브랜치 전환 플로우

1. 현재 작업 상태 확인
2. 필요시 변경사항 stash
3. 대상 브랜치로 전환
4. 원격 추적 브랜치 설정

브랜치 삭제 플로우

1. 병합 상태 확인
2. 원격 브랜치 존재 여부 확인
3. 안전 확인 후 삭제

브랜치 네이밍 규칙

권장 프리픽스

feature/    - 새로운 기능 개발
fix/        - 버그 수정
hotfix/     - 긴급 수정
docs/       - 문서화 작업
chore/      - 빌드, 설정 등 유지보수
refactor/   - 코드 리팩토링
test/       - 테스트 코드 작업

네이밍 패턴

✅ 좋은 예시:
feature/user-authentication
fix/login-validation-error
hotfix/security-patch
docs/api-documentation

❌ 피해야 할 예시:
feature-user-auth          # 슬래시 사용
FEATURE/USER-AUTH          # 대문자 사용
feature/user auth          # 공백 사용
temp                       # 불명확한 이름

대화형 메뉴 옵션

브랜치명 없이 실행 시 표시되는 메뉴:

1. 📝 새 브랜치 생성
2. 🔄 브랜치 전환
3. 📋 브랜치 목록 보기
4. 🗑️  브랜치 삭제
5. 🔄 원격 브랜치 동기화
6. 📊 브랜치 상태 확인

안전 기능

자동 백업

• 브랜치 전환 전 자동 stash 생성
• Stash 메시지에 이전 브랜치명 포함
• 작업 손실 방지를 위한 확인 프롬프트

충돌 방지

• 원격 브랜치와의 동기화 상태 확인
• 병합되지 않은 브랜치 삭제 시 경고
• 현재 브랜치에서의 미완료 작업 감지

복구 지원

• 실수로 삭제한 브랜치 복구 안내
• Stash 목록 및 복구 방법 제시
• 브랜치 히스토리 추적

사용 예시

새 기능 브랜치 생성

/git:branch feature/user-profile

버그 수정 브랜치 생성

/git:branch fix/authentication-error

대화형 모드 실행

/git:branch

통합 기능

다른 Git 커맨드와의 연계

• /git:commit과 연동한 커밋 워크플로우
• /git:merge와 연동한 병합 워크플로우
• /git:pr과 연동한 PR 생성 워크플로우

GitHub CLI 통합

• 원격 브랜치 자동 설정
• Issue 번호 기반 브랜치 생성
• PR 생성 시 브랜치 정보 자동 연결

고급 옵션

브랜치 생성 옵션

• --from-issue : GitHub Issue에서 브랜치 생성
• --track : 원격 브랜치 추적 설정
• --no-stash : 자동 stash 비활성화

정리 옵션

• --cleanup : 병합된 브랜치 일괄 삭제
• --prune : 원격에서 삭제된 브랜치 정리
• --dry-run : 삭제 예상 결과 미리보기

문제 해결

자주 발생하는 문제

1. 브랜치 전환 실패 → uncommitted 변경사항 처리
2. 브랜치 삭제 거부 → 병합 상태 확인 필요
3. 원격 브랜치 추적 오류 → fetch 후 재시도
4. 브랜치명 규칙 위반 → 자동 제안 받아 수정

복구 방법

• 잘못 삭제한 브랜치: git reflog로 복구
• 손실된 변경사항: git stash list에서 복구
• 꼬인 브랜치 상태: git reset으로 초기화

이 커맨드는 Git 브랜치 관리의 모든 측면을 안전하고 효율적으로 처리합니다.