pilotfish – Claude Code のオーケストレーションポリシー

それは何か

pilotfish は、Anthropic の AI 搭載コーディングアシスタントである Claude Code にマルチモデルオーケストレーションレイヤーを追加するポリシーパッケージです。軽量な「ロールエージェント」（例：スカウト、メックエグゼキューター、セキュリティレビューア）のセットと、コーディングセッションの一部を最もコスト効率の高いモデルに自動的にルーティングするディスパッチポリシーを定義し、中央の「メインセッション」（Opus ファミリー）が高レベルの計画と最終判断を担当します。

なぜ存在するのか

典型的な Claude Code セッションでは、反復的でリスクの低い作業（検索、フォーマット、テストの足場）に多くのトークンを費やします。pilotfish は、これらの境界のあるタスクをより安価なモデル（Haiku、Sonnet）に分割し、計画、セキュリティレビュー、検証にはより高価な Opus モデルのみを使用するため、監視を犠牲にすることなくトークンコストを削減します。

仕組み

• ロール – 事前定義されたエージェントファイル（~/.claude/agents/*.md）。それぞれが特定のモデルと努力レベル（低/中/高）にバインドされています。
• ポリシー – インタラクションの形状（co_discover、explore_then_plan、execute）とタスクの難易度に基づいて、どのロールを呼び出すかを決定する CLAUDE.md ブロック。
• ディスパッチフロー – メインセッション（Opus）がオーケストレーションし、リポジトリの偵察にスカウト、機械的なコード生成にメックエグゼキューター、判断を要する実装にエグゼキューター、結果を反証するための検証者（新しい Opus コンテキスト）を呼び出すことができます。セキュリティ関連の作業は、読み取り専用のレビューアと中程度の努力のエグゼキューターを通過します。
• 努力レベル – ポリシーは Claude Code の CLAUDE_CODE_EFFORT_LEVEL オーバーライドを尊重します。それ以外の場合は、ロールごとに努力レベルを選択します（例：scout = 低、plan-verifier = 中、security-reviewer = 高）。

インストールオプション

1. プラグイン（macOS / Linux） – install/PLUGIN-INSTALL.md によるネイティブマーケットプレイスインストール。ポリシーをフックベースのプラグインとして追加します。Claude Code 2.1.219+ と、Linux では Ubuntu 20.04+/Debian 10+/Alpine 3.19+ が必要です。
2. レガシーグローバルインストール – タグ付きリリース（例：v1.5.0）をクローンし、ポリシーファイルを ~/.claude/ に書き込むランブックを使用して Claude Code を実行します。インストーラーは冪等であり、変更前にマージプランを表示します。

システムの運用

• 提供されている CLI ラッパー（/pilotfish）またはプラグイン UI を使用して、セッションのポリシーを有効にします。
• docs/usage.md でモデルエイリアス、努力しきい値を調整するか、委任を有効/無効にします。
• すべての変更は元に戻せます。インストーラーは 8 つのロールファイルとポリシーブロックをアンインストールできます。

ドキュメントと証拠

• 詳細な設計（docs/design.md）、モデル経済学の研究（docs/research.md）、およびフィールドレポートログが含まれています。
• ベンチマーク（ディスパッチブレーキ、自発的ディスパッチ、バトンアクティベーション、プロンプト圧縮、検証者境界）は、委任が発生する頻度とそのトークンへの影響に関する経験的な限界を提供します。

誰が使うべきか

• 大規模なコーディングセッションで Claude Code に依存し、トークンコストを削減しながら安全チェックを維持したい開発者。
• AI ワークフローに構造化されたセキュリティレビューと検証ステップを組み込む必要があるチーム。
• Claude Code の設定ファイルの編集と、macOS または Linux でのプラグインインストールの管理に慣れているパワーユーザー。

成熟度

• MIT ライセンスで、バージョン管理されたリリース履歴と変更ログがあります。
• 動作互換性に関する主張は、有料モデルの実行によって裏付けられています。継続的なスポンサーシップにより、さらなる検証が資金提供されています。
• Windows はサポートされていません。Linux サポートは「契約資格」です（テスト済みですが、正式には検証されていません）。

---

上記のすべての情報は、リポジトリの README から直接取得されています。追加の機能は推測されていません。