indexion-agent-orient

エージェントのオリエンテーションワークフロー

コードベースの不慣れな部分や、担当範囲が曖昧な部分で実装を始める前に、このスキルを使用します。

理由

コーディングエージェントは、ユーザーのプロンプトにあるパスや名詞を手がかりにしがちで、リポジトリの所有構造を把握する前に編集を始めてしまうことがよくあります。indexion agent orient は、選択したコードベース全体のオリエンテーションマップを段階的に構築し、AGENTS.md、CLAUDE.md、Claude のスラッシュコマンド、Codex のスキル、またはサブエージェントのプロンプトに貼り付けられる、根拠に基づいた簡潔な概要を生成します。

生成時の --limit は表示件数の上限にすぎません。所有者の推定には、コード構造、パッケージの README、wiki pages update、wiki pages ingest、plan reconcile によって出所が管理されている wiki ページを含む、事前に構築されたマップ全体を使う必要があります。

所有者のプロファイルでは、パッケージのドキュメントと所有者固有の wiki ページを使用します。複数のソースルートを含む広範な wiki ページは背景情報として役立ちますが、言及されているすべてのパッケージがタスクを所有している証拠として扱うべきではありません。

パイプライン

0. インストール済みの CLI にこのワークフローがあることを確認します。

   indexion agent orient --help
   

   このコマンドが見つからない場合は、先に進む前に indexion を更新または再ビルドしてください。 古い indexion バイナリが PATH にあるだけでは、このスキルを使うには不十分です。

1. 概要を生成します。

   indexion agent orient --task-file task.md --output=.indexion/cache/agent/orient.md .
   

   初回実行時に .indexion/cache/agent/orient-map.json が書き込まれます。以降の実行では、 変更されたファイルと影響を受けるオーナープロファイルのみが更新されます。保存済みのマップを 更新せずに参照する場合は、意図的に --no-update を使用してください。 ゼロ知識エージェントが、最新の事前構築済みマップから直ちにオーナー候補を推測する必要がある場合は、 このモードを使用します。

   短いタスクの場合：

   indexion agent orient --task "add a name/content drift audit" .
   

   ユーザーのタスクが、リポジトリの識別子や README の文章に見られない言語や言い回しで書かれている場合は、 元のタスクをメモに残し、コードベースで使われている語彙に置き換えた短い説明を --task に渡してください。 その説明では、推測したオーナーではなく、目的を述べてください。たとえば、未確認のパッケージ名を挙げるのではなく、 「名前と実装内容のずれを検出する」とします。

   オーナー推論用の --task の説明には、補助的なインフラストラクチャの制約を含めないでください。 元の依頼、必須ツール、実装上の制約は、メモまたはサブエージェントへのプロンプトに残してください。 説明に含めるのは、事前構築済みマップを検索するための目的の語彙だけです。たとえば：

   indexion agent orient --no-update --task "name/content drift scoring and remediation planning" .
   

2. 編集前に、以下のセクションを読みます。

   • Likely Implementation Owners：ドメインの動作を担当する中核パッケージです。 追加の証拠で否定されない限り、最初の項目を初期のオーナー仮説として扱います。
   • Knowledge Sources：タスクに一致したリリースノート、Wiki ページ、README、その他のドキュメントです。 これらは背景情報として使用してください。ドキュメントのみのパスを、ドメインの動作を実装する場所として扱わないでください。
   • Consumer Surfaces：中核を呼び出す可能性が高い CLI、スキル、ドキュメント、アダプターです。
   • Do Not Implement Here：ドメインの実装先として避けるべきファイルです。
   • Required Preflight：パッチを適用する前にエージェントが読むべきファイルです。
   • Orientation Map：表示が途中で切り詰められる前に使用した、ファイル、オーナー、ドキュメントの総数を確認できます。

3. 対象を絞ったツールでオーナーを確認します。

   indexion doc graph --format=text <likely-owner>
   indexion grep --semantic=name:<term> .
   indexion search "<task concept>" .
   

   概要に記載された用語とユーザーのタスクに含まれる用語を使い、広義のインフラストラクチャ用語だけに頼らないでください。 検索結果が有力なオーナーではなく補助システムに偏る場合は、オーナーを変更する前に、 名前や内容、ずれ、乖離、またはタスクを実際に定義するドメイン固有の用語を使って検索を絞り込んでください。

4. 実装の可否を判断します。

   • 編集しようとしているパスが Do Not Implement Here にある場合は、作業を中止して競合を説明します。
   • 想定するオーナーが Likely Implementation Owners にない場合は、 doc graph、grep、search、または explore でさらに証拠を集めます。
   • 概要と追加の証拠から動作を担当していると分かる場合を除き、CLI のコードは薄く保ちます。

5. ゼロ知識での委任に使用します。

   サブエージェントには、タスクと生成した方針概要のみを渡し、実装作業を割り当てる前に質問して理解度を確認します。 サブエージェントが、中核の実装オーナー、知識ソースを1つ、安全でない編集場所を1つ、 事前確認に必要な証拠のパスを1つ、すぐに挙げられることを確認してください。 この確認に合格すれば、事前構築済みマップによって適切なオーナーシップの前提が伝わった証拠になります。

外部エージェントとの対応付け

• Claude Code：安定したガイダンスは CLAUDE.md に、プロジェクトのコマンドは .claude/commands/ に、プロジェクトのサブエージェントは .claude/agents/ に保存します。
• Codex：安定したガイダンスは AGENTS.md またはスキルに保存し、委任するタスクのコンテキストに方針概要を貼り付けます。
• マルチエージェントのワークフロー：概要を構造化された引き継ぎ情報として使い、分離された各エージェントが同じリポジトリ固有の前提から作業を開始できるようにします。