find-rules

ルールを探す

このスキルは、現在のタスクに適用される具体的なルール、規約、ガイドラインを見つけて理解するのに役立ちます。プロジェクトのドキュメントを体系的に調査し、プロジェクト標準に準拠できるようにします。

手順

適用されるルールを特定するには、次のワークフローに従います。

1. コンテキストを把握する

まず、タスクを分析して次の内容を判断します。

• タスクの種類：PRD の作成、技術仕様書、機能の実装、リファクタリング、バグ修正など
• テクノロジー：React、Elysia、Tailwind、Drizzle など
• 対象領域：アーキテクチャ、テスト、スタイリング、命名など

2. パターンに基づく探索

必須： ローカルコードの探索には Glob と Grep ツールを使用し、関連するルールファイルやガイドラインを見つけてください。

実行方法： 効率化のため、最初のアクションでは 3 つ以上のツールを同時に実行してください。並列で実行できる場合、ツールを順番に実行してはいけません。

必須の手順：

1. ルールファイルを探す（並列で実行）：複数の Glob パターンを同時に使用します。

   # Primary rules
   Glob pattern=".cursor/rules/*.mdc"
   Glob pattern="**/CLAUDE.md"
   Glob pattern="**/AGENTS.md"
   
   # Secondary rules
   Glob pattern="**/CONTRIBUTING.md"
   Glob pattern="**/ARCHITECTURE.md"
   Glob pattern="**/STYLEGUIDE.md"
   
   # Alternative AI tool locations
   Glob pattern=".windsurf/rules/*"
   Glob pattern=".cursorrules"
   Glob pattern=".copilot/*"
   
   # Configuration files
   Glob pattern="**/.eslintrc*"
   Glob pattern="**/tsconfig.json"
   Glob pattern="**/biome.json"
   

2. 内容で検索する：Grep を使用して、特定のテクノロジーや概念に関するルールを見つけます。

   Grep pattern="react" path=".cursor/rules"
   Grep pattern="CRITICAL|MANDATORY" path=".cursor/rules" output_mode="content"
   Grep pattern="testing" glob="*.md"
   Grep pattern="must|should|never" glob="*.mdc" -i=true
   

