how

仕組み

コードベースを調べて、「X はどのように動作しますか？」という質問に答えます。サブシステムの担当に加わるシニアエンジニアがオンボーディングできるレベルのアーキテクチャ説明を作成します。実用的なメンタルモデルを構築できるだけの詳しさを保ちつつ、ソースコードに注釈を付けたような説明にはしません。

各サブエージェントの起動には、subagent_type: generalPurpose と readonly: true を指定した Task を使用します。調査担当は、pstack 設定ファイル（Cursor では ~/.cursor/rules/pstack-models.mdc、Claude Code では ~/.claude/rules/pstack-models.md、その他のハーネスでは ~/.agents/pstack-models.md）にある how explorer の行を使用します（デフォルトは grok-4.7-xhigh-fast）。説明担当は how explainer の行を使用します（デフォルトは claude-opus-5-5-xhigh）。model にはその行の値を設定します。ファイルまたは行がない場合は、デフォルトを使用します。値が auto または inherit-parent の場合は、model を未設定のままにします。サブエージェントツールがモデル識別子を受け付けない場合は、デフォルトを使い、その旨を伝えます。デフォルトも受け付けない場合は、エラーメッセージまたはハーネスのモデル一覧から、同じ系列で最も近い有効なモデル識別子を使用します。poteto-mode スキルの「Subagents」セクションに従い、作業に応じて各サブエージェントの推論レベルと高速または標準の実行速度を選択します。

1. 複雑さを評価する

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

• 単純（単一モジュール、小規模なユーティリティ、関数 X の仕組みなどの限定的な質問）：調査担当は起動しません。references/explainer-prompt.md をもとに、explorer-findings セクションを含めず、調査と説明を一度に行う説明担当を 1 人起動します。手順 4 に進みます。
• 複雑（複数ファイルやサービスにまたがるサブシステム、横断的な機能、アーキテクチャ全体の概要）：手順 2 に進みます。

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

その他のハーネス。 このスキルの起動例では、Cursor の Task ツールを使用します。別のハーネスでは、そのサブエージェントツールを使用します。Claude Code では Agent（subagent_type: general-purpose）、OpenCode では task（subagent_type: general）、Codex では spawn_agent を使用します。プロンプトとモデルはそのまま使用し、ツールにないパラメーターは省略します。Pi の拡張機能のように、ハーネスにサブエージェントツールがない場合は、各役割を順に自分で実行します。

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

質問を、それぞれ異なるサブシステムの範囲を扱う 2～4 個の観点に分解します。references/explorer-prompt.md を使用し、各担当の観点を記入して、すべての調査担当を 1 回のメッセージで起動します。

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

すべての調査担当から回答が返ったら、references/explainer-prompt.md を使用し、全調査担当の調査結果を記入して、説明担当を 1 人起動します。

4. 提示する

説明担当の出力を提示します。会話の内容に応じて、明確さや文脈を整える程度の軽微な編集は可能です。大幅な書き換えはしません。

出力形式

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