sentrux

sentrux は、コードベースをリアルタイムに監視し、構造の健全性をひとつの0-10000品質スコアに変換する純Rust製のアーキテクチャセンサーです。「For You」フィードでは、AIエージェントがコードを書き直す中でプロジェクト構造が崩れないようにする「ライブマップ」と紹介されました。ファイルと依存チェーンを走査し、5つの根本要因指標を単一スコアにまとめ、MCP経由でそのシグナルをエージェントへ渡します。主張はシンプルです。エージェントは機械速度でコードを書く、センサーがなければコードベースも機械速度で腐敗します。

主な機能

• ひとつのスコア、5つの根本要因: モジュール性、非循環性、深さ、均等性、冗長性を幾何平均で合成。作者は「ゲームしにくい」と主張。
• ライブ・ツリーマップ: sentrux がGUIを開き、エージェントの書き込みに合わせてリアルタイム更新（diffや端末出力ではなく）。
• MCP統合: 9つのMCPツールで Claude Code、Cursor、Codex、OpenCode がスコアを照会し、劣化をゲートできます。
• ルールエンジン: .sentrux/rules.toml がレイヤー・境界・制約をエンコード。アーキテクチャの意図を機械可読な等級に。
• セッションゲート: セッション前に sentrux gate --save、後に sentrux gate で各エージェント実行の劣化を検知。
• CIフレンドリー: sentrux check . は0または1で終了し、悪いマージをブロック。
• 52言語: 言語知識はすべて plugin.toml と tags.scm クエリファイルに存在。言語追加にRustコードは不要。

使用シナリオ

このツールを使うべき人は？

• 長い Claude Code / Codex セッションを率いるリード: エージェント作業一週間でコードベースへの信頼を失った人。
• プラットフォームエンジニア: テストではなく「構造」に基づく品質ゲートをCIに入れたい人。
• リファクタリング計画担当: 始める前に結合・循環・god-fileを見たい人。
• vibeコーディングを取り入れつつ脱出口を求める人: アーキテクチャが読めなくなる前に止めたい人。

解決する問題

1. フィードバックループのない文脈腐敗: エージェントはコードがシステムに合わなくなった時点を知らず、自己修正できません。
2. 仕様先行のワークフロー: 大量のmarkdownを生むが、実際に届いたコードへの可視性はゼロ。
3. テストスイートは挙動を捉え、構造は捉えない: 変更が成長するシステムに合っているかのループを閉じるツールはありませんでした。

料金プラン

sentrux はオープンソースで、MIT ライセンス、無料。有料プランはなく、自分の計算資源だけがコストです。

優位性と独自の価値提案

1. 純Rust・単一バイナリ: ランタイム依存なし。リポジトリやコンテナに簡単に導入。
2. 設計上言語非依存: 言語ロジックはデータ駆動で、拡張はコンパイラ変更を意味しない。
3. 文脈腐敗ツールとの違い: コンテキストウィンドウを管理するのではなく、コードベース健全性の外部の真実源をエージェントに与えます。

ユーザーレビュー

「エージェントがコードの不自然さを推測する代わりに、明確な目標を得る——冗長性スコアを1000未満にしろ、と。この直接性がトークンを節約し、自己改善ループを実際に機能させます。」 — 独立請負、コミュニティ評の転記

「0-10000スコアは設計上ゲームしにくい。敵対的な押し上げに耐えるかが注目点です。」 — MCPまとめの実務者注記

はじめに

1. インストール: brew install sentrux/tap/sentrux（macOS）、curl スクリプト（Linux）、リリースバイナリ（Windows）。
2. GUIを開く: sentrux または sentrux /path/to/project。
3. ベースライン保存: セッション前に sentrux gate --save .。
4. 後の比較: sentrux gate .、CIでは sentrux check .。
5. エージェント接続: MCPクライアントを sentrux サーバーへ向け、毎回のライブスコアを参照。

一次リソース：sentrux.dev、sentrux GitHub リポジトリ、MCP統合のドキュメント。

よくある質問

sentrux はテストを実行したり機能を確認しますか？

いいえ。静的解析で構造（依存・ファイル構成・アーキテクチャ）を測定します。正しさはテストスイートの役目なので両方を使います。

AIエージェントなしでも使えますか？

はい。sentrux で可視化、CIで sentrux check を実行してルール適用、sentrux gate で経時的な品質を追跡できます。

52言語とは？

tree-sitter の plugin.toml が参照するプラグイン由来。バイナリ自体は汎用なので、言語追加にRustコードは不要です。

スコアは何で決まる？

5指標を幾何平均で合成。単一指標を膨らませても全体を押し上げるのは難しい設計です。

代替案

• LangGraph：エージェントのワークフローをオーケストレーションする層。コード構造センシングとは別レイヤー。
• CrewAI：マルチエージェントチーム構築用。コードベース測定には不向き。
• OpenCode：sentrux が構造フィードバックを供給できるエージェントCLI。

ヒントとベストプラクティス

1. 先にベースラインを取る: セッション前の gate --save が後の gate を意味あるものにします。
2. 自スタック向けにルールを書く: デフォルト制約は緩すぎたり厳しすぎたり。ルールエンジンにアーキテクチャ意図を置きましょう。
3. 機能テストを省略しない: sentrux は構造のみ。実際のテストスイートと組み合わせて。

まとめ

sentrux は、機械速度のコーディングに機械速度のガバナーを与えるセンサーです。計画やテストを置き換えるのではなく、どちらも届かなかった隙間を埋めます。もし毎日エージェントにコードベースを再形成されているなら、ひとつのスコアとひとつのMCPフックが、リライト前のドリフトを止める安価な手段です。