how

仕組み

「X はどのように動作するのか」という質問に答えるため、コードベースを調査します。「これはどこに置くべきか」や「このレイヤーでよいのか」といった質問も含みます。サブシステムに新しく参加したシニアエンジニアが把握できるレベルのアーキテクチャ説明を作成してください。注釈付きのソースコードのようにならない範囲で、正しく機能するメンタルモデルを構築できるだけの情報を盛り込みます。

以下の各サブエージェントは読み取り専用です。各サブエージェントへの指示には、テンプレートに質問を記入したものが含まれており、「調査のみ、書き込みや git コマンドは禁止」と記載されています。各サブエージェントのモデルは ~/.config/ox/models.md から取得し、手順で指定された役割を使ってください。その行に記載されたモデルと effort をサブエージェントツールに渡します。その値が inherit の場合、記載がない場合、またはファイルの # harness 行に別の harness が記載されている場合は、どちらも省略し、サブエージェントが実行モデルを使うようにします。ファイルがない場合は、ユーザーに /setup-ox models を実行するよう提案してください。ツールが指定値を受け付けない場合は、一覧から最も近いモデルを使い、その旨を伝えてください。harness にサブエージェントツールがない場合は、各手順を順番に自分で実行してください。

質問が、このリポジトリが所有していないサーバー実行中のリソース（ox_inventory、ox_core、フレームワークなど）についてのものである場合は、.ox/config.md の server root および resources dir の行を使って、サーバーの resources フォルダーにあるコピーを読み込んでください（現在のディレクトリから上の階層へたどります）。そのコピーがサーバーで実際に実行されているバージョンです。ファイルがない場合は、自分でリソースを探し、その旨を伝え、ユーザーに /setup-ox を実行するよう提案してください。

1. 複雑さを評価する

対象範囲が曖昧な場合は、解釈を述べて調査してください。ユーザーは方向性を修正できます。

• 単純（単一モジュール、小さなユーティリティ、「このコールバックはどう動作するのか」のような限定的な質問）：調査エージェントは使いません。EXPLAINER-PROMPT.md の complex only と記された部分を除いて構成した explore サブエージェントを 1 つ起動し、調査と説明を一度に行います。手順 4 に進みます。
• 複雑（複数のファイルやリソースにまたがるサブシステム、クライアントとサーバー間をまたぐフロー、アーキテクチャ全体の概要）：手順 2 に進みます。

判断に迷った場合は、単純な方法を選んでください。

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

質問を、サブシステムの異なる領域を扱う 2～4 個の観点に分解します。FiveM リソースでは通常、クライアント、サーバー、NUI、それらの境界（net events、lib.callback、exports、state bags）、データ（データベーステーブル、data/ ファイル、convars）が該当します。それぞれの観点を記入した EXPLORER-PROMPT.md を使い、各 explore サブエージェントを同時に起動します。

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

すべての調査エージェントからの結果が返ってきたら、すべての調査結果を記入した EXPLAINER-PROMPT.md を使い、hardest tasks サブエージェントを 1 つ起動します。

4. 提示

説明役エージェントの出力を提示します。会話の流れに応じて、明確さや背景情報のために軽く編集してもかまいません。大幅な書き換えはしないでください。

出力形式

説明では、EXPLAINER-PROMPT.md で定義されているセクションを使い、該当しないものは省略します。概要、主要な概念、仕組み、各要素の配置場所、注意点。