Cursor Plan Mode 完全ガイド｜「いきなり書かせる」をやめると開発が変わる

AIコーディングツールを使っていて、こんな経験はないでしょうか。

• Agentモードで「この機能を追加して」と投げたら、意図と全然違うコードが返ってきた
• 修正指示を出すたびに泥沼にはまり、最初からやり直した方が早かった
• 生成されたコードは動くが、設計がぐちゃぐちゃで後から直せない

これらはすべて、「設計を固める前に実装を始めた」ことで起きる問題です。Cursorの Plan Mode は、この課題を根本から解決するために設計されたモードです。

Plan Modeとは？コードを書かないAIの使い方

Plan Modeは、Cursorが2025年10月に導入した実装計画専用モードです。一言で言えば、「コードを書く前に、AIと一緒に設計を固める」 ための仕組みです。

通常のAgentモードがいきなりファイルを編集するのに対して、Plan Modeはまず次のプロセスを踏みます。

1. 補足質問 — エージェントが要件の曖昧な部分を確認してくる
2. コードベースの調査 — 関連するファイルや既存の実装を自動で探索する
3. 実装計画の生成 — ファイルパスやコード参照を含む詳細なプランをMarkdownで作成
4. レビューと編集 — 人間がプランを確認・修正してから実行を承認する
5. Build（実行） — 承認したら「Build」ボタンで実際の実装に移る

ポイントは「4番のレビュー」にあります。AIが一方的に実装するのではなく、人間が計画を確認・修正してからGOサインを出す。この一手間が、コードの質を大きく変えます。

Plan Modeの起動方法

チャット入力欄で Shift + Tab を押すだけです。モードのドロップダウンから「Plan」を選ぶこともできます。

複雑なタスクに関するキーワードを入力すると、Cursorが自動的にPlan Modeを提案することもあります。

こんなときに使う：Plan Modeが効くシーン

公式ドキュメントでは、以下のケースで特に効果的とされています。

複数の実装方法が考えられる複雑な機能 : たとえば認証機能を追加する場合、JWT・セッション・OAuth など選択肢が複数あります。Plan Modeでアプローチを先に確定することで、実装ブレを防げます。

多くのファイルやシステムにまたがるタスク : 大規模なリファクタリングや、複数のモジュールをまたぐ機能追加。影響範囲を先に可視化することで、見落としや手戻りを減らせます。

要件があいまいで、まずスコープを把握したいとき : 「なんとなくこういう機能が欲しい」というふんわりした指示でも、AIが補足質問で要件を整理してくれます。

アーキテクチャ上の判断を先にレビューしたいとき : 「どのレイヤーにロジックを置くか」「どのライブラリを使うか」といった設計判断を、コードを書く前に確認できます。

逆に、小さな変更や繰り返し行っている定型タスクであれば、最初からAgentモードに進んで問題ありません。Plan Modeはすべてに使うのではなく、「複雑さ」や「あいまいさ」を感じた時に使うのがコツです。

プランの保存と活用

Plan Modeで生成された計画は、デフォルトではホームディレクトリに一時ファイルとして作成されます。「Save to workspace」をクリックすると、.cursor/plans/ フォルダに保存されます。

これにより：

• チーム共有 — チームメンバーが設計意図を確認できる
• ドキュメント化 — なぜその実装を選んだか、経緯が残る
• 作業の再開 — 途中で中断しても、計画から簡単に再開できる
• 将来のエージェントへのコンテキスト — 同じ機能に取り組む次のエージェントへの引き継ぎになる

プランはMarkdownファイルなので、直接編集して不要なステップを削ったり、AIが見落としたコンテキストを追記したりすることも簡単です。

Plan → Agent：黄金パターンの実践例

❌ やりがちな失敗パターン

[Agentモードで]
「ユーザー認証機能を追加して」

→ 認証ロジック・セッション管理・エラーハンドリングが混在したコードが生成される。後から直すのに時間がかかる。

✅ Plan Modeを使う場合

Step 1：Plan Modeで要件を整理する

[Shift+TabでPlan Modeに切り替えて]
「ユーザー認証機能を追加したい。
 要件：メール＋パスワードでのログイン、セッション管理、
      エラーハンドリング、テストコード」

AIが補足質問を返してきます（例：「既存の認証基盤はありますか？」「セッションの保存先はどこですか？」）。回答すると、こんな計画が生成されます。

## 実装計画：ユーザー認証機能

