Definition：
FFF[fff.nvim]は, AIエージェントおよびNeovim環境におけるコードベース探索のために設計された, 高速インデックス型ファイル検索ツールキットである.単なるファジーファインダではなく, ファイル集合に対する検索・順位付け・履歴学習を統合した探索基盤であり, ユーザーおよびエージェントの操作履歴を反映した動的ランキングによって, 参照すべきファイル集合を確率的に近似するシステムである.
従来のNeovim周辺ツール, たとえばfzfやTelescope.nvimに代表される検索系プラグインの限界がある.これらは主として逐次的なテキストマッチングに依存し, 検索のたびにファイルシステムや外部コマンド[ripgrepなど]を走査する構造であったため, 大規模リポジトリにおいては応答遅延とノイズ混入が避けられなかった.また, 検索結果は基本的に文字列一致度に依存しており, 開発者が実際に参照する重要ファイルを優先的に提示する機構を欠いていた.
こうした問題は, AIエージェントがコードベースを解釈する際にさらに深刻化する.エージェントは探索対象の選別に失敗すると不要なファイルを読み込み, トークン消費と推論精度の双方に悪影響を及ぼす.この問題意識のもとで, ファイル探索を「検索」ではなく「優先度推定」として再定式化する試みとしてFFFが開発された.
この設計思想は, バックエンドに常駐するインデックスエンジンの導入に具体化されている.FFFはRustで実装された検索エンジンを中核に持ち, プロジェクト全体のファイル構造およびメタデータを事前に構築・保持する.このインデックスにはファイルパスや内容のトークンだけでなく, アクセス履歴や更新頻度といった動的情報も含まれる.Neovim側はLuaを通じてこのエンジンと通信し, ユーザー入力に対してインクリメンタルに検索クエリを発行する.
これにより, 従来の「毎回スキャンする」方式から「構築済みの検索空間に対する問い合わせ」へとパラダイムが転換され, 数万規模のファイル集合に対してもミリ秒オーダーの応答が可能となる.なお, インデックスはバックグラウンドで差分更新される設計であり, ファイルシステムの変更がリアルタイムに反映されることが前提とされている.この点は, 静的なスナップショットを使用する一部の類似ツールと異なる重要な特性である.
順位付けの中核には, 頻度[frequency]と最近性[recency]を組み合わせた指標, いわゆるfrecencyが採用されている.これはzoxideやz.shなどで知られるディレクトリジャンプ系ツールに類似したヒューリスティクスを, ファイル探索向けに拡張したものである.単純なキャッシュヒューリスティクスにとどまらず, ユーザーの操作履歴を時間減衰付きで評価し, 現在の文脈におけるファイルの重要度を推定するモデルである.
さらに, Gitの変更状態, ファイルの依存関係, ディレクトリ構造上の位置などが統合され, 結果として「今開くべきファイル」が上位に現れるよう設計されている.このような順位付けは静的な検索アルゴリズムとは異なり, 使用に伴って逐次更新されるため, ツール自体が環境に適応する性質を持つ.
機能面では, ファイル検索・全文検索・パターン検索といった基本操作が一体化されているが, それらはすべて同一のインデックスとランキング機構の上に構築されている.したがって, 単なる文字列一致ではなく, 文脈に応じた候補集合の絞り込みが行われる.また, クエリ構文によるパス制約や除外指定, 履歴に基づくクエリ補完, 複数条件の同時検索といった機構が統合されており, 探索行為そのものが状態遷移として扱われる.結果として, ユーザーは検索を繰り返すのではなく, 逐次的に探索空間を収束させる操作を行うことになる.
FFFは, 従来のファイル検索ツールを単純に置き換えるものではなく, コードベース探索を確率的推定問題として再構成した実装である.特にAIエージェントとの親和性は高く, 限られたトークン予算のもとで重要なファイル群を優先的に抽出する前処理層として機能する.すなわち, FFFはエディタ拡張の一種でありながら, 同時にプログラム理解における情報選択問題を担う基盤的コンポーネントでもある.
Mathematics is the language with which God has written the universe.