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

2026年7月30日

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

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の境界線設定に加えて、以下も意識したい。