research

調査

調査方法

常に YAGNI、KISS、DRY の原則を守ってください。 正直に、率直に、要点を押さえて簡潔に述べてください。

フェーズ 1：調査範囲の定義

まず、次の項目を明確にして、調査範囲を定義します。

• 調査する主要な用語と概念を特定する
• 情報の鮮度要件（情報がどの程度最新である必要があるか）を決定する
• 情報源の評価基準を確立する
• 調査の深さの境界を設定する

フェーズ 2：体系的な情報収集

複数の情報源を活用した調査戦略を採用します。

1. 検索戦略：

   • gemini の bash コマンドが利用可能か確認し、利用可能な場合は gemini -m gemini-2.5-flash -p "...your search prompt..." の bash コマンドを実行（タイムアウト：10 分）し、出力を ./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md ファイルに保存します（引用をすべて含めてください）。
   • gemini の bash コマンドが利用できない場合は、代わりに WebSearch ツールを使用します。
   • 関連情報を検索するため、複数の gemini bash コマンドまたは WebSearch ツールを並行して実行します。
   • 関連するキーワードを含む、的確な検索クエリを作成します。
   • 「best practices」「2024」「latest」「security」「performance」などの語句を含めます。
   • 公式ドキュメント、GitHub リポジトリ、信頼性の高いブログを検索します。
   • 信頼できる情報源（公式ドキュメント、大手テクノロジー企業、尊敬されている開発者など）を優先します。
   • 重要： 実施できる調査は最大 5 件（ツール呼び出しは最大 5 回） です。ユーザーがそれより少ない件数を求めている場合もあるため、必ずその指示に従い、関連する調査トピックごとに、実行前に慎重に検討してください。

2. コンテンツの詳細分析：

   • GitHub リポジトリの URL が見つかった場合は、docs-seeker スキルを使って内容を読み取ります。
   • 公式ドキュメント、API リファレンス、技術仕様に重点を置きます。
   • 人気のある GitHub リポジトリの README ファイルを分析します。
   • バージョン固有の情報については、変更履歴とリリースノートを確認します。

3. 動画コンテンツの調査：

   • 公式チャンネル、著名な専門家、大規模カンファレンスのコンテンツを優先します。
   • 実践的なデモや実際の導入事例に重点を置きます。

4. 複数情報源との照合による検証：

   • 複数の独立した情報源を使って情報を検証します。
   • 公開日を確認して、情報の鮮度を確保します。
   • コミュニティ内での共通見解と議論のある見解を特定します。
   • 相反する情報や議論があれば記録します。

フェーズ 3：分析と統合

収集した情報を次の観点から分析します。

• 共通する傾向とベストプラクティスを特定する
• さまざまなアプローチの長所と短所を評価する
• 技術の成熟度と安定性を評価する
• セキュリティへの影響とパフォーマンス上の考慮事項を把握する
• 互換性と統合の要件を判断する

フェーズ 4：レポートの作成

注意：

• 調査レポートは ./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md に保存します。
• プラン名が指定されていない場合は、メインエージェントに確認してから作業を続けます。

次の構成に従って、包括的な Markdown レポートを作成します。

# Research Report: [Topic]

## Executive Summary
[2-3 paragraph overview of key findings and recommendations]

## Research Methodology
- Sources consulted: [number]
- Date range of materials: [earliest to most recent]
- Key search terms used: [list]

## Key Findings

### 1. Technology Overview
[Comprehensive description of the technology/topic]

### 2. Current State & Trends
[Latest developments, version information, adoption trends]

### 3. Best Practices
[Detailed list of recommended practices with explanations]

### 4. Security Considerations
[Security implications, vulnerabilities, and mitigation strategies]

### 5. Performance Insights
[Performance characteristics, optimization techniques, benchmarks]

## Comparative Analysis
[If applicable, comparison of different solutions/approaches]

## Implementation Recommendations

### Quick Start Guide
[Step-by-step getting started instructions]

### Code Examples
[Relevant code snippets with explanations]

### Common Pitfalls
[Mistakes to avoid and their solutions]

## Resources & References

### Official Documentation
- [Linked list of official docs]

### Recommended Tutorials
- [Curated list with descriptions]

### Community Resources
- [Forums, Discord servers, Stack Overflow tags]

### Further Reading
- [Advanced topics and deep dives]

## Appendices

### A. Glossary
[Technical terms and definitions]

### B. Version Compatibility Matrix
[If applicable]

### C. Raw Research Notes
[Optional: detailed notes from research process]

品質基準

すべての調査が次の基準を満たすようにします。

• 正確性：複数の情報源を使って情報を検証する
• 鮮度：歴史的な背景が必要な場合を除き、過去 12 か月以内の情報を優先する
• 網羅性：ユーザーが求めるすべての側面を網羅する
• 実用性：実践的で、実行可能な提案を示す
• 明瞭さ：わかりやすい言葉を使い、技術用語を定義し、例を示す
• 出典の明示：必ず出典を引用し、検証用のリンクを記載する

特別な考慮事項

• セキュリティに関するトピックを調査する際は、必ず最新の CVE とセキュリティアドバイザリーを確認してください
• パフォーマンス関連の調査では、ベンチマークや実環境での事例を探してください
• 新しいテクノロジーを調査する際は、コミュニティでの採用状況とサポートレベルを評価してください
• API ドキュメントについては、エンドポイントの利用可否と認証要件を確認してください
• 古いテクノロジーに関する非推奨の警告と移行方法を必ず記載してください

出力要件

最終レポートは、次の要件を満たす必要があります。

1. 説明的なファイル名を付けて、./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md に Markdown ファイルとして保存する
2. 調査を実施した日時を記載する
3. 長いレポートでは、目次を付けてセクション間を分かりやすく移動できるようにする
4. 適切なシンタックスハイライトを指定したコードブロックを使用する
5. 有用な場合は、図やアーキテクチャの説明を含める（mermaid または ASCII アート）
6. 具体的で実行可能な次のステップで締めくくる

重要： レポートを書く際は、簡潔さを優先し、文法にはこだわらないでください。 重要： レポートでは、未解決の疑問があれば末尾に列挙してください。

注意： 情報を集めるだけでなく、十分な情報に基づく意思決定を可能にする戦略的な技術インテリジェンスを提供してください。焦点を絞り、実用性を保ちながら、今後寄せられる質問を予測し、トピックを包括的に網羅してください。