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

# プランモード

> エージェントがコードを変更する前に、実装プランを作成してレビューする

プランモードは、セッションを読み取り専用状態にして、エージェントがコードベースを調査し実装プランを作成できるようにします。変更は一切行われません。プランをレビューし、承認または変更をリクエストしてから、エージェントがコーディングを開始します。

## プランモードに入る

プランモードに入る方法は 2 つあります：

* **`/plan` コマンド** — チャット入力バーに `/plan`（オプションでタスクの説明を続けて）入力します。エージェントのターンが始まる前に、セッションは即座にプランモードに入ります。空のセッションのサジェスションに **Plan** チップが表示され、ショートカットとして使用できます。
* **エージェントによる開始** — 先にプランを立てるよう明示的にリクエストした場合（「まずプランを立てて」「コードを書く前にプランを作成して」）、エージェントが自らプランモードに入ります。通常のリクエストではエージェントは自発的に開始しません。

```
/plan 設定ページにダークモードサポートを追加
```

## エージェントができること

プランモードがアクティブな間、セッションは読み取り専用ですが、いくつかの例外があります：

| アクション               | 許可            |
| ------------------- | ------------- |
| ファイルの読み取り、glob、grep | はい            |
| explore サブエージェントの生成 | はい            |
| `plan/` 内へのファイル書き込み | はい            |
| `plan/` 外へのファイル書き込み | いいえ           |
| シェルコマンドの実行          | 読み取り専用サンドボックス |
| MCP ツール             | ブロック          |
| セッション変更ツール          | ブロック          |

プランモード中に生成されたサブエージェントは同じ制限を引き継ぎます。

エージェントはプロジェクトを調査し、Markdown プランを `plan/` に保存します — 例えば `plan/2026-06-12-dark-mode.md`。プランは構造化されたフォーマットに従い、ヘッダー（目標、アーキテクチャ、技術スタック）、ファイルリスト、チェックボックス構文（`- [ ]`）を使用した細かいタスクで構成されます。

## プランのレビュー

エージェントがプランの作成を完了すると、メッセージリストの下にレビューパネルが表示されます。パネルには以下が表示されます：

* レンダリングされたプランの Markdown（折りたたみ可能）
* プランファイルを直接開くリンク
* **Approve plan** と **Request changes** ボタン

**Approve** はプランモードを終了し、エージェントが承認されたプランの実装を開始します。

**Request changes** はフィードバックテキストエリアを開きます。変更すべき内容を記述して送信すると、エージェントがプランファイルを修正し、再度承認をリクエストします。

## プランの実装

承認されると、エージェントは固定された規律に従ってプランを実装します：

* タスクを順番に処理し、各ステップを正確に実行し、そのステップの検証を省略しません。
* 各ステップが完了するたびに、プランファイルのチェックボックスを更新します（`- [ ]` → `- [x]`）。
* プロジェクトが git リポジトリの場合、タスクが完了するたびにコミットします。
* 行き詰まったとき（依存関係の欠如、指示の不明確さ、検証が繰り返し失敗するなど）には、推測せずに停止してあなたに確認します。
* 最後のタスクの後、影響を受ける範囲のテストと lint を実行し、構築した内容を要約します。

## 保存済みプランの実行

以前に保存したプラン（別のセッション、または元のセッションを閉じた後）を実装することもできます。`/plan execute` に続けてプランのパスを入力します（`run` エイリアスも使用できます）：

```
/plan execute plan/2026-06-12-dark-mode.md
```

これは通常の読み書きセッションで実行され、プランモードには**入りません**。エージェントはまずプランを読み込んで批判的にレビューし、開始前に不足点があれば確認したうえで、承認済みプランと同じ規律で実装します。パスはプロジェクトルートからの相対パスです。ファイルが存在しないかプロジェクト外にある場合、CTOR は通知を表示し、ターンを開始しません。

## 進捗トラッキング

プランを承認すると（または `/plan execute` で実行すると）、メッセージの下に進捗バーが表示されます。エージェントが各ステップを完了するたびに、プランファイルのチェックボックスを更新し（`- [ ]` → `- [x]`）、バーが完了数/合計数をリアルタイムで更新します。

進捗バーにはプランのタイトル（最初の `#` 見出しから取得）、フィルバー、プランファイルを開くリンクが表示されます。不要になったら **×** をクリックして閉じることができます。

進捗はセッションの切り替えやアプリの再起動後も保持されます。

## プランモードの終了

プランを承認すると、プランモードは自動的に終了します。手動で終了することもできます：

* `/plan exit`（または `/plan off`、`/plan cancel`、`/plan stop`、`/plan quit`）と入力
* インジケーターバーの **Exit plan mode** をクリック

終了すると、保留中の承認リクエストがキャンセルされ、完全な読み書きアクセスが復元されます。