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

プランモードに入る

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

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

プランモードがアクティブな間、セッションは読み取り専用ですが、いくつかの例外があります:
アクション許可
ファイルの読み取り、glob、grepはい
explore サブエージェントの生成はい
plan/ 内へのファイル書き込みはい
plan/ 外へのファイル書き込みいいえ
シェルコマンドの実行読み取り専用サンドボックス
MCP ツールブロック
セッション変更ツールブロック
プランモード中に生成されたサブエージェントは同じ制限を引き継ぎます。 エージェントはプロジェクトを調査し、Markdown プランを plan/ に保存します — 例えば plan/2026-06-12-dark-mode.md。プランは構造化されたフォーマットに従い、ヘッダー(目標、アーキテクチャ、技術スタック)、ファイルリスト、チェックボックス構文(- [ ])を使用した細かいタスクで構成されます。

プランのレビュー

エージェントがプランの作成を完了すると、メッセージリストの下にレビューパネルが表示されます。パネルには以下が表示されます:
  • レンダリングされたプランの Markdown(折りたたみ可能)
  • プランファイルを直接開くリンク
  • Approve planRequest 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 をクリック
終了すると、保留中の承認リクエストがキャンセルされ、完全な読み書きアクセスが復元されます。