> For the complete documentation index, see [llms.txt](https://planetz.gitbook.io/planetz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://planetz.gitbook.io/planetz/ja/tonarue/git-integration.md).

# Git 連携と使い捨てワークスペース

> Status: 中核となる考え方 · 対象バージョン 0.1.x

## このページの内容

Planetz が Git を使ってエージェントの作業を**隔離・差分可能・復元可能**にする方法——そして、ワークスペースを*使い捨て*として扱うことが、なぜエージェントを自由に走らせることを可能にするのか。

***

## コードは意図の派生物

Planetz を自律的に走らせても安全にする、発想の転換はこうです。

> **守る価値があるのは意図という資産。コードはそこから再生成できる派生物。**

[意図台帳](/planetz/ja/tonarue/intent-ledger.md) があなたの決めたことを保持しているなら、コードで一杯のワークスペースは、捨てて作り直せるものになります。これは安全性の物語全体を組み替えます——エージェントが散らかすのを*防ぐ*ために壁を築くのではなく、ワークスペースを**壊して作り直すのが安い**ものにするのです。

## 隔離：各実行を専用の箱で

Planetz は、あなたが開いたフォルダとは別の**隔離されたリポジトリ**の中でエージェントを走らせます。

* エージェントの実行は、あなたの作業ツリーで直接ではなく、Planetz 管理のクローンで起きる。
* あなた自身のターミナルの Git 設定やグローバルなツールデータは、Planetz の実行と**共有されない**——両者が同じプロジェクトツリーに書き込むことはない。
* 各タスクは自分のレーン（ブランチ）で作業するので、並列エージェントが衝突しない。

結果として、自律実行があなたの大事なリポジトリを黙って壊すことはできません。そもそもその中で動いていないからです。

## 差分可能・復元可能・監査可能

すべてが Git 上で走るため、どの実行も次の性質を持ちます。

* **差分可能** — 何が変わったかを 1 行ずつ正確に見られる。
* **復元可能** — 悪い実行は、後始末する災害ではなく、捨てるブランチに過ぎない。
* **監査可能** — 何が起きたかの履歴が、その実行が記録した決定とともに保存される。

## 復元 ＝ 意図を戻して再生成

何かがうまくいかないとき、Planetz の復元は、個々の編集を手作業で細かく取り消すことではありません。意図が保護された真実源であり、ワークスペースが使い捨てだからこそ、復元モデルはこうです。

> **意図を戻し、作業を再生成する。**

壊れたワークスペースを 1 行ずつ介抱して直す必要はありません——既知の良い状態にリセットし、あなたがロックした意図から艦隊に作り直させます。

## あなたのワークスペースは、あなたの管理下に

Planetz は自身の状態を、開いたワークスペース内のサイドカーに保持し、あなたの既存のプロジェクトデータは実行時に手を触れないものとして扱います。あなたはリポジトリの主導権を保ち、Planetz はそれを乗っ取るのではなく、傍らに統治された実行レイヤを足します。（ディスク上の正確なレイアウトは [用語集](/planetz/ja/rifarensu/glossary.md) に要約。パスを手で管理する必要はありません。）

## 次に読む

* [ハーネス：事前承認しない統治](/planetz/ja/tonarue/harness-governance.md) — これら隔離リポジトリ内の実行がどうゲートされるか。
* [エッジ AI とデータ主権](/planetz/ja/tonarue/edge-ai.md) — モデルもまた、あなたのマシンに留める。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://planetz.gitbook.io/planetz/ja/tonarue/git-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.