Cursor Rules（カーソルルール）完全ガイド【2026年最新】：.mdcファイルの書き方・4種類のルールタイプ・おすすめ設定まで徹底解説

---
alwaysApply: true
---

# プロジェクト基本規約

- 言語: TypeScript（any禁止）
- コメント: 日本語で記述
- テスト: 全関数にユニットテストを追加
- エラーハンドリング: 必ず実装

---
alwaysApply: false
globs: ["src/components/**/*.tsx", "src/pages/**/*.tsx"]
---

# Reactコンポーネント規約

- 関数コンポーネント + TypeScript インターフェースを使用
- named exportのみ（default exportは禁止）
- コンポーネントは150行以内に収める
- Propsの型定義はコンポーネントの直上に書く

---
alwaysApply: false
description: "Stripe決済フローやサブスクリプションの実装を行うとき"
---

# Stripe実装規約

- Stripe Webhookは必ず署名検証を実装
- 金額はセント単位で扱う（日本円はそのままの整数値）
- エラーは Stripe のエラーコードで分岐して処理

your-project/
├── .cursor/
│   └── rules/
│       ├── general.mdc          # 常時適用（基本規約）
│       ├── react-components.mdc # Auto: src/components/**
│       ├── api-routes.mdc       # Auto: src/api/**
│       ├── database.mdc         # Auto: src/db/**
│       ├── stripe.mdc           # Agent Requested
│       └── deploy-guide.mdc     # Manual
├── src/
├── package.json
└── .gitignore

# 特定の拡張子を全ファイル
**/*.ts          → 全 .ts ファイル
**/*.tsx         → 全 .tsx ファイル
**/*.py          → 全 .py ファイル

# 特定ディレクトリ配下
src/**/*.ts      → src/ 以下の全 .ts
src/components/**/*.tsx → src/components/ 以下の全 .tsx

# 複数パターン（配列）
["src/**/*.ts", "src/**/*.tsx"]

# 特定のファイル名
**/schema.ts     → 全ての schema.ts
**/*Controller.ts → Controller で終わる .ts

# ディレクトリ名を含む
src/api/**       → src/api/ 以下の全ファイル
tests/**/*.test.ts → tests/ 以下の全テストファイル

---
alwaysApply: true
---

# プロジェクト概要

## 技術スタック
- フロントエンド: Next.js 15 + TypeScript
- バックエンド: Supabase (PostgreSQL)
- スタイリング: Tailwind CSS
- テスト: Vitest

## 基本規約
- コメントは日本語で記述
- エラーハンドリングは必須
- anyは使用禁止
- コンソールログは本番コードに残さない

---
alwaysApply: false
globs: ["**/*.ts", "**/*.tsx"]
---

# TypeScript規約

## 型定義
- 全ての関数に戻り値の型を明記する
- interfaceはI接頭辞なし（UserProfile, not IUserProfile）
- Union型は型エイリアスとして定義する
- anyは使用禁止。unknownまたは具体的な型を使う

## 関数
- アロー関数を推奨（functionキーワードは避ける）
- 非同期処理は async/await（Promiseチェーンは避ける）
- 関数は単一責任、100行以内に収める

## import
- パスエイリアスを使用（@/components/Foo）
- 型のみのimportは import type を使う

---
alwaysApply: false
globs: ["src/components/**/*.tsx", "app/**/*.tsx"]
---

# Reactコンポーネント規約

## コンポーネント設計
- 関数コンポーネント + TypeScript interfaceで定義
- Propsの型はコンポーネントの直上に書く
- named exportのみ（default exportは禁止）
- コンポーネントは150行以内。超えたら分割を検討

## State管理
- ローカルstateはuseState/useReducer
- サーバーstateはTanStack Query
- グローバルstateはZustand

## スタイリング
- Tailwind CSSのユーティリティクラスを使用
- カスタムCSSは最小限に抑える
- className は cn()ヘルパーで結合する

## アクセシビリティ
- インタラクティブ要素には必ずaria-labelを追加
- 画像にはaltテキストを設定

---
alwaysApply: false
globs: ["**/*.py"]
---

# Python規約

## コードスタイル
- PEP 8に準拠
- 型ヒントを全関数に付ける
- docstringはGoogle形式で記述

## 関数・クラス
- 関数は1つの処理のみ（単一責任）
- クラス名: PascalCase
- 変数・関数名: snake_case
- 定数: UPPER_SNAKE_CASE

## 依存関係
- パッケージ管理はuv
- 仮想環境は.venv/に作成
- requirements.txtではなくpyproject.tomlを使用

## テスト
- pytestを使用
- テストファイルはtests/ディレクトリに配置
- テスト関数名はtest_で始める

---
alwaysApply: false
globs: ["**/*.php"]
---

# Laravel規約

## コントローラー
- リソースコントローラーを優先
- ビジネスロジックはServiceクラスに分離
- FormRequestでバリデーション
- コントローラーは50行以内を目標に

## Eloquent ORM
- N+1問題を避けるためeager loadingを使用（with()）
- スコープで共通クエリをまとめる
- マスアサインメントには$fillableを必ず設定

## セキュリティ
- ユーザー入力は必ずバリデーション
- SQLは必ずEloquentまたはクエリビルダー経由
- 認証にはSanctum/Passportを使用

# .gitignore での正しい設定

# NG（全員のCursor設定がgit管理されてしまう）
# .cursor/

# 推奨（rulesだけ共有、settings等は除外）
.cursor/settings/

# NG
globs: "/src/components/**/*.tsx"

# OK
globs: "src/components/**/*.tsx"

# OK（複数パターン）
globs: ["src/components/**/*.tsx", "app/components/**/*.tsx"]

# NG（曖昧すぎる）
description: "データベース関連"

# OK（具体的）
description: "Supabaseのテーブル設計、RLS設定、クエリを書くとき"

mkdir -p .cursor/rules

---
alwaysApply: true
---

# プロジェクト概要
（使っている技術スタック、言語、フレームワークを書く）

# 基本規約
（コーディング規約の中で最も重要なものだけ書く）