ToolArc

ブログ記事

  • Cursor
  • Planモード
  • AIワークフロー
  • 実装Tips
  • 初心者向け

CursorのPlan出力は.plan.mdで保存すると実装がぶれない

"Cursor Plan Modeの出力をそのままbuildすると、後から「何を計画していたか」を振り返れなくなることがあります。.plan.mdとして保存し、スコープ確認と実装後のメモをセットにする運用を実測ベースで解説します。"

Cursor のPlan Modeで実装方針を出してもらい、その場で確認してbuildする——それ自体は良い流れですが、チャット画面に出た計画は時間が経つとさかのぼりにくくなります。複数のページやタスクを続けて実装していると、「あのときの計画、結局どんな内容だったか」を思い出せなくなった経験はないでしょうか。

build前にPlanの文言をその場で直す手順は、CursorのPlanモードはbuild前にPlanを修正できるで扱っています。本記事は、Planを.plan.mdとしてプロジェクト内に残し、実装後も振り返れるようにする運用に絞ります。

筆者はこの状態を防ぐために、Planの出力をチャット上で完結させず、プロジェクト内の.plan.mdとして保存するようにしました。今回はその手順を実測ベースで整理します。

今日の結論

  • Plan Modeの出力は.plan.mdとして保存すると、あとから再現・レビューしやすい
  • 実装前に計画をファイル化しておくと、スコープが広がりすぎる「暴走」を防ぎやすい
  • 完了後にplanと実装差分をメモしておくと、次のタスクの精度も上がる

なぜPlanの出力をmdファイルに保存するのか

Plan Modeの出力はチャットの流れの中に埋もれてしまいがちです。1つのタスクだけならその場の確認で十分ですが、複数のページや修正を続けて依頼していると、後になって「このファイルはどの計画に基づいて変更したものか」が分からなくなることがあります。

そこで、Planが出た時点でプロジェクト内の.mdファイルとして保存しておくと、実装前の確認材料としても、後から見返す記録としても使えるようになります。特にWeb制作のように複数ページ・複数タスクを順番に実装していく場合は、保存しておく効果を感じやすい印象です。

手順|Plan出力を.plan.mdとして保存する5ステップ

  1. CursorでPlan Modeを開始する 実装したい内容を伝え、まずは実行計画だけを出してもらいます。
  2. 生成されたPlanをプロジェクト内の.mdに保存する .plan.mdのような分かりやすいファイル名で、対象のタスクごとに保存します。
  3. 計画を読み、スコープ過大でないか確認する 変更範囲が広すぎないか、想定外のファイルまで含まれていないかをこの時点でチェックします。
  4. Agent/実装モードではplanの範囲内で依頼する 保存したPlanを基準にし、範囲を超える変更が入らないよう意識して依頼します。
  5. 完了後にplanと実装差分をメモする 「計画通りだったか」「途中で変わった点はどこか」を簡単に書き残しておきます。

つまずきやすいポイント|保存だけでは暴走は防げない

.plan.mdとして保存すること自体は簡単ですが、保存しただけで満足してしまうと効果が薄くなります。保存したPlanを実装前に読み直し、スコープを確認する工程とセットにして初めて、意図しない広がった変更を防ぎやすくなります。

❌ 効果が出にくい使い方

Planを保存だけして、内容を確認せずにそのままAgentへ依頼する

✅ 効果を感じやすい使い方

保存したPlanを読み直し、「このファイルは今回の範囲外」と判断してから依頼する

また、実装後にplanと実際の差分を見比べる工程を省略すると、次に似たタスクを依頼するときの改善につながりにくくなります。保存だけでなく、前後の確認までを一つの流れとして扱うのがポイントです。

チェックリスト|Plan保存を運用に取り入れる前に

項目確認内容
保存の習慣化Plan Modeの出力を.plan.mdとして毎回保存しているか
スコープ確認実装前に変更範囲が広すぎないか確認したか
依頼の範囲Agent/実装モードでplanの範囲内に依頼を絞ったか
差分メモ完了後にplanと実装の差分を書き残したか
ファイル名の一貫性タスクごとにPlanファイルを見分けられる命名にしているか

まとめ|次に読む

  • Plan Modeの出力は.plan.mdとして保存すると、後から振り返りやすくなる
  • 保存とスコープ確認をセットにすることで、意図しない広がった変更を防ぎやすい
  • 完了後の差分メモが、次のタスク依頼の精度を上げる材料になる

build前にPlanの内容そのものをどう確認・修正するかは、以下の記事も参考になります。

免責: 本記事の内容は2026-07-06時点の運用に基づく実測メモです。CursorのPlan Modeの仕様・挙動は変更される可能性があるため、最新情報は公式ドキュメントでご確認ください。