chore(husky): update branch naming guide and validation script

Expanded the branch naming convention to allow both two-level and three-level formats (e.g., <type>/<description> and <type>/<domain>/<description>), clarified allowed and forbidden characters, and updated examples in the documentation. Adjusted the validation script to enforce the new rules, including stricter character checks and support for the new format.

Author: kimchanhyung98

.husky/husky-guide.md

@@ -8,18 +8,18 @@
 
 ### 허용 타입
 
-| 타입 | 설명 | 예시 |
-|------|------|------|
-| `feat` | 새로운 기능 추가 | `feat: 사용자 인증 추가` |
-| `fix` | 버그 수정 | `fix(api): null 응답 처리` |
-| `docs` | 문서 수정 | `docs: 설치 가이드 업데이트` |
-| `style` | 코드 스타일 변경 | `style: 코드 포맷팅` |
-| `refactor` | 코드 리팩토링 | `refactor(auth): 로직 개선` |
-| `test` | 테스트 추가/수정 | `test: 유닛 테스트 추가` |
-| `chore` | 빌드/설정 변경 | `chore: 의존성 업데이트` |
-| `build` | 빌드 시스템/외부 의존성 변경 | `build: webpack 설정 업데이트` |
-| `ci` | CI 설정 파일/스크립트 변경 | `ci: GitHub Actions 워크플로우 추가` |
-| `revert` | 이전 커밋 되돌리기 | `revert: feat(auth) 커밋 되돌림` |
+| 타입         | 설명               | 예시                            |
+|------------|------------------|-------------------------------|
+| `feat`     | 새로운 기능 추가        | `feat: 사용자 인증 추가`             |
+| `fix`      | 버그 수정            | `fix(api): null 응답 처리`        |
+| `docs`     | 문서 수정            | `docs: 설치 가이드 업데이트`           |
+| `style`    | 코드 스타일 변경        | `style: 코드 포맷팅`               |
+| `refactor` | 코드 리팩토링          | `refactor(auth): 로직 개선`       |
+| `test`     | 테스트 추가/수정        | `test: 유닛 테스트 추가`             |
+| `chore`    | 빌드/설정 변경         | `chore: 의존성 업데이트`             |
+| `build`    | 빌드 시스템/외부 의존성 변경 | `build: webpack 설정 업데이트`      |
+| `ci`       | CI 설정 파일/스크립트 변경 | `ci: GitHub Actions 워크플로우 추가` |
+| `revert`   | 이전 커밋 되돌리기       | `revert: feat(auth) 커밋 되돌림`   |
 
 ### 예시
 
@@ -38,38 +38,60 @@
 
 **실행 시점**: `git push` 시 (푸시 전)
 **스크립트**: `validate-branch.cjs`
-**형식**: `<type>/<description>`
+**형식**: `<type>/<description>` 또는 `<type>/<domain>/<description>`
+**허용 문자**: 소문자, 숫자, 특수문자
+**금지 문자**: 대문자, 언더스코어(_), 공백, 슬래시(/)
 
 ### 허용 타입
 
-| 타입 | 설명 | 예시 |
-|------|------|------|
-| `feature` | 새로운 기능 개발 | `feature/user-authentication` |
-| `fix` | 버그 수정 | `fix/login-bug` |
-| `hotfix` | 긴급 버그 수정 | `hotfix/critical-security-issue` |
-| `release` | 릴리스 준비 | `release/v1.0.0` |
-| `refactor` | 코드 리팩토링 | `refactor/auth-logic` |
-| `docs` | 문서 업데이트 | `docs/installation-guide` |
-| `test` | 테스트 추가 | `test/unit-tests` |
-| `chore` | 유지보수 작업 | `chore/update-deps` |
-| `style` | 스타일 개선 | `style/format-code` |
-| `copilot` | GitHub Copilot 지원 개발 | `copilot/add-validation` |
-| `claude` | Claude AI 지원 개발 | `claude/refactor-api` |
+| 타입         | 설명                   | 예시                               |
+|------------|----------------------|----------------------------------|
+| `feature`  | 새로운 기능 개발            | `feature/user-authentication`    |
+| `fix`      | 버그 수정                | `fix/login-bug`                  |
+| `hotfix`   | 긴급 버그 수정             | `hotfix/critical-security-issue` |
+| `release`  | 릴리스 준비               | `release/v1.0.0`                 |
+| `refactor` | 코드 리팩토링              | `refactor/auth-logic`            |
+| `docs`     | 문서 업데이트              | `docs/installation-guide`        |
+| `test`     | 테스트 추가               | `test/unit-tests`                |
+| `chore`    | 유지보수 작업              | `chore/update-deps`              |
+| `style`    | 스타일 개선               | `style/format-code`              |
+| `copilot`  | GitHub Copilot 지원 개발 | `copilot/add-validation`         |
+| `claude`   | Claude AI 지원 개발      | `claude/refactor-api`            |
 
 ### 보호 브랜치 (직접 푸시 허용)
 
 `main`, `master`, `develop`, `staging`
 
 ### 예시
 
+#### 2단계 형식 (기본)
+
 ```bash
 ✅ feature/user-authentication
-✅ fix/login-bug
+✅ fix/404-error
 ✅ copilot/add-validation
 ✅ claude/refactor-api
+✅ hotfix/security-patch-2024
+✅ release/1.0.0
+```
+
+#### 3단계 형식 (도메인 포함)
+
+```bash
+✅ feature/frontend/user-authentication
+✅ fix/api/null-response
+✅ refactor/backend/auth-logic
+✅ docs/api/endpoint-guide
+✅ test/integration/payment-flow
+✅ fix/api/404-error
+```
 
-❌ feature_user_auth    # 구분자 오류 (/ 사용)
-❌ Feature/user-auth    # 대문자 사용 금지
-❌ feature/User-Auth    # 설명에 대문자 사용 금지
-❌ my-feature           # 타입 누락
+#### 잘못된 형식
+
+```bash
+❌ Feature/Frontend/User-auth  # 타입, 도메인, 설명에 대문자 사용 금지
+❌ my-feature                  # 타입 누락
+❌ feature/add_function        # 언더스코어 사용 금지
+❌ feature/a/b/c               # 4단계 이상 금지
+❌ feature/                    # 설명 누락
 ```

.husky/validate-branch.cjs

@@ -4,7 +4,7 @@ const {execSync} = require('child_process');
 
 // 허용 규칙
 const validTypes = ['feature', 'fix', 'hotfix', 'release', 'refactor', 'docs', 'test', 'chore', 'style', 'copilot', 'claude'];
-const validPattern = '<type>/<description>';
+const validPattern = '<type>/<description> 또는 <type>/<domain>/<description>';
 
 // 현재 브랜치명 확인
 let currentBranch;
@@ -21,8 +21,9 @@ if (protectedBranches.includes(currentBranch)) {
     process.exit(0);
 }
 
-// 패턴: `type/description`
-const branchPattern = new RegExp(`^(${validTypes.join('|')})\\/[a-z][a-z0-9-]*$`);
+// 패턴: `type/description` 또는 `type/domain/description`
+// 허용: 소문자, 숫자, 특수문자 (단, 대문자/언더스코어/공백/슬래시 제외)
+const branchPattern = new RegExp(`^(${validTypes.join('|')})\\/[a-z0-9][^A-Z_\\s\\/]*(\\/[a-z0-9][^A-Z_\\s\\/]*)?$`);
 if (!branchPattern.test(currentBranch)) {
     console.error(`* 잘못된 형식 : ${currentBranch}`);
     console.error(`* 올바른 형식 : ${validPattern}`);