Nanako0129/pilotfish

Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verification guards quality. One-prompt install.

解決する課題

pilotfish は Claude Code 用のマルチモデル・オーケストレーション層です。すべてのタスクに最先端モデル（Fable 5 や Opus など）を使用する際に発生する、高いトークンコストとクォータの枯渇問題を解決します。定型業務をより小型で安価なモデル（Sonnet および Haiku）にルーティングし、高度な知能が必要なプランニングや検証には高性能モデルを割り当てることで、品質を損なうことなくコストを削減し、クォータを節約します。

仕組み

~/.claude/ ディレクトリ内の3つの設定レイヤーを使用して、ロールベースの委譲システムを実装しています：

  1. Machine Layer (settings.json): プライマリ・オーケストレーター・モデル（例：opus）とフォールバック・チェーンを設定します。
  2. Roles Layer (agents/*.md): 必要な労力と能力に基づいて、特定のモデルティア（Haiku、Sonnet、または Opus）に固定された8つの特化型エージェント（例：scout、executor、verifier）を定義します。
  3. Policy Layer (CLAUDE.md): 特定のモデル名を指定せずに、これらのロールにどのように作業を委譲するかというルールを定義します。

ワークフローは、メインのオーケストレーター・セッションから、探索、実行、検証のための特化型サブエージェントへと流れます。例えば、Opus の新しいコンテキスト内の verifier エージェントは、品質を確保するために完了した作業に対して検証（チャレンジ）を行います。

対象者

ソフトウェアエンジニアリングのタスクに階層的なモデルアプローチを採用することで、APIコストやサブスクリプションのクォータを最適化したい Claude Code ユーザー（開発者）。

ハイライト

  • コストを意識したルーティング: 低負荷なタスク（シンボル検索など）は Haiku へ、中負荷の実装は Sonnet へルーティングし、プランニングやセキュリティレビューは Opus で行います。
  • 独立した検証: 新しいコンテキストを持つ verifier サブエージェントを使用することで、自己批判（self-critique）よりも優れた結果を出します。
  • しなやかな機能低下（Graceful Degradation）: モデルのエイリアスとフォールバック・チェーンを使用し、プライマリ・モデルが利用できなくなった場合でもシステムが機能し続けるようにします。
  • グローバルインストール: グローバルな Claude 設定に一度セットアップするだけで、すべてのプロジェクトに適用されます。
  • サブスクリプションの最適化: Claude のサブスクリプションで利用可能な、Sonnet 専用の追加クォータ・バケットを特化して活用します。