TheOrcDev/shadscan

解決する課題

Shadscan は、shadcn/ui で構築された React アプリケーション向けの決定論的 UI オーディットツールです。開発時にしばしば見過ごされがちな、コマンドメニュー、アクセシビリティ制御、モバイル動作などの欠落した製品詳細や UI の基本要素を特定し、UI の品質を 0 から 100 のスコアで数値化します。

動作方法

このツールは、プロジェクトのコードに対して静的ソースオーディットを実行し、62 の決定論的チェックを内包したルールセットと照合して評価します。また、隔離された Chromium ブラウザを使用してレンダリングされた UI のチェックも可能で、モバイルおよびデスクトップのビューポートにおける水平方向のオーバーフローなどの問題を検出できます。結果は、修正、判断、助言の3つのカテゴリに分類され、JSON 形式でエクスポートしたり、コードエージェント用のプロンプトとして利用できます。

対象ユーザー

shadcn/ui と React（Next.js、React Router、TanStack Start、Astro など）を使用するフロントエンド開発者やチームで、アクセシビリティ、インタラクション、プロダクションの完成度の高い基準を満たすアプリケーションを確保したい方。

主な特徴

• 決定論的分析: AI モデル、アプリケーションのシークレット、アプリの起動を必要とせず、読み取り専用のスキャンを実行（ソースオーディット用）。
• エージェントへの引き渡し: コードエージェントが修正を実装できるように、ペースト可能な修復計画を生成。
• MCP Server: AI エージェントがオーディット結果を型付きのツール呼び出しとして照会できる Model Context Protocol サーバーを提供。
• マルチフレームワーク対応: モノレポやハイブリッド Next.js プロジェクトを含む、さまざまな React 環境で動作。
• CI/CD 統合: GitHub Action を提供し、スコアの下限を強制し、GitHub Issues で発見内容を追跡可能に。