CursorのPlanとAgent、実際にどうやって使い分けるか？迷ったら見る2つのポイント
🙌 結論からいうと
変更が複数ファイルに広がりそうで、まだ「どこをどう触るか」の地図や優先順位が頭の中で確定していないなら Plan。やること・終わり方・触っていい範囲が一文で言い切れるなら Agent。
これが私の実務でのメインの線引きです。
設計書を作る、などはPlan一択です！
なお Tab 補完のような インラインの補助とは別物です。
今回は Plan / Agent のように「まとまった指示を渡す」運用に絞ります。
👀 この記事の前提（Cursor）
以下は Cursor エディタ の Plan / Agent の話です。
💡 Plan を選ぶ判断（体感ベース）
Plan の価値は、実装を始める前に 変更の設計 を文章として整理できることです。
以下の場合はPlanがかなり役立ちます。
- 複数ファイルにまたがるのに、まだ影響範囲の見取りが粗い
- 要件や制約がまだ言語化しきれてない
- リファクタや責務分割など、方針の選択が残っている
いきなり Agent で広げると、「動くけど意図とズレた広がり方」をされて、あとから人間が読み解くコストが跳ねることがあります。
計画が100点である必要はないです。
80点の地図を見てから歩き始める、くらいで十分効く場面が多い、というのが実務感覚です 💡
PlanからのAgentが修正・新機能追加でかなり実用的です！
✨ Agent で十分な場面
逆に 単一ファイルや単一画面に閉じる変更、既存の型やパターンに沿った小さな修正、指示に「この関数をこう」「このテストを足す」と具体が載っているときは Agent の方が速いです。
ここに毎回 Plan を挟むと、丁寧さは増えますが 待ちと確認のオーバーヘッドだけが積み上がる・・・！
私は「もう手は決まってる」と感じた瞬間は躊躇なく Agent に使ってます。
😅 モード以前にプロンプトが雑ということも・・
失敗の多くは Agent に投げすぎなのもありますが、並行して 前提の説明が薄いパターンも多いです。
触ってほしくないディレクトリ、守りたい公開API、優先したい挙動を一言足すだけで、結果のブレはかなり変わります。
「期待と違う」が出たとき、モードが悪かったのではなく、人間側の指示が雑だったケースを、私はわりと経験しています 😅
👍 迷ったときの10秒チェック
実務では、迷ったら次の2つだけ見るようにしています 👍
- 複数ファイルにまたがりそうか
- 設計や優先順位の判断が、まだ言葉にできていないか
どちらかがイエスなら Plan 寄り。
どちらもノーなら Agent で試す。
完璧なルールではなく、作業に入る直前の checkとして使うといいかもです。
🔧 Plan で出てきた計画のチェックポイント
Plan を使うなら、出てきた計画をそのまま実行しないのが大事です！
私は実行する前に、ここだけは必ず見ています👀
- 触るファイルの一覧: 想定より多くないか。関係ないファイルが入っていたら、その時点で外す
- 作業の順番: 先にマイグレーション、次にモデル、最後に画面、のように順番が自然か
- テストの計画: どのテストを足すか、既存のテストのどれを通すかが書いてあるか
- やらないことがはっきりしているか: 「今回はリファクタリングしない」のような範囲の線引き
おかしいところがあれば、実行する前に計画のほうを直してもらいます。
実行してから直すより、計画の段階で直すほうが圧倒的にラクです・・！
特に「触るファイルの一覧」は、ここを見るだけで、エージェントが話を正しく理解しているかがだいたい分かります(^^)
パパ系Webエンジニア〜愛用ガジェット一覧 🛍️
AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌
👀 最後に
Cursor のモードはアップデートで文言や挙動が変わり得ます。
公式の最新ドキュメントと私のリポジトリの慣れをあわせて、上の線引きだけメモに残しておくと、チームに展開するときも話が早いです 👀