git-manager

Git + Hugging Face 동기화 버전 관리

⚠️ 필수 행동 규칙 (반드시 따를 것)

Git 초기화/설정 요청 시

1. 반드시 아래 .gitignore 템플릿 사용 (비텍스트 파일 전체 제외)
2. 반드시 .hf-sync.json 파일 생성
3. 기존 비텍스트 파일이 있으면 먼저 HF에 업로드 후 Git 커밋

커밋 요청 시 ("커밋해", "커밋해줘" 등)

1. 먼저 비텍스트 파일 존재 여부 확인:

   find . -type f \( -name "*.jpg" -o -name "*.JPG" -o -name "*.jpeg" -o -name "*.png" -o -name "*.gif" -o -name "*.pdf" -o -name "*.docx" -o -name "*.xlsx" -o -name "*.pptx" -o -name "*.csv" -o -name "*.pkl" -o -name "*.mp4" -o -name "*.mp3" -o -name "*.zip" \) 2>/dev/null
   

2. 비텍스트 파일이 있으면:
   • 절대 바로 git commit 하지 말 것
   • HuggingFace에 먼저 업로드
   • .hf-sync.json 업데이트
   • 그 후 Git 커밋 (텍스트 파일만)
3. .gitignore에 해당 확장자가 없으면 먼저 추가

금지 사항

• ❌ 비텍스트 파일을 Git에 직접 커밋
• ❌ .gitignore 없이 또는 불완전한 .gitignore로 커밋
• ❌ .hf-sync.json 없이 비텍스트 파일 관리

---

핵심 원칙

텍스트 파일만 Git에서 관리, 나머지는 모두 Hugging Face에서 동기화 관리

Git (로컬)                      Hugging Face
├── 텍스트 파일 ─────────────── 버전 관리 ✅
│   ├── *.txt, *.md
│   ├── *.py, *.js, *.ts
│   ├── *.json, *.yaml
│   ├── *.html, *.css
│   └── 기타 코드/설정 파일
│
└── 비텍스트 파일 ─────────────→ HF 동기화 버전 관리 ✅
    ├── 이미지 (*.jpg, *.png, *.gif, *.webp, *.svg, *.ico)
    ├── 문서 (*.pdf, *.docx, *.pptx, *.xlsx, *.hwp)
    ├── 데이터 (*.csv, *.pkl, *.h5, *.parquet)
    ├── 모델 (*.pt, *.pth, *.onnx, *.safetensors)
    ├── 미디어 (*.mp4, *.mp3, *.wav, *.mov)
    └── 압축 (*.zip, *.tar.gz, *.rar)

.hf-sync.json 파일로 Git 커밋과 HF 커밋을 매핑하여 완전한 버전 동기화.

Hugging Face 저장소 정보

• URL: https://huggingface.co/datasets/j00n98/Claude-Code-Storage
• 계정: j00n98

초기 설정 워크플로우

1단계: Git 초기화

# .git 존재 여부 확인
ls -la | grep .git

# 없으면 초기화
git init

2단계: .gitignore 생성 (비텍스트 파일 모두 제외)

# macOS
.DS_Store
._*

# ========================================
# 비텍스트 파일 - Hugging Face에서 관리
# ========================================

# 이미지
*.jpg
*.jpeg
*.JPG
*.JPEG
*.png
*.PNG
*.gif
*.GIF
*.webp
*.svg
*.ico
*.bmp
*.tiff
*.heic
*.heif

# 문서
*.pdf
*.PDF
*.docx
*.doc
*.pptx
*.ppt
*.xlsx
*.xls
*.hwp

# 데이터
*.csv
*.pkl
*.pickle
*.h5
*.hdf5
*.parquet
*.feather
*.arrow
*.npy
*.npz

# ML 모델
*.pt
*.pth
*.onnx
*.safetensors
*.bin
*.model
*.weights

# 미디어
*.mp4
*.mp3
*.wav
*.mov
*.avi
*.mkv
*.flac
*.m4a

# 압축
*.zip
*.tar
*.tar.gz
*.tgz
*.rar
*.7z

# 환경/캐시
.env
__pycache__/
*.pyc
node_modules/
.venv/