Sentinel：55秒でコードベースをAIエージェント向けにマッピング、クラウド不要、依存関係ゼロ

AIにコードベースを理解させたいが、クラウドにアップロードしたくない開発者向けに、Sentinelは新しいソリューションを提供します。これはローカルで動作する依存関係ゼロのコードベーススキャナーで、任意のリポジトリを構造化されたトークン効率の良いインテリジェンスに変換し、Claude Code、Cline、CodexなどのAIコーディングエージェントで利用できます。

コア機能

Sentinelの核心は、その極限的な速度とシンプルさです。Python標準ライブラリのみを使用し、追加の依存関係を一切必要とせず、55秒で25,000ファイル（例：Kubernetesリポジトリ）のスキャンを完了します。スキャン後、以下の重要な出力を生成します：

• 健全性スコア：保守性、ランタイム複雑性、テストシグナル、セキュリティなどの観点から総合評価し、詳細な内訳を提供。
• ホットスポットとリスク：巨大ファイル、TODO密度、ドキュメントの乖離などを特定し、実行可能な提案を提供。
• エントリポイント検出：ランタイムエントリポイント（Goバイナリなど）をインテリジェントに識別し、ボーナススコアを付与。
• エージェントプロンプト：Cline、Claude Codeなどのツール向けにコピー＆ペースト可能なプロンプトを生成。
• コンテキストパック：約2,500トークンのコンパクトなプロジェクト概要で、数時間のファイル読み取りを代替。

パフォーマンス

Sentinelのスキャン速度は印象的です：

• Pythonライブラリ（234ファイル、42K行）：0.16秒、健全性86%。
• FastAPIフレームワーク（約1000ファイル、約200K行）：4.56秒、健全性74%。
• Kubernetesリポジトリ（25,432ファイル、6,007,991行）：55秒、健全性74%。
• Ladybirdブラウザエンジン（約40Kファイル、約1.4M行）：約40秒。

すべてのスキャンはローカルで完全に実行され、クラウドサービスは関与しません。

インストールと使用法

インストールは非常に簡単：pip install git+https://github.com/Ntooxx/Sentinel.git。Windowsユーザーはinstall.ps1をダブルクリックするだけです。インストール後、project-sentinelコマンドがグローバルに使用可能になります。

主なコマンド：

• scan：プロジェクト構造、リスク、ホットスポットを分析。
• dashboard：ブラウザGUIを起動し、視覚的な操作インターフェースを提供。
• report：MarkdownまたはHTMLレポートを生成。
• prompt：AIエージェント向けの次のステッププロンプトを生成。
• ask：プロジェクトに関する自然言語での質問に回答。

技術的ハイライト

Sentinelは、プロジェクト名の解決や目的推論において精巧な設計を示しています。プロジェクト名の解決には5段階のフォールバックメカニズムを採用し、「Sponsors」などの無関係な単語がプロジェクト名として誤認識されるのを防ぎます。目的推論も6段階のフォールバックチェーンを使用し、意味のある結果を返すことを保証します。さらに、HTMLタグやMarkdownリンクなどのノイズ情報を自動的に除去するテキスト安全フィルタリング機能も備えています。

開発者エコシステム

Sentinelには197のテストが含まれており、すべて合格し、テスト実行時間はわずか9.3秒です。拡張が容易で、コントリビューションを歓迎します。プロジェクトはオープンソースライセンスの下で提供され、詳細なコントリビューションガイドと行動規範が用意されています。

要約すると、SentinelはAIエージェントがコードベースを理解するための効率的で安全かつローカルなソリューションを提供し、プライバシーとトークン消費を重視する開発者に特に適しています。