hyhmrright/brooks-lint

何を解決するか

brooks-lint は、AIを活用したコードレビュー・ツールで、従来のリンター（構文やスタイルに焦点を当てている）が通常見落とす、アーキテクチャのずれ、技術的負債、ドメインモデルの歪みといった問題を特定します。これは、一般的なAIの提案ではなく、確立されたソフトウェア工学の原則に基づいた、構造的で追跡可能なコード品質評価の方法を提供します。

動作方法

このツールは、12冊の古典的工学書（『神話的な人間月』、『クリーンアーキテクチャ』、『リファクタリング』など）からの原則を統合し、12の「腐敗リスク」（生産コード用6つ、テストスイート用6つ）にわたってコードを診断します。

コードレビュー時に、厳密な診断プロセスに従います：症状 → 原因 → 結果 → 対処法。各発見には、書籍の引用、重大度ラベル（Critical、Warning、Suggestion）、および数値のヘルススコア（0–100）が付与されます。

対象ユーザー

LLMのパターンではなく、ソフトウェア工学の文献に基づいた一貫性のある、根拠に基づいたコードレビューとアーキテクチャ監査を求めるソフトウェアエンジニアやアーキテクト向けです。

主な特徴

• 書籍に基づく分析：すべての発見が12冊の古典的ソフトウェア工学書のいずれかに遡ります。
• 6つの生産腐敗リスク：認知的過負荷、変更の伝搬、依存関係の混乱などの問題を診断します。
• アーキテクチャ監査：Mermaid依存関係図を生成し、モジュール間の関係を可視化し、循環依存を特定します。
• マルチプラットフォーム対応：Claude Code、Cursor、Windsurf、GitHub Copilotなど、さまざまなAIコーディングアシスタントに「エージェントスキル」として統合可能です。
• 包括的なツールセット：技術的負債のロードマップ作成（/brooks-debt）、テストスイート監査（/brooks-test）、自動修正（/brooks-sweep）のための専用コマンドを備えています。