docs(husky): restructure guide into separate validation documentation

- Split husky-guide.md into branch-name-guide.md and commit-message-guide.md
- Add dependabot branch type support
- Allow underscore (_) character in branch names
- Update validation scripts and GitHub Actions workflow

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Co-Authored-By: LeeByeongMuk <mansogod@gmail.com>

Author: 3 people

.github/docs/branch-name-guide.md

@@ -6,19 +6,20 @@
 
 ## 허용 타입
 
-| 타입         | 설명                   | 예시                               |
-|------------|----------------------|----------------------------------|
-| `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`            |
+| `dependabot` | 의존성 업데이트             | `dependabot/npm_and_yarn`        |
 
 ## 보호 브랜치 (검사 제외)
 
@@ -30,7 +31,7 @@
 
 - **타입**: 위 표의 허용된 타입 중 하나 사용
 - **구분자**: `/` (슬래시) 사용
-- **허용 문자**: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.)
+- **허용 문자**: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.), 언더바(_)
 
 #### 2단계 형식 (기본)
 
@@ -59,7 +60,6 @@
 ```bash
 ❌ Feature/Frontend/User-auth  # 타입, 도메인, 설명에 대문자 사용 금지
 ❌ my-feature                  # 타입 누락
-❌ feature/add_function        # 언더스코어 사용 금지
 ❌ feature/a/b/c               # 4단계 이상 금지
 ❌ feature/                    # 설명 누락
 ```

.github/workflows/branch-name-check.yml

@@ -23,11 +23,11 @@ jobs:
           fi
 
           # 허용된 타입
-          VALID_TYPES="feature|fix|hotfix|release|refactor|docs|test|chore|style|copilot|claude"
+          VALID_TYPES="feature|fix|hotfix|release|refactor|docs|test|chore|style|copilot|claude|dependabot"
 
           # 패턴: type/description 또는 type/domain/description
-          # 허용: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.)
-          PATTERN="^(${VALID_TYPES})/[a-z0-9][a-z0-9.-]*(/[a-z0-9][a-z0-9.-]*)?$"
+          # 허용: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.), 언더바(_)
+          PATTERN="^(${VALID_TYPES})/[a-z0-9][a-z0-9._-]*(/[a-z0-9][a-z0-9._-]*)?$"
 
           if [[ ! "$BRANCH" =~ $PATTERN ]]; then
             echo "❌ Invalid branch name: $BRANCH"

.husky/docs/branch-name-guide.md

@@ -0,0 +1,86 @@
+# 브랜치명 검증 가이드
+
+**실행 시점**: `git push` 시 (푸시 전)
+**스크립트**: `.husky/validate-branch.cjs`
+**형식**: `<type>/<description>` 또는 `<type>/<domain>/<description>`
+**허용 문자**: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.), 언더바(_)
+
+## 허용 타입
+
+| 타입           | 설명                   | 예시                               |
+|--------------|----------------------|----------------------------------|
+| `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`            |
+| `dependabot` | 의존성 업데이트             | `dependabot/npm_and_yarn`        |
+
+## 보호 브랜치 (직접 푸시 허용)
+
+`main`, `master`, `develop`, `staging`
+
+## 브랜치명 형식
+
+### 2단계 형식 (기본)
+
+```bash
+✅ feature/user-authentication
+✅ fix/404-error
+✅ copilot/add-validation
+✅ claude/refactor-api
+✅ hotfix/security-patch-2024
+✅ release/1.0.0
+✅ dependabot/npm_and_yarn/turbo-2.7.3
+```
+
+### 3단계 형식 (도메인 포함)
+
+```bash
+✅ feature/frontend/user-authentication
+✅ fix/api/null-response
+✅ refactor/backend/auth-logic
+✅ docs/api/endpoint-guide
+✅ test/integration/payment-flow
+```
+
+### ❌ 잘못된 형식
+
+```bash
+Feature/Frontend/User-auth  # 대문자 사용 금지
+my-feature                  # 타입 누락
+feature/a/b/c               # 4단계 이상 금지
+feature/                    # 설명 누락
+```
+
+## 작명 규칙
+
+1. **소문자만 사용**: `Feature` ❌ → `feature` ✅
+2. **명확한 설명**: `fix/bug` ❌ → `fix/login-validation-error` ✅
+3. **하이픈으로 단어 구분**: `userauth` ❌ → `user-authentication` ✅
+4. **간결하게**: `feature/add-new-user-authentication-system-for-web` ❌
+   → `feature/user-authentication` ✅
+
+## 검증 우회
+
+```bash
+# 긴급 상황에서만 사용
+git push --no-verify
+```
+
+⚠️ **주의**: GitHub Actions에서는 우회할 수 없으므로 규칙을 준수하세요.
+
+## 다중 검증 계층
+
+| 계층             | 시점              | 우회 가능 여부                   |
+|----------------|-----------------|----------------------------|
+| 로컬 Husky       | `git push` 실행 시 | ✅ `--no-verify` 플래그로 우회 가능 |
+| GitHub Actions | PR 생성/수정 시      | ❌ 필수 체크 (우회 불가)            |
+
+GitHub Actions 검증은 `.github/workflows/branch-name-check.yml`에서 실행됩니다.

