> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Git 버전 관리

> 프로젝트를 로컬 Git 저장소로 초기화하고 주요 시점에 스냅숏을 커밋하며 만족스러운 버전으로 언제든 되돌리기

SoloEnt에서는 Git으로 프로젝트 전체(workspace)를 버전 관리할 수 있습니다. 열려 있는 프로젝트를 **로컬 저장소**(인터넷 연결이나 원격 호스팅 불필요)로 초기화하고, 집필 중 단계적 성과를 스냅숏으로 커밋할 수 있습니다. 이후 AI의 후속 변경이 마음에 들지 않으면 프로젝트 전체를 이전의 만족스러운 시점으로 되돌릴 수 있습니다.

## 저장소 초기화

왼쪽 사이드바에서 세 번째 탭(**소스 제어**)을 선택하고 **저장소 초기화** 를 클릭하면 현재 프로젝트를 로컬 Git 저장소로 만들 수 있습니다.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/git_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=8b18c37153ab80763e1c19d6e411af6d" alt="에디터 왼쪽의 소스 제어 탭. chapter-01.md 등 프로젝트 파일과 저장소 초기화 후 사용할 수 있는 자동 Commit 진입점을 표시" style={{ width: '70%' }} width="590" height="646" data-path="assets/images/git_1.png" />

## 변경 사항 커밋

초기화가 완료되면, 작업을 하나 끝낼 때마다 소스 제어 패널에서 이번 변경 사항을 저장소에 커밋(Commit)할 수 있습니다.

<Steps>
  <Step title="변경 사항 확인">
    패널 왼쪽에 이번에 변경된 파일이 나열됩니다(새 파일은 **U** 로 표시).
  </Step>

  <Step title="커밋 메시지 생성">
    패널 오른쪽 상단의 두 번째 아이콘을 클릭해 SoloEnt의 **커밋 내용 요약** 기능으로 Commit Message를 자동 생성합니다.
  </Step>

  <Step title="커밋">
    메시지를 확인하고 **커밋** 을 클릭하면 이번 변경 사항이 하나의 버전 시점으로 저장됩니다.
  </Step>
</Steps>

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/git_2.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=2bb4001d54e2fca84c8496bd3cc0c06e" alt="소스 제어 커밋 화면: 왼쪽은 변경 파일 목록, 오른쪽 상단 커밋 버튼 옆의 자동 아이콘으로 Commit Message 생성" style={{ width: '55%' }} width="740" height="1012" data-path="assets/images/git_2.png" />

## 언제 커밋해야 하나

어떤 버전의 내용이 나중에 유실되거나 망가질까 걱정된다면, **단계적 작업** 을 끝낼 때마다 커밋하는 것을 권장합니다. 예를 들어:

* 책 한 권 분량의 개요 완성
* 처음 10개 챕터 완성
* 큰 설정 변경을 한 번 수행

이렇게 하면 나중에 AI의 변경이 마음에 들지 않을 때, 이전에 커밋한 어떤 시점으로 프로젝트 전체를 되돌려 다시 시작할 수 있습니다.

<Tip>
  커밋이 잦고 단위가 명확할수록, 되돌릴 때 "망가지기 전"의 깨끗한 버전을 찾기가 쉬워집니다.
</Tip>

<CardGroup cols={2}>
  <Card title="컨텍스트와 SOLOENT.md" icon="file-lines" href="/ko/tips/SoloEnt">
    `SOLOENT.md` 와 결합해 프로젝트 전체 그림을 기록하여 새 세션마다 빠르게 컨텍스트 복원
  </Card>

  <Card title="자주 묻는 질문" icon="circle-question" href="/ko/faq">
    Git 설치 안내나 checkpoints 등의 문제는 여기서 확인
  </Card>
</CardGroup>
