inspect-perf

inspect-perf — 意味的パフォーマンスとリソース効率の監査

ドメインの評価基準

1. 対象範囲と許容範囲のガードレール（無視する項目）

• 必須の対象範囲：ユーザーは対象パス（file、directory、または subsystem）を明示する必要があります。対象範囲が指定されていない場合は、直ちにターンを終了して対象範囲を尋ねてください。リポジトリ全体を推測でスキャンすることは禁止です。
• 意味的負債とマイクロベンチマーク：分析は、構造上のアルゴリズムリスク、I/O の増幅、リソースの保持に厳密に限定してください。サブマイクロ秒単位の命令レベルのマイクロ最適化、コンパイラーのインライン化に関する細かな指摘、コールドパスでの時期尚早なキャッシュは無視してください。
• 準拠する参照資料：パフォーマンスパターンは、references/performance-rubric.md のみに基づいて評価してください。

2. 判断の分岐：[LOCAL-FIX] と [ARCHITECTURAL-REFACTOR]

• [LOCAL-FIX]（関数内での局所的な最適化）：アルゴリズム上の検索インデックス化（$O(1)$ の set/map）、ループ不変式のループ外への移動、または単一のメソッド／ファイル内での文字列ビルダーへの置き換え。動作を維持する候補は /simplify-audit に回してください。新たなクエリ制限や結果の意味の変更が必要な場合は /changeset に回してください。
• [ARCHITECTURAL-REFACTOR]（システム全体の構造的な是正）：直積結合を分割クエリ／DataLoader に分解する、ネットワーク I/O をデータベーストランザクションから切り離す Transactional Outbox を抽出する、ワーカースレッドに処理を委譲する、または上限付き分散キャッシュを導入すること。是正は /changeset に回してください。

標準出力契約

# Performance Audit Dossier: <Target Scope>

## 1. Executive Summary
- **Target Inspected**: `<directory_or_file_path>`
- **Health Rating**: <OPTIMAL | LOCALIZED_BOTTLENECK | CRITICAL_DEGRADATION>
- **Primary Bottleneck**: <Single-sentence summary of highest-latency or highest-risk resource hazard>

## 2. Load-Bearing Defect Catalog
### [<CRITICAL | MAJOR>] [<LOCAL-FIX | ARCHITECTURAL-REFACTOR>] <Dimension>: `<Target Symbol / Query>`
- **Offending Code**: [<file>#L<N>](file:///path/to/file#L<N>)
- **Violated Rubric**: [<spec_or_dimension>](references/performance-rubric.md#anchor)
- **Smell**: <Observable bottleneck, complexity multiplier, or resource leak description>
- **Action**: <[LOCAL-FIX] Local optimization OR [ARCHITECTURAL-REFACTOR] Separation / batching path>

*(Emit 'No load-bearing performance defects observed across rubric dimensions' if clean)*

ルーティング

• 動作の同等性を監査できるローカルなインデックス化やビルダーの変更 → （/simplify-audit 経由）。
• 結果の意味の変更、またはシステム全体に関わる分割クエリ、outbox、接続プール、スレッドプールのリファクタリング → （/changeset 経由）。

実行プロトコル

1. 受付と対象範囲の確認：

   • 対象範囲（file、directory、または subsystem）を受け取ります。
   • 対象範囲の確認を徹底：明示的な対象範囲が指定されていない場合は、直ちにターンを終了し、ユーザーに次のように尋ねてください："Please specify an explicit target scope (file, directory, or subsystem) when invoking /inspect-perf."
   • references/performance-rubric.md を読み、その内容に基づいて分析してください。

2. 規模に応じた実践的な監査：

   • ターン内での実行（10 ファイル未満、またはまとまりのあるモジュール）：ルーブリックの観点に照らして、ターン内で直接コードを監査します。
   • サブエージェントへの分担（複数パッケージにまたがる広範なサブシステム）：分割した範囲または呼び出し元が宣言した予算に応じて、research サブエージェントを動的に調整しながら同時に起動します（役割：Performance Inspector (<Slice>)）。分割範囲の座標、見つかった手がかり、ドメインの評価基準、出力契約を与え、詳細なプロファイリングトレースは .agents/scratch/perf-<slice>-dossier.md に出力します。
   • セクション 1 のガードレールを徹底します。ホットパスではない箇所のマイクロベンチマーク由来のノイズは無視し、すべての指摘を [LOCAL-FIX] または [ARCHITECTURAL-REFACTOR] のいずれかに明示的に分類します。

3. 統合とターン終了の確認：

   • 調査結果を標準出力契約にまとめ、別途出力した調査資料があれば、その参照先を記載します。
   • 確定的な健全性評価（OPTIMAL、LOCALIZED_BOTTLENECK、CRITICAL_DEGRADATION）を付与します。
   • 完成した調査資料を会話に提示し、直ちにターンを終了します。