.husky/docs/commit-message-guide.md

@@ -0,0 +1,63 @@
+# 커밋 메시지 검증 가이드
+
+**실행 시점**: `git commit` 시 (커밋 생성 전)
+**스크립트**: `.husky/validate-commit.cjs`
+**형식**: `<type>(scope): <subject>` 또는 `<type>: <subject>`
+
+## 허용 타입
+
+| 타입         | 설명               | 예시                            |
+|------------|------------------|-------------------------------|
+| `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) 커밋 되돌림`   |
+
+## 형식 규칙
+
+### ✅ 올바른 형식
+
+```bash
+feat: 사용자 인증 추가
+feat(auth): JWT 토큰 검증 추가
+fix(api): null 응답 처리
+docs: 설치 가이드 업데이트
+```
+
+### ❌ 잘못된 형식
+
+```bash
+Add feature          # 타입 누락
+feat add feature     # 콜론 누락
+feat(): 기능 추가    # 빈 scope
+FEAT: 기능 추가      # 대문자 사용 금지
+```
+
+## Scope (선택사항)
+
+Scope는 변경 범위를 명시합니다:
+- `feat(api): REST API 추가`
+- `fix(auth): 로그인 버그 수정`
+- `refactor(ui): 컴포넌트 구조 개선`
+
+## Subject 작성 규칙
+
+1. **명령형 현재 시제 사용**: "추가했음" ❌ → "추가" ✅
+2. **첫 글자 소문자**: "추가" ✅ (영어: "add" ✅)
+3. **마침표 사용 안 함**: "기능 추가." ❌ → "기능 추가" ✅
+4. **50자 이내 권장**: 간결하고 명확하게
+
+## 검증 우회
+
+```bash
+# 긴급 상황에서만 사용
+git commit --no-verify -m "message"
+```
+
+⚠️ **주의**: 가급적 사용하지 말고, 규칙을 준수하세요.

.husky/husky-guide.md

@@ -3,7 +3,7 @@
 const {execSync} = require('child_process');
 
 // 허용 규칙
-const validTypes = ['feature', 'fix', 'hotfix', 'release', 'refactor', 'docs', 'test', 'chore', 'style', 'copilot', 'claude'];
+const validTypes = ['feature', 'fix', 'hotfix', 'release', 'refactor', 'docs', 'test', 'chore', 'style', 'copilot', 'claude', 'dependabot'];
 const validPattern = '<type>/<description> 또는 <type>/<domain>/<description>';
 
 // 현재 브랜치명 확인
@@ -22,8 +22,8 @@ if (protectedBranches.includes(currentBranch)) {
 }
 
 // 패턴: `type/description` 또는 `type/domain/description`
-// 허용: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.)
-const branchPattern = new RegExp(`^(${validTypes.join('|')})\\/[a-z0-9][a-z0-9.-]*(\\/[a-z0-9][a-z0-9.-]*)?$`);
+// 허용: 소문자(a-z), 숫자(0-9), 하이픈(-), 점(.), 언더바(_)
+const branchPattern = new RegExp(`^(${validTypes.join('|')})\\/[a-z0-9][a-z0-9._-]*(\\/[a-z0-9][a-z0-9._-]*)?$`);
 if (!branchPattern.test(currentBranch)) {
     console.error(`* 잘못된 형식 : ${currentBranch}`);
     console.error(`* 올바른 형식 : ${validPattern}`);