---
name: branch-rule
description: Git 브랜치를 생성하거나 분기하거나 이름을 정하기 전에 적용합니다. 사용자가 브랜치 생성, 분기 또는 이름 결정을 요청할 때 의미가 분명한 접두사 규칙을 제공합니다.
---

# 브랜치 이름 규칙

## 출력 언어

사용자가 출력 언어를 명시적으로 지정하면 해당 언어를 사용합니다. 지정하지 않으면 이 스킬이 만드는 모든 사용자 대상 출력, 문서, 프롬프트, 보고서, 계획, 스펙 및 기타 산출물을 한국어로 작성합니다. 제목, 섹션, 레이블, 표, 체크리스트, 다이어그램, 템플릿에도 같은 언어를 사용합니다. 코드, 명령어, 파일 경로, 식별자, API 이름, 모델 ID, 프로토콜 이름과 필수 고유명사는 번역하지 않습니다.

## 작성 문서 첨부

요청된 모든 문서의 작성 또는 갱신을 마친 뒤 최종 응답에 각 문서를 `[문서 이름](절대 경로)` 형식의 Markdown 링크로 반드시 첨부합니다. 링크에는 독립된 디렉터리 세그먼트로 구성된 절대 경로를 사용하고, 디렉터리 구분자를 생략하거나 경로 세그먼트를 붙여 쓰지 않습니다. Windows 경로를 문자열로 표시할 때는 `C:\\Users\\WinUser\\Documents\\폴더\\문서.md`처럼 각 역슬래시를 두 번 씁니다.

브랜치 이름은 저장소가 별도로 정한 규칙이 있으면 그 규칙을 우선하고, 없으면 아래의 접두사만 최상위 접두사로 사용한다. 의미를 알 수 있는 적절한 이름을 사용한다.

- feat/…
- bug/…
- perf/…
- refactor/…
- misc/…

자잘한 변경점을 모은 브랜치는 `misc/…` 접두사를 사용한다.

`codex/`, `agent/` 또는 도구 이름을 위 접두사 앞에 자동으로 추가하지 않는다. 예를 들어 `codex/feat/login`은 금지하고 `feat/login`을 사용한다. 사용자가 이번 작업에서 다른 브랜치 이름을 명시한 경우에는 그 이름을 우선한다.

브랜치를 만들기 전에 후보 이름이 `feat/`, `bug/`, `perf/`, `refactor/`, `misc/` 중 하나로 바로 시작하는지 확인한다. 저장소 고유 규칙이나 사용자 지정이 없는 상태에서 다른 최상위 접두사를 만들지 않는다.