Git 기초 — 코드의 타임머신

바이브 코딩에서 AI는 여러분 대신 코드를 작성합니다. 하지만 AI도 실수를 합니다. 잘 작동하던 코드를 AI가 "개선"하다가 망가뜨리는 일은 생각보다 자주 일어납니다.

이때 Git이 없다면, 이전에 잘 작동하던 코드를 복구할 방법이 없습니다. Git은 바이브 코딩의 필수 안전망입니다.

왜 Git이 바이브 코딩에 필수인가

바이브 코딩에서 Git이 특히 중요한 이유를 구체적으로 살펴봅시다.

이유 1: AI는 실수한다

AI가 "이 코드를 더 효율적으로 개선할게요"라고 하면서 기존에 잘 작동하던 코드를 완전히 다시 쓸 때가 있습니다. 결과가 더 나빠지면?

Git이 있다면: git checkout 한 번이면 원래대로 돌아옵니다. Git이 없다면: 이전 코드를 기억하고 다시 타이핑해야 합니다. (불가능에 가깝습니다)

이유 2: 실험을 자유롭게 할 수 있다

"MediaPipe 대신 TensorFlow.js를 써볼까?" 같은 실험을 할 때, Git으로 현재 상태를 저장해두면 마음 편하게 시도할 수 있습니다. 실패하면 돌아오면 그만이니까요.

이유 3: AI에게 맥락을 제공한다

Git 히스토리를 보면 프로젝트가 어떻게 발전해왔는지 알 수 있습니다. AI에게 "이전 커밋과 비교해서 뭐가 달라졌어?"라고 물으면, 정확한 변경 사항을 알려줍니다.

Git 핵심 명령어 — 하나씩 배우기

Git에는 수십 가지 명령어가 있지만, 바이브 코딩에 필요한 것은 7개뿐입니다. 각 명령어를 음악 비유와 함께 자세히 알아봅시다.

1. git init — 새 프로젝트 녹음 시작

2. git add — 이번 테이크에 포함할 파일 선택

git add . (점 포함)은 현재 폴더의 모든 변경 파일을 스테이지에 올립니다. "모든 트랙을 한꺼번에 녹음 대기"시키는 것과 같습니다.

3. git commit — 테이크 저장

좋은 커밋 메시지 작성법

커밋 메시지는 미래의 자신(또는 AI)이 읽을 메모입니다.

나쁜 예시:

• "수정" — 무엇을 수정했는지 알 수 없음
• "ㅋㅋ" — 의미 없음
• "asdf" — ...

좋은 예시:

• "MediaPipe 손 추적 기능 추가" — 무엇을 했는지 명확
• "OSC 포트를 9000에서 8000으로 변경" — 구체적인 변경 내용
• "카메라 에러 처리 추가 — 카메라 없을 때 안내 메시지 표시" — 무엇을 왜 했는지

4. git log — 지금까지의 테이크 목록

각 줄의 앞에 있는 알파벳+숫자 조합(예: d4e5f6g)은 커밋 해시라고 합니다. 각 테이크의 고유 번호와 같습니다. 이 번호로 특정 테이크를 찾을 수 있습니다.

5. git checkout — 이전 테이크로 돌아가기

6. git diff — 이전 테이크와 비교

위 예시에서:

• max_hands가 1에서 2로 변경됨 (손 두 개 추적)
• osc_port가 9000에서 8000으로 변경됨

7. git status — 현재 상태 확인

이 출력의 의미:

• Changes to be committed: 다음 커밋에 포함될 파일 (ARM 된 트랙)
• Changes not staged: 수정됐지만 아직 git add 안 한 파일 (수정했지만 ARM 안 한 트랙)
• Untracked files: Git이 아직 관리하지 않는 새 파일 (프로젝트에 없는 새 트랙)

실전 연습: Git 워크플로우

이제 배운 명령어를 조합하여 실제 작업 흐름을 연습해봅시다.

# main.py
print("Gesture Music Project")
print("MediaPipe + Ableton")

바이브 코딩에서의 Git 습관

Git 명령어 치트 시트

자주 참조할 수 있도록 모든 명령어를 정리합니다:

# 새 프로젝트 시작
git init

# 파일을 스테이지에 올리기
git add 파일이름        # 특정 파일
git add .              # 모든 변경 파일

# 커밋 (테이크 저장)
git commit -m "메시지"

# 히스토리 보기
git log                # 상세 보기
git log --oneline      # 한 줄 요약

# 변경 사항 비교
git diff               # 현재 vs 마지막 커밋
git diff 커밋A 커밋B     # 두 커밋 비교

# 되돌리기
git checkout -- 파일이름   # 파일을 마지막 커밋으로 복원
git checkout 커밋해시      # 특정 커밋으로 이동
git checkout main         # 최신으로 복귀

# 상태 확인
git status