Don't Git Afraid 🎮💾

Git이 무서운 바이브코더를 위한 AI 에이전트 스킬

🇬🇧 English version: README.en.md

이게 뭔데?

바이브코딩 중에 AI가 git rebase origin/main --onto feature/login 이런 걸 실행한다고 하면 무섭잖아요.

이 스킬을 넣으면 AI가 Git 이야기를 할 때 자동으로 이렇게 바뀌어요:

❌ 기존:
"git push --force-with-lease origin main 실행하겠습니다"
→ 😨 뭔소리???

✅ 설치 후:
⚠️⚠️⚠️ 강제 덮어쓰기 ⚠️⚠️⚠️
GitHub에 있는 기록을 내 걸로 완전히 바꿔버려요!
🔴 위험  [████]
정말 할까요?
→ 😮 아 위험한 거구나! 잠깐만!

설치 (1분)

Git 몰라도 설치할 수 있게 ZIP 방식을 먼저 소개해요. 🙂

1. ZIP 다운받기

1. 이 페이지 위쪽 초록색 <> Code 버튼 → Download ZIP
2. 압축 풀기
3. 안에 있는 dont-git-afraid 폴더를 .claude/skills/에 넣기
   • 이 프로젝트에서만 쓰려면: 내 프로젝트/.claude/skills/dont-git-afraid/
   • 모든 프로젝트에서 쓰려면: ~/.claude/skills/dont-git-afraid/
   • 폴더가 없으면 직접 만들어주세요

Git이 익숙하다면 git clone 으로 받아서 dont-git-afraid 폴더만 옮겨도 돼요. 자세한 건 INSTALL.md 참고.

2. CLAUDE.md에 추가

## Git 규칙
사용자에게 Git 작업 상태를 설명·보고·확인할 때는 반드시
`dont-git-afraid` 스킬의 용어 변환 규칙을 따르세요
(commit→세이브, push→올리기, branch→사본 등 + 이모지).

단, Bash 도구로 실제 git 명령을 실행할 때는 원래 git 용어를
그대로 사용합니다 (`git commit`, `git push`, ...).

3. 테스트

지금 내 Git 상태 어때?

이렇게 나오면 성공!

뭘 해주는 건데?

🗣️ Git 설명을 사람 말로

Git 용어	스킬이 쓰는 말
commit	💾 세이브
push	☁️ GitHub에 올리기
pull	📥 받아오기
branch	🌿 사본
merge	🤝 합치기
stage / add	🧺 담아두기
stash	🗄️ 잠깐 치워두기
rebase	⏳ 순서정리
conflict	💥 충돌

📊 상태를 한눈에

═══════════════════════════════════════
📝  작업 중 — 3개 파일 고침, 아직 세이브 안 함
═══════════════════════════════════════

📂 작업 폴더 (3개)  →  🧺 담아둠  →  💾 세이브  →  ☁️ GitHub ✓

파일이 많으면 폴더별로 묶어서 요약:

📂 작업 폴더 (27개)
   📁 src/pages/orders/     — 5개 (고침 3 + 새 파일 2)
   📁 src/hooks/orders/     — 2개 (새 파일 2)
   📁 .claude/skills/       — 5개 (새 파일 5)
   📁 기타                  — 15개

⚠️ 위험도 표시

작업 전에 위험한 건지 안전한 건지 알려줘요:

🟢 안전  [█░░░]    — 세이브, GitHub에 올리기
🟡 조심  [██░░]    — 받아오기 (고치던 파일 있을 때)
🟠 주의  [███░]    — 합치기, 순서정리
🔴 위험  [████]    — 강제 덮어쓰기

🧺💾☁️ 작업 끝나면 한번에

🧺 1단계 — 담는 중...
   ✏️ src/App.tsx  [고침]
   🆕 src/Dashboard.tsx  [새 파일]

💾 2단계 — 세이브하는 중...
   ✅ "대시보드 페이지 추가"

☁️ 3단계 — GitHub에 올리는 중...

✅ 세이브 + GitHub 올리기 완료!
   💻 ═══ ✓ ═══ ☁️ GitHub  맞춰졌어요

🤔 Git 입문도 도와줌

"Git이 뭔데?", "왜 써야 해?", "어떻게 시작해?" 같은 질문에도 게임 세이브 비유로 쉽게 설명해줘요.

💡 Git = 코드의 세이브 파일 관리자

게임할 때 세이브하잖아요?
Git은 코드를 세이브하고, 필요하면 이전 세이브로 돌아가게 해주는 거예요.

🚨 보안 사고 예방

.env 파일이나 node_modules가 GitHub에 올라가려고 하면 자동으로 막아요:

🚨🚨🚨 보안 경고 🚨🚨🚨
.env 파일이 담기려고 해요!
GitHub에 올라가면 전 세계 누구나 볼 수 있어요!
🔴 위험  [████]

😰 패닉 대응

"코드가 다 날아갔어요!" 같은 상황에서 차분하게 안내:

😰 진정하세요! 거의 다 복구할 수 있어요.
확인해볼게요...

💥 충돌 해결 가이드

충돌 나면 3단계로 차근차근 안내:

💥 충돌! 하지만 걱정 마세요.
어느 쪽 코드를 쓸지 골라주세요:
   1️⃣ 내 코드로
   2️⃣ 상대방 코드로
   3️⃣ 둘 다 합치기

🚀 배포 연동

push하면 자동 배포되는 흐름을 한눈에:

📂 코드 수정 → 💾 세이브 → ☁️ GitHub → 🚀 자동 배포 → 🌐 사이트 업데이트!

전체 커버리지

Git 작업 (15가지)

세이브, GitHub에 올리기, 받아오기, 콤보(한번에), 사본 이동, 사본 만들기, 합치기, 순서정리, 강제 덮어쓰기, 되돌리기, 가져오기(clone), 저장소 만들기(init), GitHub 연결, 치워두기(stash), 꺼내기

상태 판별 (6가지)

✨ 깨끗 / 📝 작업 중 / 🧺 담아둔 상태 / ⬆️ 안 올린 게 있음 / 💥 충돌 / 😱 과거 모드

안전 장치

🙈 .gitignore 자동 감지 / 🚨 .env 차단 / 📦 node_modules 방지 / 🔑 비밀 파일 감지

에러 번역 (17가지)

Git 에러 메시지를 친절한 한국어로 자동 변환

입문 가이드

Git이 뭔지 / GitHub이 뭔지 / 처음 시작하는 법 / 매일 쓰는 루틴

별도 가이드

💥 충돌 해결 (conflict-guide.md) / 🚀 배포 연동 (deploy-guide.md) / 🛡️ 보안·긴급 구조 (safety-guide.md)

파일 구조

dont-git-afraid/
├── SKILL.md           ← 메인 (용어, 형식, 시나리오, 입문 가이드)
├── git-status.sh      ← 상태 분석 스크립트
├── conflict-guide.md  ← 충돌 해결 가이드
├── deploy-guide.md    ← 배포 연동 가이드
└── safety-guide.md    ← 보안 & 긴급 구조

라이선스

MIT