⚡

AI開発の9割は準備！Cursorで爆速コーディングする仕組み

に公開
AI
VS Code
開発環境
生産性
Cursor
tech

⚠️ 重要なお知らせ（2025年12月更新）

.cursorrules は廃止予定です。新形式に移行してください。

Cursorは新しい「Project Rules」形式（.cursor/rules/*.mdc）を推奨しています。

  • 従来の .cursorrules は廃止予定
  • この記事では新形式のみを解説します

はじめに

Cursorとは？

Cursorは、AIを活用したコードエディタです。VSCodeをベースに、ChatGPTのような対話型AIがコーディングをサポートしてくれます。

  • 公式サイト：https://cursor.com/
  • コードの生成、リファクタリング、バグ修正などをAIに依頼できる
  • 「こういう機能を実装して」と自然言語で指示するだけでコードが生成される

「Cursor便利すぎる！これからはAIに任せよう！」

...と思って使い始めたものの、こんな経験はありませんか？

トークン消費の罠

「便利だからたくさん使っていたら、あっという間にトークンの上限に来てしまった」

実は、何も準備しないでただ作ってもらうだけだと、知らないうちにトークン消費がすごいことになっていることがあります。

  • 1回の質問で数万トークンを消費
  • プロジェクト全体を毎回スキャン
  • 不要なビルドファイルまで読み込む
  • 気づいたら月の上限到達...

でも、その無駄なトークン消費を抑える秘策があります！

準備が9割

私は実務でCursorを3ヶ月使い続けて、コーディング速度が劇的に向上しました。
そこで見つけたのが、**「準備が9割」**という考え方です。

今回紹介する仕組みを導入したところ：

  • トークン消費：88%削減（40,000トークン → 5,000トークン）
  • 応答時間：75%短縮（10-15秒 → 2-3秒）
  • 回答精度：劇的に向上（的確な提案が即座に返ってくる）

この記事では、実務で効果が出た具体的なテクニックを、実例付きで解説します。

1. Project Rules と AGENTS.md で"手順書"を与える

すぐにできるアクション

Cursorに丸投げするだけ。たったこれだけです。

Step 1: Cursorにプロジェクトを分析してもらう（5分）

このプロジェクトを分析して、最適な Project Rules と AGENTS.md の構成を提案してください。

【目的】
次回以降のコード作成時に、AIがこの情報を自動的に参照して、
既存のルールやパターンを使いまわせるようにする。

【含めてほしい内容】
1. プロジェクトの規模と技術スタック
2. .cursor/rules/ に作成すべきファイルとその内容
3. AGENTS.md の推奨構造
4. よく使うファイルのパスや命名規則

Cursorが最適な構成を提案してくれます。

Step 2: 提案された内容を確認して作成してもらう（10分）

提案された構成で、実際にファイルを作成してください。

【重要】
次回以降、「既存のルールに従って○○を作成して」と指示するだけで、
このルールを自動的に参照して作成できるようにしてください。

Cursorが自動的にファイルを作成してくれます。

たったこれだけで、トークン消費88%削減を実現できます。

なぜこれが効果的なのか？

「一回走査して理解したことを、2度とやらないため」

Cursorは何も設定しないと：

  • 毎回プロジェクト全体を走査
  • 「このプロジェクトはどんな構造？」を毎回理解し直す
  • 不要なビルドファイル（node_modules/等）まで読み込む
  • 結果、膨大なトークンを消費

Project Rules と AGENTS.md の役割:

ファイル 役割 例え
Project Rules AIが常に参照する基本情報 ホテルの「ご利用案内」
AGENTS.md プロジェクト構造の目次・地図 各階の「フロアマップ」

ホテルに例えるとわかりやすい

Project Rules = ご利用案内（チェックイン時に必ず渡される基本情報）

  • ホテルの基本情報、利用ルール
  • よく使う施設の場所
  • 全体の構造概要

→ Cursorが常に参照する基本情報

AGENTS.md = フロアマップ（各階に置いてある詳細な見取り図）

1階（フロント）: /AGENTS.md

  • 「2階は客室、3階はスイート、地下は大浴場」
  • 次に見るべきフロアマップへの案内

2階のフロアマップ: 2F/AGENTS.md

  • 201-210号室の配置
  • トイレ、自販機、非常口の位置
  • 各部屋の設備一覧（表形式）

→ 必要な場所の詳細を段階的に確認

実際の動き:

1. AIがプロジェクトに入る（チェックイン）
   ↓
2. Project Rules を読む（ご利用案内）
   「このホテルのルールは○○、大浴場は地下」
   ↓
3. /AGENTS.md で全体把握（フロント案内板）
   「客室を探したい → 2階へ」
   ↓
4. 必要な階の AGENTS.md で詳細確認（フロアマップ）
   「205号室はこちら、トイレは右手」
   ↓
5. 該当ファイルのみ読み込む（目的の部屋へ直行）

この仕組みで、トークン消費88%削減を実現しました。

実際の効果：中規模Webプロジェクトでの事例

私が担当したプロジェクト（約300ファイル）での比較：

Before（設定なし）:

  • 毎回プロジェクト全体をスキャン
  • 不要なビルドファイルまで読み込む
  • 1回の質問で約40,000トークン消費
  • 応答時間：10-15秒

After（設定あり）:

1. Project Rules 自動読み込み（1,000トークン）
2. /AGENTS.md 参照（2,000トークン）
3. 必要なサブディレクトリのAGENTS.md（1,500トークン）
4. 該当ファイルのみ読み込み（500トークン）

合計: 約5,000トークン
削減率: 87.5%
応答時間: 2-3秒

📊 実測データ：どれくらい効果があるのか

実際のプロジェクトで測定した、設定前後の比較データです。

プロジェクト概要（匿名化）

  • 規模: 中規模Webアプリケーション
  • ファイル数: 300+ファイル
  • 技術スタック: モダンなフロントエンド環境
  • 開発期間: 約3ヶ月

トークン消費の比較

操作 Before After 削減率
コンポーネント編集 40,000 5,000 87.5%
スタイル編集 35,000 4,000 88.6%
新規ファイル追加 30,000 3,500 88.3%
ビルド設定確認 25,000 3,000 88.0%
平均 32,500 3,875 88.1%

応答時間の比較

操作 Before After 短縮率
簡単な質問 5-8秒 1-2秒 70-80%
複雑な質問 10-15秒 2-3秒 75-85%
コード生成 15-20秒 3-5秒 75-80%

定性的な効果

Before（設定前）の問題:

  • ❌ 毎回プロジェクト全体をスキャン
  • ❌ 不要なビルドファイルまで読み込む
  • ❌ 「このプロジェクトは○○です」と毎回説明
  • ❌ AIが混乱して的外れな回答

After（設定後）の改善:

  • ✅ 必要な情報だけを段階的に取得
  • ✅ ビルドファイルを自動で除外
  • ✅ コンテキストの再説明が不要
  • ✅ 的確な回答が即座に返ってくる

投資対効果（ROI）

初期投資:

  • Cursorに分析依頼: 5分
  • Cursorに作成依頼: 10分
  • 合計: 約15分

効果:

  • トークン消費88%削減 → コスト削減
  • 応答時間75%短縮 → 開発速度向上
  • 初日から効果を実感

たった15分の投資で、即座に効果が出ます。

まとめ

Cursor の効率化は、「準備が9割」 です。

そして、その準備もCursorに丸投げできます。

今回紹介した仕組み：

Project Rules と AGENTS.md で手順書を与える

  • 「一回走査して理解したことを、2度とやらないため」
  • Cursorに「最適な構成を提案して」→「作って」と依頼するだけ
  • トークン消費88%削減を実現

たった15分の設定で、劇的な効率化が実現します。

ぜひ、今日から試してみてください！

🔧 重要：ルールのメンテナンス

Project Rules と AGENTS.md を作ったら終わり...ではありません。

プロジェクトが進化すれば、ルールも進化させる必要があります。

実践的なメンテナンス方法

改修の度に「このルールを追加すべきか？」を検証する

開発中に気づいた重要なルール・パターンがあったら：

  1. Cursorに聞く

    今回の改修で追加した〇〇のルールは、Project Rules に追加すべきですか？
追加する場合、どのファイルにどう書くべきか提案してください。

  2. 提案を確認

    • 本当にプロジェクト全体で使えるルールか？
    • 一時的なものではないか？

  3. 追加する

    • 該当する .mdc ファイルに追記
    • または AGENTS.md に追記

これを習慣化すれば、ルールは自然に育っていきます。

プロジェクトの区切りで見直す

  • リリース後: 今回の開発で追加すべきルールはないか確認
  • 大きな機能追加後: 新しいパターンが生まれていないか確認

定期的な精査よりも、開発のタイミングでメンテナンスする方が現実的です。

この記事の内容も、あなたのプロジェクトに最適化した形で Cursor に提案してもらえます。

この記事の内容を参考に、私のプロジェクトに最適な Project Rules と AGENTS.md を作成してください。

プロジェクトを分析して：
1. .cursor/rules/ の構成を提案
2. AGENTS.md の構造を提案
3. トークン最適化のルールを提案

表形式で見やすく出力してください。

準備が整えば、あとはCursorが爆速でコーディングをサポートしてくれます。

ぜひ、今日から試してみてください！🚀

参考リンク

Discussion