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

# マルチエージェント艦隊

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

## このページの内容

なぜ Planetz が 1 つのチャットスレッドではなく、エージェントの*一団*を中心に作られているか。そして、作業を並列レーンで走らせることが、あなたの仕事を「入力」から「指揮」へどう変えるか。

***

## 1 つのチャット窓から Deck へ

単体のチャットアシスタントは、1 つの会話の中で一度に 1 つのことをします。Planetz は**艦隊**を走らせます——複数の自律エージェントが、それぞれ自分のレーンで自分のタスクに取り組み、すべてが 1 つの Deck 上に見えます。

> あなたの役割は、*1 行ずつ書くこと*から、**艦隊を指揮すること**——レビュー・舵取り・承認——へと移り、作業は並列で進みます。

Deck は艦隊を一目で示します——何体のエージェントが稼働中で、各々が今何をしているか。

## エージェントには役割がある

作業は、1 人の万能型が全部やるのではなく、専門化された役割に分かれます。代表的な役割は：

* **Planner** — タスクを計画に変える。
* **Coder** — 変更を加える（隔離されたレーン／ブランチで）。
* **Reviewer** — 作業を意図と品質基準に照らして検査する。
* **Tester** — テストを走らせ再現する。

この **maker–checker（作る者・確認する者）** の分離は意図的です。コードを書くエージェントが、それを判断する唯一のエージェントではない。分離こそが、自律実行を誠実に保ちます。

## レーンと並列性

走っている各タスクは、自分の隔離されたレーン——自分のブランチとワークスペース——を持つので、エージェント同士がぶつかりません。多数を同時に走らせ、独立して進めさせられます。各エージェントはライブな状態を報告します。

| 状態            | 意味                    |
| ------------- | --------------------- |
| **idle**      | 待機中、アクティブなタスクなし       |
| **working**   | タスクを実行中               |
| **reviewing** | 作業を検査中（maker–checker） |
| **waiting**   | ブロック中——多くは人間ゲート待ち     |
| **error**     | 実行が問題に当たり、対応が必要       |

この単一の状態語彙は、任意の **Manta** デスクトップロボが話すのと同じ言語なので、艦隊の状態を一目で——画面でも機器でも——感じ取れます。[エッジ AI とデータ主権](/planetz/ja/tonarue/edge-ai.md) と [Planetz の独自性](/planetz/ja/naze-planetz-ka/how-planetz-is-different.md) を参照。

## 自分のエージェントを持ち込める

艦隊は Planetz 組み込みのランタイムに限りません。外部エージェント——たとえば **Cursor**——も Deck に加わって状態を push できるので、組み込みと外部の混成艦隊を、同じ場所から見て統治できます。

## なぜ艦隊に台帳が要るか

並列性は危険を増幅します——複数のエージェントが、複数のレーンで、それぞれ黙って決定を下す。共有された記録がなければ、それらの決定は決して照合されず、プロダクトは漂流します。だからこそ艦隊は、[意図台帳](/planetz/ja/tonarue/intent-ledger.md) と組んだときにだけ、その約束を果たします——すべてのエージェントの決定が 1 か所に集まり、1 つの意図に照らしてトレースされ、衝突を見て、同意した判断をロックできるのです。

## 製品のどこで見るか

* [**タスク Deck**](/planetz/ja/gotono/task-deck.md) — 作業を投入し、艦隊を見る。
* [**実行ログとサマリー**](/planetz/ja/gotono/logs-and-summary.md) — 個々のエージェントの実行を詳細に追う。

## 次に読む

* [ハーネス：事前承認しない統治](/planetz/ja/tonarue/harness-governance.md) — 艦隊が走る、そのワークフロー。
* [Git 連携と使い捨てワークスペース](/planetz/ja/tonarue/git-integration.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/multi-agent.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.