リサーチスキル
技術的な問題を効率的に調査し、学んだことを永続化して、チームが同じトピックを二度調査しないようにします。
1. トピックの範囲を定める
ユーザーのメッセージから以下を抽出します（本当に不明な場合のみ質問してください）：
- トピックスラッグ: ケバブケースのフォルダ名（例:
bluetooth-audio-routing） - スタック: プラットフォーム/言語/フレームワーク
- 症状: 実際の動作と期待される動作の差
- 既知の情報: すでに試した仮説
2. ワークスペースを準備する
scripts/init-research.sh {topic-slug} を実行して、docs フォルダを作成します。
3. 3つのデフォルトエージェントを並列起動する
各エージェントには、1行の角度と共有コンテキストが与えられます。正確なプロンプトの文言が必要な場合は、reference/agent-prompts.md を参照してください。
- コードベース分析（探索エージェント） — 関連するコード、ギャップ、ファイル:行参照を見つけます。
- 根本原因理論（Webエージェント） — OS/フレームワーク/プロトコルレベルでなぜ発生するかを調査します。
- 解決策と検証（Webエージェント） — ネイティブAPI、ライブラリ、コミュニティで確認された修正を調査します。
オプションの4番目/5番目のエージェントは、ユーザーが明示的にライブラリの比較やクロスプラットフォームAPIの詳細調査を要求した場合にのみ起動します。
4. 統合する
以下の2つのファイルを正確に作成します：
docs/{topic}/NOTAS.md— 生の調査結果、スニペット、URL、簡単な観察事項。docs/{topic}/RESEARCH_CONSOLIDADO.md— 構造化されたマスタードキュメント。
完全なテンプレートが必要な場合のみ、reference/consolidated-template.md を使用します。オプションの詳細ファイル（03_android_api.md、04_librerias.md など）は、調査結果が正当化する場合にのみ作成されます。
5. ファイナライズする
scripts/finalize-research.sh {topic-slug} を実行して、マスタードキュメントが存在することを検証し、イテレーション行を追加します。その後、ユーザーに報告します：
- 根本原因（該当する場合はファイル:行も含む）
- 意外な発見トップ3
- 作成されたファイル
- 提案する次のステップ
チャットレポートは簡潔に保ち、詳細はドキュメントに記載します。