how

仕組み

コードベースを調査し、「X はどのように動作するのか？」という質問に答えます。サブシステムに加わったシニアエンジニアがオンボーディングで理解できるレベルの、アーキテクチャ上の説明を作成します。動作を把握するのに十分な内容を含めつつ、ソースコードに注釈を付けたような説明にはしません。

ディスパッチの契約。 設定されたすべてのロールを、provider-dispatch.md を通じて解決します。値はプロバイダーが指定された記述子であり、ネイティブ実行か外部実行かは親が選択します。すべてのレーンは read-only モードで実行します。エクスプローラーには how explorer 記述子を使用し、すべての説明役には how explainer 記述子を使用します。シートにいずれかの行がない場合は、そのロールのロールのデフォルト設定を使用します。ネイティブレーンは親のサブエージェントプリミティブを使用し、外部レーンはランチャーを直接使用します。Codex では、残りの Claude ツール名を codex-tools.md で解決します。poteto-mode スキルの「Subagents」セクションに従い、各サブエージェントの作業に合わせて作業量を選択します。

1. 複雑さを評価する

対象範囲が曖昧な場合は、解釈を示して調査します。ユーザーはその内容を修正できます。

• 単純（単一モジュール、小規模なユーティリティ、「関数 X はどのように動作するのか？」のような限定的な質問）：エクスプローラーは使用しません。references/explainer-prompt.md をもとに、エクスプローラーの調査結果のセクションを除いた内容で、調査と説明を一度に行う説明役を 1 つ起動します。ステップ 4 に進みます。
• 複雑（複数のファイルやサービスにまたがるサブシステム、横断的な機能、アーキテクチャ全体の概要）：ステップ 2 に進みます。

判断に迷った場合は、単純な方法を選びます。

2. 調査する（複雑な場合のみ）

質問を 2〜4 個の観点に分解し、それぞれでサブシステムの異なる部分を調査します。各エクスプローラーに references/explorer-prompt.md と担当する観点を設定し、すべてのエクスプローラーを 1 回のファンアウトフェーズで起動します。

3. 統合する（複雑な場合のみ）

すべてのエクスプローラーから結果が返ってきたら、references/explainer-prompt.md に各エクスプローラーの調査結果をすべて設定し、説明役を 1 つ起動します。

4. 提示する

説明役の出力を提示します。明確さや会話の文脈に応じた軽微な編集はかまいません。大幅な書き換えはしないでください。

出力形式

references/explainer-prompt.md で定義されたセクションを使用し、該当しないセクションは省略します。セクションは「概要」「主要な概念」「仕組み」「関連ファイルの場所」「注意点」です。