parallel-exploring

並列探索

大規模なコードベースや不慣れなコードベースをすばやく理解したい場合、新しいプロジェクトへの参加時、複数のレイヤーにまたがる機能の調査時、またはアーキテクチャの把握時に、このスキルを使用します。

仕組み

Cursor の explore サブエージェントは、コードの検索と読み取りに最適化された、高速で読み取り専用のエージェントです。1 つのメッセージで複数の explore エージェントを起動でき、それぞれが異なる領域を調査しながら並行して実行されます。

手順

1. 調査する領域を特定します — コードベースを論理的な領域に分割します。一般的なフルスタックアプリの場合：

   • フロントエンド：コンポーネント、ページ、ルーティング、状態管理
   • バックエンド：API ルート、データベースモデル、ミドルウェア、認証
   • インフラストラクチャ：CI/CD、Docker、デプロイ設定
   • 共通：型、ユーティリティ、定数

2. 並列探索エージェントを起動します — 各領域に対して、subagent_type: "explore" を指定した Task ツールを使用します。すべてのエージェントを 1 つのメッセージで起動します：

   Task 1: "Explore the frontend — find the main pages, routing setup, state management approach,
            and UI component library. Check src/app/, src/components/, src/pages/. Report the
            framework, router, styling approach, and key components."
   
   Task 2: "Explore the backend — find the API routes, database setup, ORM, auth middleware,
            and data models. Check src/server/, src/api/, lib/, prisma/. Report the framework,
            database, auth strategy, and key endpoints."
   
   Task 3: "Explore the infrastructure — find CI/CD config, Docker setup, deployment targets,
            and environment variable management. Check .github/, docker*, *.config.*, .env*.
            Report the deploy target, CI provider, and any IaC."
   

3. 結果を統合します — すべてのエージェントから結果が返ってきたら、調査結果をまとめて一貫した全体像を作成します：

   • 技術スタックの概要（フロントエンド、バックエンド、データベース、インフラ）
   • アーキテクチャ図（データフローの説明）
   • 主要なファイルとエントリポイント
   • 懸念事項や技術的負債の可能性

その他の使用例

• 横断的な調査：「ユーザー認証はどこで確認されていますか？」— フロントエンド（ルートガード）、バックエンド（ミドルウェア）、データベース（セッションストレージ）を同時に検索するエージェントを起動します。
• 依存関係の監査：依存関係ツリーの異なる部分を調べ、古いパッケージ、セキュリティ上の問題、未使用のインポートを確認するエージェントを起動します。
• 移行計画：エージェントにフロントエンド、バックエンド、テストを同時に評価させ、フレームワークの移行範囲を見積もります。

注意事項

• explore エージェントは読み取り専用であり、ファイルを変更できません。
• 包括的な分析を行うには、プロンプトで thoroughness: "very thorough" を使用します。
• 各エージェントは独自のコンテキストウィンドウを持つため、容量が不足することなく、それぞれが多数のファイルを読み取れます。
• 対象を絞った質問が 1 つだけの場合は、Grep または SemanticSearch を直接使用します。サブエージェントは幅広い調査に使用します。