giancarloerra/SocratiCode

何を解決するか

SocratiCode は、大規模なリポジトリにおける深い意味的理解を AI アシスタントに提供するコードベースコンテキストエンジンです。AI エージェントが単純なテキスト検索（grep）では不十分な、数百万行に及ぶ複雑なコードベースをナビゲートする困難を解決します。アーキテクチャパターン、依存関係、シンボルレベルの影響を理解するためには、より高度な分析が必要です。

動作方法

このシステムは、AI ホストと統合するための Model Context Protocol (MCP) サーバーを使用しています。AST対応のコードチャンク分割と、ハイブリッド検索アプローチ（密度ベクトル埋め込み（意味検索）と BM25 スパースベクトル（キーワード検索）を Reciprocal Rank Fusion (RRF) で統合）を Qdrant ベクトルデータベースで実行します。また、18言語にわたるシンボルレベルの影響分析とコールフロー追跡を可能にするポリグロット依存関係グラフを構築しています。

対象ユーザー

企業レベルの大規模リポジトリ（最大4000万行のコードでテスト済み）で作業する開発者向けです。Claude Code、Cursor、VS Code Copilot、Gemini CLI などの AI コーディングアシスタントを使用しており、異なる AI ツール間でコンテキストを永続化できるツールに依存しないコンテキストレイヤーを必要とする方々です。

特徴

• ハイブリッド検索: 意味検索とキーワード検索を組み合わせ、高精度なコード検索を実現。
• 高度なインテリジェンス: 18言語にわたるシンボルレベルの影響範囲とコールフロー追跡を提供。
• ゼロ構成: Qdrant と Ollama の Docker ベース自動デプロイにより、プライバシー最優先のローカル第一の環境を実現。
• ツール非依存: 1つのインデックスを複数の AI エージェントや IDE で共有可能。
• 再開可能なインデキシング: チェックポイント付きバッチインデキシングにより、大規模リポジトリでのクラッシュや中断に対応。
• 視覚的探索: コード依存関係をナビゲートできるインタラクティブな HTML グラフエクスプローラーを内蔵。