Project Rules
.cursor/rules
に保存され、バージョン管理され、コードベースにスコープされる。User Rules
Cursor 環境全体で有効。設定で定義され、常に適用される。
AGENTS.md
Markdown 形式の Agent 向け指示。
.cursor/rules
のシンプルな代替。.cursorrules (Legacy)
まだサポートされているが非推奨。代わりに Project Rules を使ってね。
ルールの仕組み

ルールは Chat と Inline Edit に適用される。アクティブなルールは Agent サイドバーに表示される。
プロジェクトルール
.cursor/rules
に配置される。各ルールは単一ファイルで、バージョン管理の対象。パスパターンで適用範囲を絞ったり、手動で実行したり、関連性に基づいて自動的に取り込める。サブディレクトリには、そのフォルダにスコープされた独自の .cursor/rules
ディレクトリを含められる。
プロジェクトルールの使いどころ:
- コードベースに関するドメイン固有知識を記述する
- プロジェクト固有のワークフローやテンプレートを自動化する
- スタイルやアーキテクチャの方針を標準化する
ルールの構成
.mdc
)で書かれてる。種類のドロップダウンから description
、globs
、alwaysApply
のプロパティを切り替えて、ルールの適用方法を制御できる。
Rule Type | Description |
---|---|
Always | つねにモデルのコンテキストに含まれる |
Auto Attached | グロブパターンに一致するファイルが参照されたときに含まれる |
Agent Requested | AI が判断して必要なら含める。説明の記述が必須 |
Manual | @ruleName で明示的に指定した場合にのみ含まれる |
ネストされたルール
.cursor/rules
ディレクトリにルールを置いて整理しよう。ディレクトリ内のファイルが参照されると、そのディレクトリにあるネストされたルールが自動的に適用される。
ルールの作成
New Cursor Rule
コマンドを使うか、Cursor Settings > Rules
に進んでルールを作成しよう。これで .cursor/rules
に新しいルールファイルが作成される。Settings では、すべてのルールとそのステータスを確認できる。

ルールの生成
/Generate Cursor Rules
コマンドを使って、ルールをその場で作成できる。エージェントのふるまいを決めて、それを再利用したいときに便利。
ベストプラクティス
- ルールは500行以内に収める
- 大きなルールは、複数の組み合わせ可能なルールに分割する
- 具体的な例や参照ファイルを示す
- あいまいな指示は避ける。社内ドキュメントのように明確に書く
- チャットで同じプロンプトを繰り返す場合は、ルールを再利用する
例
フロントエンドコンポーネントと API バリデーションの標準
フロントエンドコンポーネントと API バリデーションの標準
このルールはフロントエンドコンポーネントの標準を定める:components ディレクトリで作業するとき:
- スタイリングは常に Tailwind を使う
- アニメーションは Framer Motion を使う
- コンポーネントの命名規則に従う
- すべてのバリデーションに zod を使う
- 戻り値の型は zod スキーマで定義する
- スキーマから生成された型をエクスポートする
Express サービスと React コンポーネントのテンプレート
Express サービスと React コンポーネントのテンプレート
このルールは Express サービスのテンプレートを提供する:Express サービスを作成するときはこのテンプレートを使う:
- RESTful の原則に従う
- エラーハンドリング用ミドルウェアを含める
- 適切なロギングを設定する
- 先頭に Props のインターフェース
- コンポーネントは名前付きエクスポート
- スタイルは末尾に置く
開発ワークフローの自動化とドキュメント生成
開発ワークフローの自動化とドキュメント生成
このルールはアプリの分析を自動化する:アプリの分析を依頼されたら:
npm run dev
で dev サーバーを起動する- コンソールのログを取得する
- パフォーマンス改善案を提案する
- コードコメントを抽出する
- README.md を分析する
- Markdown ドキュメントを生成する
Cursor に新しい設定を追加する
Cursor に新しい設定を追加する
まず アプリで使うには、reactiveStorageService をインポートしてプロパティを参照する:
@reactiveStorageTypes.ts
にトグル用のプロパティを作成する。@reactiveStorageService.tsx
の INIT_APPLICATION_USER_PERSISTENT_STORAGE
にデフォルト値を追加する。ベータ機能の場合は @settingsBetaTab.tsx
に、そうでない場合は @settingsGeneralTab.tsx
にトグルを追加する。トグルは一般的なチェックボックスとして <SettingsSubSection>
を使って追加できる。詳細はファイル内の他の例を参照。AGENTS.md
AGENTS.md
は、エージェント向けの指示を定義するためのシンプルな Markdown ファイル。プロジェクトのルートに配置すれば、簡単なユースケースでは .cursor/rules
の代替として使える。
Project Rules と違い、AGENTS.md
はメタデータや複雑な設定を持たないプレーンな Markdown ファイル。構造化ルールのオーバーヘッドなしで、シンプルで読みやすい指示がほしいプロジェクトに最適。
User Rules
.cursorrules
(レガシー)
.cursorrules
ファイルは引き続きサポートされるが、今後廃止予定。より細かな制御、柔軟性、可視性のために Project Rules への移行をおすすめする。
よくある質問
ルールが適用されないのはなぜ?
ルールが適用されないのはなぜ?
ルールの種類を確認して。
Agent Requested
なら説明が定義されてるかチェック。Auto Attached
ならファイルパターンが参照してるファイルにマッチしてるか確認して。ルールは他のルールやファイルを参照できる?
ルールは他のルールやファイルを参照できる?
できる。
@filename.ts
を使って、ルールのコンテキストにファイルを含めて。チャットからルールを作成できる?
チャットからルールを作成できる?
できる。
/Generate Cursor Rules
コマンドでチャットからプロジェクトルールを生成できる。Memories が有効なら、メモリは自動で作成されるよ。ルールは Cursor Tab や他の AI 機能に影響する?
ルールは Cursor Tab や他の AI 機能に影響する?
影響しない。ルールが適用されるのは Agent と Inline Edit だけだよ。