how

仕組み

コードベースを調査して、「X はどのように動作するのか」という質問に答えます。サブシステムに参加するシニアエンジニアが把握すべきレベルでアーキテクチャを説明し、ソースコードに注釈を付けたような説明にならない範囲で、実際に役立つメンタルモデルを構築できるだけの情報を提供します。

以下の各スポーンでは、pstack-models.mdc ルール内のロール行とデフォルト値を指定しています。model にはその行の値を設定します。ルールまたは行がない場合は、デフォルト値を設定します。値が auto または inherit-parent の場合は、model を未設定のままにします。Task ツールがスラッグを受け付けない場合は、デフォルト値を使用し、その旨を伝えます。デフォルト値が受け付けられない場合は、エラーメッセージに示された同じファミリーの有効なスラッグのうち、最も近いものを使用します。

ステップ 1. 複雑さを評価する

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

• シンプル（単一モジュール、小規模なユーティリティ、「関数 X の仕組み」のような範囲の狭い質問）：調査担当者は不要です。説明担当者が一度の作業で調査と説明を行います。ステップ 2b に進みます。
• 複雑（複数のファイルやサービスにまたがるサブシステム、横断的な機能、アーキテクチャ全体の概要）：まず調査担当者を並行して起動し、その後、説明担当者に引き継ぎます。ステップ 2a に進みます。

判断に迷った場合は、シンプルな方法を選びます。

ステップ 2a. 調査する（複雑な質問のみ）

質問を 2～4 個の調査観点に分解します。それぞれ異なるサブシステムの範囲を担当させます。すべての調査担当者を 1 回のメッセージで起動します。

• subagent_type: generalPurpose
• model: how explorer 行の値。デフォルトは grok-4.7-xhigh-fast
• readonly: true

各調査担当者には、観点を埋めた references/explorer-prompt.md のプロンプトを渡します。その後、ステップ 3 に進みます。

ステップ 2b. 直接説明する（シンプルな質問）

調査と説明を一度に行う Task サブエージェントを 1 つ起動します。

• subagent_type: generalPurpose
• model: how explainer 行の値。デフォルトは claude-opus-5-5-max
• readonly: true

explorer の調査結果セクションを含めずに、references/explainer-prompt.md を基にプロンプトを作成します。その後、ステップ 4 に進みます。

ステップ 3. 統合する（複雑な質問のみ）

すべての調査担当者から結果が返されたら、調査結果を 1 つの説明にまとめる Task サブエージェントを 1 つ起動します。

• subagent_type: generalPurpose
• model: how explainer 行の値。デフォルトは claude-opus-5-5-max
• readonly: true

すべての調査担当者の結果を埋め込んだ references/explainer-prompt.md を基にプロンプトを作成します。

ステップ 4. 提示する

説明担当者の出力をユーザーに提示します。明確さや会話の文脈に合わせた軽微な編集は問題ありません。大幅な書き換えはしないでください。

出力形式

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