> 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/overview.md).

# 全体像とメンタルモデル

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

## このページの内容

Planetz を構成する主要な要素と、それらがどう 1 つのループとしてつながっているかを説明します。このメンタルモデルを押さえると、各画面がそのループのどこを見せているのか理解しやすくなります。

***

## 1 つのループ、5 つの要素

Planetz はチャットボックスではありません。あなたの意図を爆心地の外に安全に置いたまま、エージェントの*艦隊*を通すループです。

```mermaid
flowchart TD
    A["あなた — 意図を述べる<br/>（望むこと／対象外のこと）"] --> B["ハーネス（orbit）<br/>適切なワークフローを自動で選ぶ"]
    B --> C["エージェント艦隊<br/>並列レーンで走り、Git で隔離"]
    C --> D["意図台帳<br/>各決定とその出自を記録し、<br/>あなたの意図に照らしてトレース"]
    D --> E{"結果に反応する<br/>（人間の言葉：違う／取り消し／いいね）"}
    E -->|ratify=承認| F["決定がロックされ、エージェントは黙って書き換えられない"]
    E -->|reverse=撤回| G["意図からワークスペースを再構築"]
    F --> A
    G --> A
```

5 つの要素：

1. **タスクと艦隊。** 実作業をタスクとして投入し、エージェントの一団を並列レーンで走らせる——1 行ずつ書くのではなく、指揮する。→ [マルチエージェント艦隊](/planetz/ja/tonarue/multi-agent.md)
2. **ハーネス（orbit）。** 各タスクは統治されたワークフローの上で走り、Planetz が適切なものへ自動でルーティングする。→ [ハーネス](/planetz/ja/tonarue/harness-governance.md)
3. **意図台帳。** 実行中の各決定を*出自*つきで記録し、あなたが決めたことに照らしてトレースする。ドリフトが可視化される。→ [意図台帳](/planetz/ja/tonarue/intent-ledger.md)
4. **使い捨ての Git ワークスペース。** 実行は隔離・差分可能・復元可能で、コードは意図から再生成できる派生物として扱われる。→ [Git 連携](/planetz/ja/tonarue/git-integration.md)
5. **どこで走るか。** 推論はエッジモデルで手元のマシンに留められ、必要なときに Cloud へスケールする。→ [エッジ AI とデータ主権](/planetz/ja/tonarue/edge-ai.md)

## すべての背後にある 1 つの考え

多くのツールは*走っているコード*を守り、全ステップの承認を求めます。Planetz はその両方を反転させます。

> **コードではなく*****意図*****を守る。** あなたの意図を、ワークスペースの外にある永続的で保護された資産とし、コードは壊して作り直せる安いものにする。すると作業を事前承認するのではなく、起きた後の**結果に反応**し、同意した決定をロックして、将来のどの実行も黙って覆せないようにできる。

だからこそ同じ対象——[意図台帳](/planetz/ja/tonarue/intent-ledger.md)——が、**ドリフトを殺すもの**であると同時に、**非エキスパート**が AI 製システムを仕様どおりに保つことを可能にするものなのです。Planetz の他のすべては、このループを養い、支えるために存在します。

## 画面と要素の対応

| やりたいこと         | 行く画面        | 背後の要素       |
| -------------- | ----------- | ----------- |
| 作業を投入して見る      | タスク Deck    | タスクと艦隊      |
| 走らせる前に着想を練る    | 会話モード       | タスク         |
| 意図を書きトレースする    | Spec Studio | 意図台帳        |
| エージェントの決定をレビュー | Decisions   | 意図台帳        |
| プロセスを見る／定義する   | ワークフロー      | ハーネス        |
| 実行を追う          | ログとサマリー     | ハーネス＋艦隊     |
| モデル・エッジ・連携を選ぶ  | 設定          | エッジ AI＋ハーネス |

## 次に読む

* [意図台帳](/planetz/ja/tonarue/intent-ledger.md) — まずここから。中核の革新です。
* [ハーネス：事前承認しない統治](/planetz/ja/tonarue/harness-governance.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/overview.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.