CursorのPlanとAgent、実際にどうやって使い分けるか?

Plan と Agent の公式の違いより、現場で手が止まるポイントに寄せた切り分け。変更範囲と判断の残り方でモードを選ぶ目安と、私がハマったパターンをまとめた。

🙌 結論からいうと

変更が複数ファイルに広がりそうで、まだ「どこをどう触るか」の地図や優先順位が頭の中で確定していないなら Plan。やること・終わり方・触っていい範囲が一文で言い切れるなら Agent。

これが私の実務でのメインの線引きです。

設計書を作る、などはPlan一択です!

なお Tab 補完のような インラインの補助とは別物です。

今回は Plan / Agent のように「まとまった指示を渡す」運用に絞ります。

👀 この記事の前提(Cursor)

以下は Cursor エディタ の Plan / Agent の話です。

Cursor エディタのロゴ。黒背景に立体的な白のアイコンと、白の大文字で CURSOR と表示されている

💡 Plan を選ぶ判断(体感ベース)

Plan の価値は、実装を始める前に 変更の設計 を文章として整理できることです。

以下の場合はPlanがかなり役立ちます。

  • 複数ファイルにまたがるのに、まだ影響範囲の見取りが粗い
  • 要件や制約がまだ言語化しきれてない
  • リファクタや責務分割など、方針の選択が残っている

いきなり Agent で広げると、「動くけど意図とズレた広がり方」をされて、あとから人間が読み解くコストが跳ねることがあります。

計画が100点である必要はないです。

80点の地図を見てから歩き始める、くらいで十分効く場面が多い、というのが実務感覚です 💡

PlanからのAgentが修正・新機能追加でかなり実用的です!

✨ Agent で十分な場面

逆に 単一ファイルや単一画面に閉じる変更既存の型やパターンに沿った小さな修正指示に「この関数をこう」「このテストを足す」と具体が載っているときは Agent の方が速いです。

ここに毎回 Plan を挟むと、丁寧さは増えますが 待ちと確認のオーバーヘッドだけが積み上がる・・・!

私は「もう手は決まってる」と感じた瞬間は躊躇なく Agent に使ってます。

😅 モード以前にプロンプトが雑ということも・・

失敗の多くは Agent に投げすぎなのもありますが、並行して 前提の説明が薄いパターンも多いです。

触ってほしくないディレクトリ、守りたい公開API、優先したい挙動を一言足すだけで、結果のブレはかなり変わります。

「期待と違う」が出たとき、モードが悪かったのではなく、人間側の指示が雑だったケースを、私はわりと経験しています 😅

👍 迷ったときの10秒チェック

実務では、迷ったら次の2つだけ見るようにしています 👍

  • 複数ファイルにまたがりそうか
  • 設計や優先順位の判断が、まだ言葉にできていないか

どちらかがイエスなら Plan 寄り。

どちらもノーなら Agent で試す。

完璧なルールではなく、作業に入る直前の checkとして使うといいかもです。

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌

👀 最後に

Cursor のモードはアップデートで文言や挙動が変わり得ます。

公式の最新ドキュメントと私のリポジトリの慣れをあわせて、上の線引きだけメモに残しておくと、チームに展開するときも話が早いです 👀