3. 検索場所の優先順位：

   • .cursor/rules/*.mdc - テクノロジー固有のルール（最優先）
   • CLAUDE.md - プロジェクト全般のガイドライン
   • AGENTS.md - エージェント固有の指示
   • .windsurf/rules/、.cursorrules - その他の AI ツール向けルール
   • docs/ - ドキュメントディレクトリ
   • 設定ファイル - ツールから推測できるルール

3. ルールを抽出して分類する

関連するファイルを特定したら、次の手順に従います。

1. 読み取る：Read ツールを使用して、特定したルールファイルの内容全体（例：.cursor/rules/react.mdc）を確認します。

2. 各ルールを分類する： 見つかったルールごとに、次の項目を特定します。

   • カテゴリ：対象領域（例：認証、テスト、セキュリティ、パフォーマンス、スタイリング、アーキテクチャ）
   • 内容：実際のルールまたはガイドラインの文面
   • ソースファイル：ルールが記載されているファイルパス
   • 適用レベル：CRITICAL、MANDATORY、RECOMMENDED、SUGGESTED

3. 分析する：

   • まず CRITICAL または MANDATORY の要件を確認します
   • 命名規則、ファイル構成、必須のパターンを特定します
   • 関連するテクノロジーについて、競合するルールや具体的な指示がないか確認します
   • 「must」「should」「never」「always」「required」「forbidden」などのキーワードを確認します

4. 調査結果を提示する

見つかったルールを、明確で実行に移しやすい形式で要約します。

• ルール／ガイドライン：具体的な標準
• ソース：定義されているファイルパスとセクション
• 適用レベル：CRITICAL、MANDATORY、RECOMMENDED
• 適用理由：このタスクに適用される理由

ドキュメントの参照先

主なルールの場所

• .cursor/rules/*.mdc：テクノロジー固有のルール（React、バックエンド、Tailwind など）
• CLAUDE.md：AI アシスタント向けの全般的なガイドラインとプロジェクトのコンテキスト
• AGENTS.md：エージェント固有の指示とワークフロー

二次ルールの配置場所

• CONTRIBUTING.md：貢献に関するガイドラインとプロセス
• CODE_OF_CONDUCT.md：コミュニティとコードに関する基準
• ARCHITECTURE.md：アーキテクチャ上の決定とパターン
• STYLEGUIDE.md：コードスタイルの規約
• CODING_STANDARDS.md：プログラミングの基準

代替 AI ツールの配置場所

• .windsurf/rules/：Windsurf 固有のルール
• .cursorrules：Cursor のルールファイル
• .copilot/：GitHub Copilot の設定
• .codeium/：Codeium の設定

設定ファイル（暗黙のルール）

• .eslintrc.*, .eslintrc.json：Lint ルール
• .prettierrc.*, .prettierrc.json：フォーマットルール
• tsconfig.json：TypeScript コンパイラーのオプション
• .oxlintrc.json：Oxlint の設定
• biome.json：Biome のフォーマッター／リンターのルール

ドキュメントディレクトリ

• docs/：プロジェクトのドキュメント
• .github/：GitHub 固有のテンプレートとワークフロー

適用レベル

• 🚨 重大：厳守する必要があります。違反するとタスクが却下されます。
• ⚠️ 必須：省略してはならない必須の基準です。
• ✅ 推奨：該当する場合に従うべきベストプラクティスです。
• 💡 提案：あると望ましいガイドラインです。

よくあるルールのカテゴリ

ルールを分類する際は、次の一般的な分野を使用してください。

• アーキテクチャ：設計パターン、モジュールの境界、依存関係
• テスト：テスト要件、カバレッジ、パターン
• セキュリティ：認証、認可、入力検証
• パフォーマンス：最適化要件、キャッシュ、遅延読み込み
• スタイリング：CSS／Tailwind の規約、コンポーネントのスタイリング
• 命名：ファイル名、変数名、関数名
• コード品質：Lint、フォーマット、型安全性
• API：エンドポイントのパターン、リクエスト／レスポンスの処理
• 状態管理：Redux、Context、フックのパターン
• エラー処理：例外処理、エラーバウンダリー

例

ユーザー：「新しい React コンポーネントを作成する必要があります。」 スキルの動作：

1. コンテキスト：機能開発、React、コンポーネント構造。
2. 検出：
   • Glob を使用：Glob pattern=".cursor/rules/*.mdc" でルールファイルを検索します。
   • Grep を使用：Grep pattern="react" path=".cursor/rules" で React 関連のルールを検索します。
   • 結果から .cursor/rules/react.mdc が見つかります。
3. 抽出：.cursor/rules/react.mdc を読み込みます。
4. 確認事項：
   • 🚨 重大：関数コンポーネントのみを使用します。
   • ⚠️ 必須：ファイル名は kebab-case.tsx にする必要があります。
   • ⚠️ 必須：状態管理にはフックを使用します。

ユーザー：「バックエンドのエンドポイントはどのように書けばよいですか？」 スキルの動作：

1. コンテキスト：バックエンド、API、実装。
2. 検出：
   • Glob を使用：Glob pattern=".cursor/rules/*.mdc" で利用可能なルールを一覧表示します。
   • Grep を使用：Grep pattern="backend|endpoint|elysia" path=".cursor/rules" でバックエンドのルールを検索します。
   • 結果から .cursor/rules/elysia.mdc と .cursor/rules/data-fetch.mdc が見つかります。
3. 抽出：関連ファイルを読み込みます。
4. 確認事項：
   • 🚨 重大：Elysia のハンドラーパターンに従います。
   • ⚠️ 必須：指定されたデータ取得用ラッパーを使用します。