AI는 만들고, Git은 지킨다: AI 문서 생성과 버전 관리 실험 사례

소개

이번 실습에서는 AI(Claude, Gemini)를 활용한 문서 생성 + Git 기반 버전 관리를 결합하여
👉 AI 협업 환경에서의 생산성과 리스크를 동시에 관리하는 방식을 검증

최근 AI를 활용한 문서 작업이 급격히 증가하고 있지만,

  • 결과의 정확성이 떨어지거나

  • 의도하지 않은 변경이 발생하는 경우가 많았음

이에 따라 단순히 AI를 사용하는 것을 넘어,

“AI의 불완전성을 어떻게 통제할 것인가?”

라는 문제의식을 가지고,
👉 Git을 활용한 ‘되돌릴 수 있는 작업 구조’를 만들기

진행 방법

1. 사용 도구

  • AI 모델: Claude, Gemini

  • IDE: Antigravity (Cursor 계열 AI 코딩 도구)

  • 버전 관리: Git

  • OS 환경: macOS + Homebrew 기반 Git 설치


2. 전체 진행 흐름

1. 프로젝트 폴더 생성
2. Git 초기화 (git init)
3. AI로 문서 생성 (한글)
4. commit (버전 저장)
5. 영어 번역 → commit
6. 중국어 추가 → commit
7. git diff / git log로 변경 확인
8. 특정 시점으로 되돌리기

3. 사용 명령어 (코드 블록)

# Git 시작
git init

# 파일 추적
git add .

# 첫 커밋
git commit -m "initial commit"

# 변경사항 확인
git diff

# 커밋 히스토리 확인
git log

# 특정 커밋으로 이동
git checkout <commit_id>

4. AI 활용 방식 (프롬프트 포함)

① 문서 생성

인공지능(AI)의 현재와 미래에 대해 설명하는 글을 작성해줘.
구성은 다음과 같이 해줘:
1. AI 정의
2. 주요 기술
3. 활용 사례
4. 미래와 과제

👉 Claude / Gemini 각각 실행하여 결과 비교


② 번역 요청

위 내용을 영어로 번역해줘.
위 영어 내용을 중국어로 번역해줘.

③ 수정 요청 (오류 교정)

중국어 문장에 한국어가 섞여 있는 부분을 수정해줘.
무엇이 바뀌었는지도 설명해줘.

5. Git 활용하기

  • Git init 실행 화면

    • 커밋을 시도했더니, 현재 터미널에서 실행한 위치가 Git 저장소가 아니라고 한다.

      검정색 배경에 흑백 바코드 패턴
    • git init이라는 것을 해야 한다고 하셔서 시도. 처음 만든 md 파일을 git에 넣는 작업으로 추정한다. → 찾아보니, 현재 📁폴더📁를 Git이 관리하는 프로젝트(Repository)로 바꾸는 것이었다.

    • 했더니 결과! 잘 된 것 같다..!

  • git log 히스토리

    • 내가 여태 뭘 했더라

    • 이것저것 많이 했네

      컴퓨터 화면에 표시된 한국어 텍스트 스크린샷
  • 시간 여행하기

    • 내가 가장 먼저 만들었던 것 보고 싶다

    • 맞지맞지

      한국어가 포함된 앱의 스크린샷

결과와 배운 점

1. 배운 점

① AI는 빠르지만, 완벽하지 않다

  • 문장 생성 속도는 매우 빠름

  • 하지만:

    • 언어 혼합 발생

    • 의미 왜곡 가능

    • 오타도 “맥락으로 처리”함



② Git은 AI 시대의 필수 도구

Git의 역할을 새롭게 이해하게 됨:

  • Commit → 되돌릴 수 있는 저장 포인트

  • Diff → 변경 검증 도구

  • Log → 작업 이력 관리

👉 특히 중요한 인식 : AI가 실수해도 Git이 있으면 언제든 복구 가능


③ 가장 중요한 구조

AI (생성) → Git (저장) → Diff (검증) → Commit (확정)

👉 이 구조가 생기면서:

  • 작업 속도 유지

  • 리스크 최소화


2. 시행착오

  • git init 없이 commit 시도 → 오류 발생

  • 파일명 오타에도 AI가 강제로 처리 → 예상과 다른 결과 생성

  • 중국어 번역 시 한국어 혼입 발생

  • .bkit 같은 불필요 파일이 Git에 포함됨

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요