Revos：AI生成コードのアーキテクチャチェックツール

Revosは、AI支援によるソフトウェア開発のためのアーキテクチャガバナンスツールです。現代のチームはAIコーディングツールを使って高速にコードを生成できますが、コンパイルが通りテストに合格しても、アーキテクチャは徐々に悪化することがあります。Revosは、コードベースをスキャンして依存関係グラフを生成し、建築違反を検出し、問題の説明と修正提案を行います。

よくある問題としては、UIコンポーネントがデータベースクライアントを直接インポートする、ドメインコードがフレームワークに依存する、コントローラーがリポジトリやデータベースに直接アクセスする、クライアントコードがサーバーのみのモジュールをインポートする、循環依存などがあります。Revosはこれらの問題を早期にキャッチします。

Revosはnpxを使ってすぐに実行できます：npx @revoscli/cli scan https://github.com/fastapi/fastapi --report all。グローバルインストールも可能です。ローカルプロジェクトやパブリックGitHubリポジトリ、サブディレクトリのスキャンに対応しています。初期化時には、clean-architecture、nextjs、nestjs、laravel、fastapiなどのプリセットを選択するか、--autoで自動検出できます。

現在サポートされている言語とフレームワークは、TypeScript（TSX、React、Next.js、NestJS、Express）、Laravel/PHP、Python（FastAPI、Django、Flask）です。循環依存や禁止されたインポートルールなどを検出し、MarkdownまたはJSON形式のレポートを生成します。CIでは--fail-on highオプションで重大な問題がある場合にパイプラインを失敗させることができます。

Revosは現在アルファ段階であり、「AI時代のアーキテクチャガードレール」として位置づけられています。成熟した静的解析ツールの完全な代替品ではなく、一般的なアーキテクチャの劣化を検出し、フレームワークの境界をクリーンに保ち、CIで重大なアーキテクチャ問題を失敗させ、チームが生成コードをレビューするのを支援し、アーキテクチャ問題を明確に説明することに役立ちます。

今後のロードマップには、GitHub Code ScanningのためのSARIF出力、モノレポ可視化の改善、誤検出フィルタリングの改善、フレームワークプリセットの追加、HTMLレポート、現実世界のリポジトリベンチマークの追加などが含まれています。ライセンスはMITで、GitHubで公開されています。