바이브코딩을 시작하는 사람들을 보면 항상 같은 데서 막힙니다. 코드는 AI가 잘 짜줘요. 근데 “이제 깃허브에 올려봐” 하는 순간 멈춰요.

주변 지인한테 바이브코딩을 알려줄 때마다 느꼈는데, commit, push, pull 같은 말이 나오면 일단 겁부터 먹어요. “그게 뭔데?”, “눌러도 되는 거야?”, “내 코드 날아가는 거 아니야?” — 매번 이런 반응입니다.

AI 에이전트가 문제를 더 키워요. rebase, force push, detached HEAD 같은 말을 아무 설명 없이 던지고 “실행할까요?“라고 물어봐요. 뭔지도 모르는데 확인 누르기가 무섭고, 거절하자니 뭘 거절하는 건지도 모르겠고. 눈에 보이는 것도 없으니까 더 불안합니다.

그래서 Claude Code 에이전트가 Git 작업을 할 때 자동으로 쉬운 말로 바꿔주는 Agent Skill을 만들었습니다.

어떻게 바뀌는지

작업 끝나고 세이브+올리기 (가장 흔한 상황):

🧺 1단계 — 담는 중...  
   ✏️ src/App.tsx  [고침]  
   🆕 src/Dashboard.tsx  [새 파일]  
  
💾 2단계 — 세이브하는 중...  
   ✅ "대시보드 페이지 추가"  
   📁 2개 파일 저장됨  
  
☁️ 3단계 — GitHub에 올리는 중...  
  
✅ 세이브 + GitHub 올리기 완료!  
   💻 ═══ ✓ ═══ ☁️ GitHub  맞춰졌어요  
🟢 안전  [█░░░]  

위험한 작업이면 확실히 경고:

⚠️⚠️⚠️ 강제 덮어쓰기 ⚠️⚠️⚠️  
GitHub에 있는 기록을 내 걸로 완전히 바꿔버려요!  
🔴 위험  [████]  
⚠️ 다른 사람이 올린 작업이 사라질 수 있어요!  
정말 할까요?  

상태 확인하면:

═══════════════════════════════════════  
📝  작업 중 — 3개 파일 고침, 아직 세이브 안 함  
═══════════════════════════════════════  
  
📂 작업 폴더 (3개)  →  🧺 담아둠  →  💾 세이브  →  ☁️ GitHub ✓  

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

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

GitHub에 안 올린 게 있으면:

⬆️ GitHub에 안 올린 세이브 2개  
  
   💻 "리뷰 파이프라인 보완"  (5일 전)  
   💻 "Git 도우미 스킬 추가"  (방금)  
  
   위험한 건 아니에요. 백업만 안 한 거예요.  

충돌 나면:

💥 충돌! 하지만 걱정 마세요.  
  
같은 파일을 둘 다 고쳐서 자동으로 합칠 수 없어요.  
어느 쪽 코드를 쓸지 골라주세요:  
   1️⃣ 내 코드로  
   2️⃣ 상대방 코드로  
   3️⃣ 둘 다 합치기  

용어 변환

  • commit → 💾 세이브
  • push → ☁️ GitHub에 올리기
  • pull → 📥 받아오기
  • branch → 🌿 사본
  • merge → 🤝 합치기
  • stage/add → 🧺 담아두기
  • conflict → 💥 충돌

이런 것도 됩니다

  • “Git이 뭔데?” 같은 입문 질문에 게임 세이브 비유로 설명
  • .env, node_modules 같은 위험 파일이 올라가려고 하면 자동 차단
  • Git 에러 17가지를 한국어로 번역 (rejected → “GitHub에 새로 올라온 게 있어요. 먼저 받아온 다음에 다시 올려주세요”)
  • “코드가 다 날아갔어요!” 패닉 상황에서 복구 안내

설치

폴더 복사 한 번 + CLAUDE.md에 3줄 추가면 끝입니다. 빌드도, 서버도, 의존성도 없습니다.

mkdir -p .claude/skills  
cp -r dont-git-afraid .claude/skills/  

처음에는 MCP 서버로 만들려다가, “Git이 무서운 사람한테 npm install 하고 서버 빌드하라고?” 싶어서 Agent Skill(SKILL.md)로 방향을 틀었습니다.