research

調査

根拠を示しながら、範囲を限定した質問に回答します。解説よりも一次情報を優先し、重要な主張はすべて、その情報を所有する情報源までたどります。

調査のための読み込みは、その場で行います。委任を求められた場合は、運用上のデフォルトを適用します。質問の範囲によって調査範囲は変わりますが、実行権限は変わりません。

プロセス

1. 質問を明確にする

証拠を集める前に、調査の質問を1文で書きます。以下を含めてください。

• 調査によって支援する判断。
• 範囲：リポジトリ内、外部ドキュメント、製品の動作、市場・ツール、またはそれらの組み合わせ。
• チケットや道案内マップに関連する場合は、想定される出力先。

調査対象が曖昧すぎて着手できない場合に限り、簡潔な質問を1つだけしてください。

2. 既存のLLMウィキを確認する

他の場所から情報源を集める前に、プロジェクトに purpose.md、schema.md、wiki/index.md を含む互換性のあるLLMウィキのルートがすでにあるか確認します。ある場合は、llm-wikiを呼び出し、明確にした調査の質問で query 操作を実行してください。この手順を満たすためだけにウィキを作成してはいけません。

保存されたクエリと、ウィキが参照するページは、編集済みのコンテキストおよび情報源へのポインターとして扱い、一次証拠とはみなしません。その出所をたどって、該当するリポジトリアーティファクトや生の情報源を確認し、ウィキが不完全な場合は証拠の収集を続けてください。

3. 一次情報を集める

主張に対して、利用できる中で最も強い情報源を使用します。

• プロジェクト内の動作については、リポジトリのソース、テスト、設定、ログ、マイグレーション、仕様、チケット、コミット履歴。
• 外部の動作については、公式ドキュメント、ソースリポジトリ、API リファレンス、標準、リリースノート、変更履歴、スキーマ、または提供元によるサンプル。
• 製品、デザイン、またはビジネスの背景については、ユーザーが提供したアーティファクト。

二次情報は、一次情報へのポインターとしてのみ使用してください。該当する情報を所有する情報源がある場合、ブログ記事、フォーラムの返信、自動生成された要約、検索結果の抜粋を最終回答の根拠にしてはいけません。

4. 証拠を確認する

• 可能であれば、リスクの高い主張や意外な主張は、互いに独立した一次情報の根拠を少なくとも2つ比較します。
• 回答に影響する場合は、バージョン、日付、フラグ、環境の制約、リポジトリの状態を記録します。
• リポジトリの動作を低コストで確認できる場合は、短いローカルコマンドやテストを実行します。
• 観察された事実と推論を区別します。

変化の速い外部情報については、回答前に最新のドキュメントを確認します。

5. 永続的な調査結果を保存する

この調査がローカルの調査チケット、仕様、または道案内マップに関連する場合、そのアーティファクトを更新するか、リポジトリに慣例がない場合は docs/research/<slug>.md に短いレポートを作成します。永続的なアーティファクトが役立つ場合に限り、フォルダーを作成してください。永続的なレポートには、安定した Artifact ID、Role: research、および Standalone: true または Parent のいずれか1つを含む ## Artifact Graph セクションを1つ含めます。チケットに紐づくレポートは該当する調査チケットを参照し、同じ変更内でチケットに相互参照となる Produces リンクを追加します。

簡単な質問なら、根拠を添えた簡潔な最終回答で十分です。

出力

簡単な回答を超える場合は、次の形式を使用します。

## Answer

<Direct answer in one or two paragraphs.>

## Evidence

- <Source path or citation> - <fact supported by that source>.

## Unknowns

- <Remaining uncertainty, or "None".>

## Next Step

<Decision, prototype, spec update, or implementation step this research enables.>

回答の分量は適切に保ってください。ユーザーが生の調査資料を求めていない限り、メモ、書き起こし、長い引用をそのまま出力しないでください。