### ステップ1：認証コントローラーの作成
- POST /login エンドポイント
- POST /logout エンドポイント

### ステップ2：認証サービスの作成
- パスワードハッシュ照合ロジック（認証コントローラーから分離）

### ステップ3：セッション管理ミドルウェアの実装
- セッションの生成・検証・破棄

### ステップ4：エラーハンドリング
- 認証失敗・セッション切れの例外処理

### ステップ5：テストコードの作成
- 各エンドポイントのユニットテスト

Step 2：プランをレビューして修正する

「ステップ4の前に、入力値バリデーションのステップを追加してほしい」など、自分の観点で計画を修正します。

Step 3：Buildボタンで実装する（Agentモード）

計画に満足したら「Build」をクリック。明確な設計図があるので、Agentが迷わず実装を進めます。

さらに実践的なアドバイスとして、ステップをまとめて実行するのではなく、1〜2ステップずつ実行して動作確認することをおすすめします。これにより、問題の特定が早くなり、コードへの理解も深まります。

うまくいかないときの対処法：プランに戻る

Agentが意図と合わない実装を始めた場合、追加プロンプトで修正しようとするのは悪手です。

正しい対処法：

1. Stopをクリックして処理を停止する
2. 変更を元に戻す（Undo）
3. Plan Modeに戻って、より具体的な条件を追記する
4. もう一度Buildを実行する

これは一見遠回りに見えますが、「進行中のAgentを修正指示で誘導する」よりも、最終的に速く・きれいな結果が得られます。

大きな変更ほど、正確でスコープが明確なプラン作成に時間をかけることが重要です。難しいのは「何を作るか（What）」を見極めることです。適切な指示さえ書けば、「どう作るか（How）」はAgentに任せられます。

Cursorの4つのモードと使い分け

Plan Modeをより効果的に使うために、4つのモードの役割を整理しておきましょう。

判断のポイントは「このタスクは1ファイルで完結するか？設計が明確か？」という自問です。どちらかがNoなら、Plan Modeから始めるのがおすすめです。

僕の場合、いきなり Agent モードで修正を指示することは少ないです。基本的にプランモードにすることで、同時に作業内容の整理もできるのでまずはPlanで全体像を確認してから進めた方がやり直しが少なくて済みます。

よくある失敗パターンと回避策

計画を過信してしまう

計画はあくまで「仮説」です。実装中に「ステップ3の前にステップ5が必要だ」と気づいたら、計画を修正してから進めましょう。計画に縛られて非効率な実装を続けるのは本末転倒です。

計画が細かすぎる

「このファイルの何行目にこう書いて」という粒度まで計画に落とすと、実装の柔軟性を失います。計画の粒度は「コンポーネント・機能単位」程度が適切で、細かい実装方法はAgentに任せましょう。

単純なタスクにまで使ってしまう

変数名の変更や1行の修正などにPlan Modeを使うと、かえって非効率です。単純なタスクはAgentモードで直接進める判断も重要です。

Askモードを飛ばしてPlan Modeを使う

既存のコードベースをAskモードで理解してからPlan Modeで設計する、というフローが理想的です。既存実装を把握せずに計画を立てると、重複実装や不整合が起きやすくなります。

最新情報：2026年のPlan Modeとモデル選択

2026年2月現在、CursorではPlan Modeに使うモデルの選択も重要になっています。

• 日常的なPlan作成：Composer 1.5 / Auto（高速・低コスト・Cursorに最適化）
• 複雑なアーキテクチャ設計：Claude Opus 4.6（SWE-rebenchで1位、1Mトークンのコンテキストに対応）

Cursor独自モデルの「Composer 1.5」は、Cursorのツール（ファイルエディタ・ターミナル・検索）の中で直接訓練されているため、日常の計画・実装タスクとの親和性が特に高いです。

まとめ：「設計してから書かせる」思考へ

Plan Modeの本質は、AIに「いきなり書かせる」のをやめることです。

• 要件があいまいなまま実装させない
• AIの判断を盲目的に信じず、レビューする機会を作る
• 問題が起きたら実装を追いかけず、プランに戻る

この意識を持つだけで、AIコーディングの質と効率は大きく変わります。「Agentが暴走した」「やり直しが多い」と感じている方は、ぜひPlan Modeを試してみてください。

Plan Modeの起動：チャット入力欄で Shift + Tab

参考：Cursor公式ドキュメント、Reddit r/BuildToShip