Cursor CLIとAGENTS.md入門——「エージェント設定ファイル戦国時代」に効く実践Tips

Cursor・開発ツール のアイキャッチ

Cursorのターミナル向けエージェント「Cursor CLI」が1月のアップデートでPlanモード・Askモード・クラウド引き継ぎを備え、IDEの外でも本格的に使えるようになった。一方でAI開発ツールの設定ファイルは AGENTS.md という共通標準にまとまりつつある。今回はCursorを軸に、AI開発ツール・vibe codingの実務Tipsを整理する。

AIコーディングエージェントとツールのイメージ

Cursor CLIが「エージェントモード」を搭載

Cursorのターミナル版エージェント「Cursor CLI」は、1月16日付のアップデートで大きく機能を拡張した。主な変更点は次の3つ。

  • Planモード:実装前にまず方針を練るモード。Cursor側が確認の質問を投げ返しながら計画を固めていく。
  • Askモード:コードを変更せずに調査だけ行うモード。/ask または --mode=ask で開始できる。エディタ版のAskモードと同じ感覚でCLIから使える。
  • クラウド引き継ぎ:メッセージの先頭に&を付けて送信すると、ローカルの会話をクラウド上のエージェントに引き渡して裏で走らせ続けられる。続きは cursor.com/agents からWeb・モバイルで確認できる。

加えて、MCPサーバーとの連携も「ワンクリック認証」に対応し、コールバックを自動処理するログインフローが用意された。認証さえ済ませれば、エージェントはそのまま接続済みMCPにアクセスできる(詳細はCursorコミュニティフォーラムの告知を参照)。「エディタで書いて、CLIで流し、クラウドに任せる」という一連の流れが1つのツールで完結しつつある。

設定ファイルの共通言語「AGENTS.md」

Cursor・Codex・GitHub Copilot・Gemini CLIなど各社のコーディングエージェントは、これまで .cursorrules や CLAUDE.md など独自のプロジェクト設定ファイルを使っていた。この乱立に一つの答えを出したのが AGENTS.md だ。2025年8月にOpenAIが公開し、その後 Linux Foundation傘下のAgentic AI Foundation(AAIF)に移管された、リポジトリ直下に置くだけの単純なMarkdown仕様だ。

AAIFの公式リストには Amp・Codex・Cursor・Devin・Factory・Gemini CLI・GitHub Copilot・Jules・VS Code の9ツールが名を連ね、対応リポジトリは6万件を超えるという。OpenAIの発表にもある通り、狙いは「どのエージェントで開いても同じプロジェクト文脈を読める」状態を作ることにある。なお Claude Code や Windsurf などでの対応も広く報告されているが、AAIFの公式リストには載っていない点は留意したい。

設定ファイル 主な対応ツール 役割
AGENTS.md Codex, Cursor, Copilot, Gemini CLI ほか(AAIF公式) リポジトリ全体の共通コンテキスト(アーキテクチャ・ディレクトリ構成・デプロイ手順など)
.cursor/rules(.mdcファイル) Cursor エディタ固有の振る舞い・コーディング規約をトピック単位で細かく指定
CLAUDE.md Claude Code Claude Code向けのプロジェクト指示・常時参照コンテキスト
SKILL.md Claude Code など 必要なときだけ読み込む「オンデマンドの専門知識」
画面のコードを見つめるプログラマー
Photo: qubodup / CC BY 2.0(Openverse経由)

Cursor Rules(.mdc)を書くときの実践Tips

Cursorでは単一の .cursorrules ファイルに代わり、.cursor/rules/ ディレクトリに複数の .mdc ファイルを置くのが2026年の標準的な構成になっている。トピックごとにファイルを分け、フロントマターの description・globs・alwaysApply でどの場面でルールを適用するかを制御できる。実践でよく挙がるポイントは次の通り。

  • 粒度を分ける:フレームワークごと・レイヤーごとにファイルを分割し、globs で対象ファイルを絞り込む。1ファイルに何もかも詰め込まない。
  • 境界線を明記する:「ユーザーの確認なしにコミットしない」「.envやpackage.jsonを無断で削除しない」「脆弱性を見つけたら即座に報告し作業を止める」など、エージェントが越えてはいけない線を具体的に書く。
  • 具体的な指示にする:「早期リターンでネストを2段以内に抑える」「30行を超える関数は分割する」「真偽値の変数名はis/has/shouldから始める」のように、曖昧な精神論ではなく実行可能な指示にする。
  • チームで共有資産として扱う:.cursor/rules/はバージョン管理に含め、誰かが再発防止のルールを書けば次のpullで全員に反映される「共有設定」として運用する。

より詳しい書き方は Cursor Rules Best Practices や、5段階のルール構造を解説するこちらの記事が参考になる。

vibe codingと向き合うために

「vibe coding」という言葉は2025年2月にAndrej Karpathyが提唱したとされ、「欲しいものを説明し、AIにコードを書かせ、提案をそのまま受け入れ、壊れたところだけ直す」という開発スタイルを指す。スピードは魅力だが、精神論だけで進めると事故につながりやすい。上記のようなCursor Rulesの境界線設定に加えて、以下も意識したい。

  • 本番環境への反映やスキーマ変更など「後戻りしにくい操作」は必ず人間がレビューしてから実行する。
  • AGENTS.mdやCursor Rulesに書いたプロジェクトの前提(デプロイ手順、禁止事項など)は、コードの変更に合わせて定期的に見直す。
  • Planモード・Askモードのように「まず読む・考える」段階を挟めるツールは、いきなり書かせるより安全に倒しやすい。

各社の設定ファイルの違いをより詳しく比較したい場合はAGENTS.md vs CLAUDE.md vs Cursor Rules vs Copilotの比較記事も参考になる。


主な情報源

各ツールは提供元の規約に従ってご利用ください。情報は各情報源の公開時点のものです。収集・要約はAI、公開判断は人。