> ## 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 バージョン管理

> プロジェクトをローカルリポジトリとして初期化し、重要な節目でスナップショットをコミットし、満足のいくバージョンにいつでも戻す

SoloEnt では、Git を使ってプロジェクト全体（workspace）をバージョン管理できます。開いているプロジェクトを **ローカルリポジトリ**（インターネット接続やリモートホスティングは不要）として初期化し、執筆の途中で段階的な成果をスナップショットとしてコミットできます。その後、AI のその先の変更に満足できなければ、プロジェクト全体を以前の満足していた節目に戻せます。

## リポジトリを初期化する

左サイドバーで 3 番目のタブ（**ソース管理**）を選び、**リポジトリを初期化** をクリックすると、現在のプロジェクトをローカル 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" />

## 変更をコミットする

初期化が完了したら、タスクを 1 つ終えるたびに、ソース管理パネルで今回の変更をリポジトリにコミット（Commit）できます。

<Steps>
  <Step title="変更を確認">
    パネル左側に、今回変化したファイルが一覧表示されます（新規ファイルは **U** と表示）。
  </Step>

  <Step title="コミットメッセージを生成">
    パネル右上の 2 番目のアイコンをクリックし、SoloEnt の **コミット内容の要約** 機能で Commit Message を自動生成します。
  </Step>

  <Step title="コミット">
    メッセージを確認して **コミット** をクリックすると、今回の変更が 1 つのバージョン節目として保存されます。
  </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" />

## いつコミットすべきか

あるバージョンの内容が後で失われたり壊れたりするのが心配なら、**段階的なタスク** を終えるたびにコミットすることをおすすめします。例えば：

* 本 1 冊分のアウトラインが完成したとき
* 最初の 10 章が完成したとき
* 大きな設定変更を 1 回行ったとき

こうしておけば、後で AI の変更に満足できないとき、以前コミットしたある節目にプロジェクト全体を戻して、やり直せます。

<Tip>
  コミットが頻繁で粒度が明確なほど、戻すときに「壊れる前」のきれいなバージョンを見つけやすくなります。
</Tip>

<CardGroup cols={2}>
  <Card title="コンテキストと SOLOENT.md" icon="file-lines" href="/ja/tips/SoloEnt">
    `SOLOENT.md` と組み合わせてプロジェクトの全体像を記録し、新しいセッションごとにすばやくコンテキストを復元
  </Card>

  <Card title="よくある質問" icon="circle-question" href="/ja/faq">
    Git のインストール案内や checkpoints などの問題はこちらで確認
  </Card>
</CardGroup>
