dev: Git pre-commit hook 추가 (자동 린트 검사)

추가된 파일:
- scripts/hooks/pre-commit: ruff check 실행 훅
- scripts/setup-hooks.sh: 훅 설치 스크립트

기능:
- 커밋 전 staged Python 파일에 대해 ruff check 자동 실행
- 린트 에러 발견 시 커밋 차단
- CI 실패 사전 방지

설치 방법:
```bash
./scripts/setup-hooks.sh
```

우회 방법 (특별한 경우만):
```bash
git commit --no-verify
```

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

Author: wkdgus1164

README.md

@@ -122,6 +122,9 @@ git clone https://github.com/ureca-corp/document_parser.git
 cd document_parser
 uv sync --extra dev
 
+# Git hooks 설치 (린트 자동 검사)
+./scripts/setup-hooks.sh
+
 # 테스트 실행
 uv run pytest tests/ -v
 
@@ -130,6 +133,21 @@ uv sync --extra docs
 uv run mkdocs serve
 ```
 
+### Git Hooks
+
+프로젝트는 커밋 전 자동 린트 검사를 위한 Git hooks를 제공해요:
+
+```bash
+# Hooks 설치
+./scripts/setup-hooks.sh
+
+# 설치 후 커밋 시 자동으로 ruff check 실행
+git commit -m "message"  # → 자동으로 린트 검사
+
+# 필요시 우회 (권장하지 않음)
+git commit --no-verify -m "message"
+```
+
 ## 라이선스
 
 MIT License - 자세한 내용은 [LICENSE](LICENSE) 파일을 참고하세요.

scripts/hooks/pre-commit

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Git pre-commit hook - Runs ruff check before allowing commit
+
+echo "🔍 Running ruff check on staged Python files..."
+
+# Get list of staged Python files
+PYTHON_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.pyi?$' || true)
+
+if [ -z "$PYTHON_FILES" ]; then
+    echo "✓ No Python files to check"
+    exit 0
+fi
+
+echo "Checking files:"
+echo "$PYTHON_FILES" | sed 's/^/  - /'
+
+# Run ruff check on staged files
+if uv run ruff check $PYTHON_FILES; then
+    echo "✓ Ruff check passed!"
+    exit 0
+else
+    echo ""
+    echo "❌ Ruff check failed!"
+    echo ""
+    echo "Fix the errors above or:"
+    echo "  - Run: uv run ruff check --fix src/"
+    echo "  - Skip check: git commit --no-verify"
+    exit 1
+fi

scripts/setup-hooks.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Setup script to install Git hooks
+
+set -e
+
+echo "🔧 Installing Git hooks..."
+
+# Copy pre-commit hook
+cp scripts/hooks/pre-commit .git/hooks/pre-commit
+chmod +x .git/hooks/pre-commit
+
+echo "✓ Pre-commit hook installed"
+echo ""
+echo "This hook will:"
+echo "  - Run ruff check on staged Python files before commit"
+echo "  - Block commits if lint errors are found"
+echo "  - Skip with: git commit --no-verify (use sparingly!)"
+echo ""
+echo "🎉 Setup complete!"