プランモードに入る
プランモードに入る方法は 2 つあります:/planコマンド — チャット入力バーに/plan(オプションでタスクの説明を続けて)入力します。エージェントのターンが始まる前に、セッションは即座にプランモードに入ります。空のセッションのサジェスションに Plan チップが表示され、ショートカットとして使用できます。- エージェントによる開始 — 先にプランを立てるよう明示的にリクエストした場合(「まずプランを立てて」「コードを書く前にプランを作成して」)、エージェントが自らプランモードに入ります。通常のリクエストではエージェントは自発的に開始しません。
エージェントができること
プランモードがアクティブな間、セッションは読み取り専用ですが、いくつかの例外があります:| アクション | 許可 |
|---|---|
| ファイルの読み取り、glob、grep | はい |
| explore サブエージェントの生成 | はい |
plan/ 内へのファイル書き込み | はい |
plan/ 外へのファイル書き込み | いいえ |
| シェルコマンドの実行 | 読み取り専用サンドボックス |
| MCP ツール | ブロック |
| セッション変更ツール | ブロック |
plan/ に保存します — 例えば plan/2026-06-12-dark-mode.md。プランは構造化されたフォーマットに従い、ヘッダー(目標、アーキテクチャ、技術スタック)、ファイルリスト、チェックボックス構文(- [ ])を使用した細かいタスクで構成されます。
プランのレビュー
エージェントがプランの作成を完了すると、メッセージリストの下にレビューパネルが表示されます。パネルには以下が表示されます:- レンダリングされたプランの Markdown(折りたたみ可能)
- プランファイルを直接開くリンク
- Approve plan と Request changes ボタン
プランの実装
承認されると、エージェントは固定された規律に従ってプランを実装します:- タスクを順番に処理し、各ステップを正確に実行し、そのステップの検証を省略しません。
- 各ステップが完了するたびに、プランファイルのチェックボックスを更新します(
- [ ]→- [x])。 - プロジェクトが git リポジトリの場合、タスクが完了するたびにコミットします。
- 行き詰まったとき(依存関係の欠如、指示の不明確さ、検証が繰り返し失敗するなど)には、推測せずに停止してあなたに確認します。
- 最後のタスクの後、影響を受ける範囲のテストと lint を実行し、構築した内容を要約します。
保存済みプランの実行
以前に保存したプラン(別のセッション、または元のセッションを閉じた後)を実装することもできます。/plan execute に続けてプランのパスを入力します(run エイリアスも使用できます):
進捗トラッキング
プランを承認すると(または/plan execute で実行すると)、メッセージの下に進捗バーが表示されます。エージェントが各ステップを完了するたびに、プランファイルのチェックボックスを更新し(- [ ] → - [x])、バーが完了数/合計数をリアルタイムで更新します。
進捗バーにはプランのタイトル(最初の # 見出しから取得)、フィルバー、プランファイルを開くリンクが表示されます。不要になったら × をクリックして閉じることができます。
進捗はセッションの切り替えやアプリの再起動後も保持されます。
プランモードの終了
プランを承認すると、プランモードは自動的に終了します。手動で終了することもできます:/plan exit(または/plan off、/plan cancel、/plan stop、/plan quit)と入力- インジケーターバーの Exit plan mode をクリック