Cursor Rulesの高度な活用 - チーム開発の効率化

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

---
description: "プロジェクト全体のコーディング規約"
alwaysApply: true
---

## 基本ルール

- TypeScriptを使用する（JavaScriptファイルは禁止）
- 変数名・関数名は英語のcamelCaseを使用
- コメントは日本語で記述
- すべての公開関数にはJSDocコメントを付ける

## 禁止事項

- `any`型の使用
- `console.log`の本番コードへのコミット
- グローバル変数の定義

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

---
description: "Reactコンポーネントの実装ガイドライン"
globs: ["src/components/**/*.tsx", "src/features/**/*.tsx"]
alwaysApply: false
---

## コンポーネント設計

- 関数コンポーネントのみを使用（クラスコンポーネント禁止）
- Propsには必ずTypeScript型定義を付ける
- デフォルトエクスポートを使用

## ファイル構成

各コンポーネントディレクトリの構成:

\`\`\`
ComponentName/
├── index.tsx        # メインコンポーネント
├── styles.module.css # スタイル
├── types.ts         # 型定義
└── hooks.ts         # カスタムフック（必要な場合）
\`\`\`

## 参照テンプレート

@templates/component-template.tsx

1
2
3
4
5
6
7
8

---
description: "APIレイヤーの実装ガイドライン"
globs: 
  - "src/api/**/*.ts"
  - "src/services/**/*.ts"
  - "src/repositories/**/*.ts"
alwaysApply: false
---

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

---
description: "データベースマイグレーションとスキーマ設計のガイドライン。テーブル作成、カラム追加、インデックス設計、外部キー制約に関する規約を含む。"
alwaysApply: false
---

## マイグレーションファイルの命名

形式: `YYYYMMDDHHMMSS_descriptive_name.ts`

例:
- `20260109120000_create_users_table.ts`
- `20260109120100_add_email_to_users.ts`

## スキーマ設計規約

### カラム命名

- スネークケースを使用: `user_id`, `created_at`
- 外部キーは`_id`サフィックス: `user_id`, `order_id`
- ブール値は`is_`または`has_`プレフィックス: `is_active`, `has_verified`

### 必須カラム

すべてのテーブルに以下のカラムを含める:

\`\`\`sql
id BIGSERIAL PRIMARY KEY,
created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
\`\`\`

### SOFT DELETE

物理削除ではなく論理削除を使用:

\`\`\`sql
deleted_at TIMESTAMP WITH TIME ZONE
\`\`\`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

---
alwaysApply: false
---

## レガシーコード対応ガイドライン

このルールはレガシーコードのリファクタリング時にのみ使用してください。
通常の開発では適用しないでください。

### 対応方針

1. 既存の命名規則を維持（新規コードの規則に変更しない）
2. 型定義は段階的に追加
3. テストカバレッジを先に確保してからリファクタリング

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

---
description: "Reactコンポーネント、フック、スタイリングに関するフロントエンド実装ガイドライン"
globs: ["src/components/**/*.tsx", "src/hooks/**/*.ts"]
alwaysApply: false
---

## コンポーネント実装

### Props定義

\`\`\`typescript
// 良い例
interface ButtonProps {
  variant: 'primary' | 'secondary' | 'danger';
  size?: 'sm' | 'md' | 'lg';
  disabled?: boolean;
  onClick?: () => void;
  children: React.ReactNode;
}

export const Button: React.FC<ButtonProps> = ({
  variant,
  size = 'md',
  disabled = false,
  onClick,
  children,
}) => {
  // ...
};
\`\`\`

### カスタムフック

- `use`プレフィックスを使用
- 単一責任の原則を守る
- 戻り値の型を明示

\`\`\`typescript
interface UseUserReturn {
  user: User | null;
  isLoading: boolean;
  error: Error | null;
  refetch: () => Promise<void>;
}

export function useUser(userId: string): UseUserReturn {
  // ...
}
\`\`\`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

---
description: "REST API設計、エンドポイント実装、バリデーション、エラーハンドリングのガイドライン"
globs: ["src/api/**/*.ts", "src/routes/**/*.ts", "src/controllers/**/*.ts"]
alwaysApply: false
---

## エンドポイント設計

### URL命名規則

- リソース名は複数形: `/users`, `/orders`
- ネストは2階層まで: `/users/:id/orders`
- アクションはHTTPメソッドで表現

| 操作 | メソッド | URL例 |
|-----|---------|-------|
| 一覧取得 | GET | `/users` |
| 詳細取得 | GET | `/users/:id` |
| 作成 | POST | `/users` |
| 更新 | PUT/PATCH | `/users/:id` |
| 削除 | DELETE | `/users/:id` |

### レスポンス形式

\`\`\`typescript
// 成功レスポンス
interface ApiResponse<T> {
  data: T;
  meta?: {
    page: number;
    limit: number;
    total: number;
  };
}

// エラーレスポンス
interface ApiError {
  error: {
    code: string;
    message: string;
    details?: Record<string, string[]>;
  };
}
\`\`\`

### バリデーション

- 入力バリデーションにはzodを使用
- バリデーションエラーは422で返す
- エラーメッセージは日本語で記述

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

---
description: "ユニットテスト、統合テスト、E2Eテストの実装ガイドライン"
globs: ["**/*.test.ts", "**/*.test.tsx", "**/*.spec.ts", "tests/**/*"]
alwaysApply: false
---

## テストファイル構成

### 命名規則

- ユニットテスト: `*.test.ts`
- 統合テスト: `*.integration.test.ts`
- E2Eテスト: `*.e2e.test.ts`

### テスト構造

\`\`\`typescript
describe('UserService', () => {
  describe('createUser', () => {
    it('有効なデータで新規ユーザーを作成できる', async () => {
      // Arrange
      const userData = { name: 'Test User', email: 'test@example.com' };
      
      // Act
      const result = await userService.createUser(userData);
      
      // Assert
      expect(result).toMatchObject({
        id: expect.any(String),
        name: 'Test User',
        email: 'test@example.com',
      });
    });

    it('重複したメールアドレスでエラーを返す', async () => {
      // ...
    });
  });
});
\`\`\`

### モック戦略

- 外部APIは必ずモック
- データベースはテスト用DBまたはモック
- 時間依存のテストは`jest.useFakeTimers()`を使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

---
description: "Agent Skillsを拡張するプロジェクト固有の設定"
alwaysApply: false
---

## Agent Skills拡張設定

### Web検索の追加コンテキスト

Web検索結果を使用する際は、以下の優先順位で情報源を評価:

1. 公式ドキュメント
2. GitHub Issues/Discussions
3. Stack Overflow（高評価回答のみ）
4. 技術ブログ（信頼性の高いもの）

### ファイル操作の制約

Agent Skillsによるファイル操作時は以下を遵守:

- `node_modules/`、`dist/`、`.git/` への書き込み禁止
- 設定ファイル（`.env`、`*.config.*`）の変更は確認を求める
- 大規模な変更（10ファイル以上）は計画を先に提示