brooks-lint は古典的な設計原則をコードレビューへどう落とすか
hyhmrright/brooks-lintは実運用向けに使える実用的なオープンソース実装で、再利用可能な導入ルートを持つプロジェクトです。
ひと目でわかる
- これは何？
- 12冊のソフトウェア工学書を6つのコード劣化リスクと6つのテストリスクへ対応付け、引用可能な指摘を生成する Agent Skills プラグイン。
- 誰に向いている？
- brooks-lintは12冊の工学書を、引用・重大度・ヘルススコア付きの構造化レビューチェックリストに変換する。linterが見落とす劣化リスクを対象とし、再現可能なパーサーベンチマークを提供する一方、ライブモデル結果が変動することを認めている。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 1 日前です。
- 何の言語で書かれている？
- 主に JavaScript です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
12冊の書籍、6つの本番リスク、6つのテストリスク
brooks-lintはJavaScriptのリポジトリで、Claude Code、Codex CLI、Gemini CLIなどのプラットフォーム向けにAgent SkillsとしてAIコードレビューをパッケージしている。説明によれば、『人月の神話』から『xUnitテストパターン』までの12冊の古典的工学書に基づいてレビューを行う。READMEは本番コードの6つの劣化リスク（認知過負荷、変更伝播、知識重複、偶発的複雑さ、依存関係の乱れ、ドメインモデルの歪み）を定義している。またテストスイートの6つの劣化リスク（テストの不明瞭さ、テストの脆さ、テスト重複、モック乱用、カバレッジ幻想、アーキテクチャ不一致）も定義している。各リスクは1冊以上の書籍に対応付けられ、その対応はskills/_shared/source-coverage.mdに記録されている。
指摘は4つの要素と書籍引用で構成される
READMEはPythonメソッドのレビュー例を示している。brooks-lintはそのメソッドにヘルススコア28/100を与え、各指摘に「症状、原因、結果、対策」の4つのフィールドを付けて列挙する。原因フィールドは書籍と概念を示し、例えばFowlerの『リファクタリング』における発散する変更、McConnellの『Code Complete』における通常でない制御構造などがある。指摘には重大度ラベルが付き、赤・黄・緑で表示される。アーキテクチャ監査モードでは、レポートの先頭にMermaid依存関係グラフが含まれ、モジュールが重大度ごとに色分けされ、GitHubやNotionでそのまま表示される。
6つのスキルとインストール方法
リポジトリには6つのスキルがあり、それぞれスラッシュコマンドを持つ。/brooks-reviewはPRレビュー、/brooks-auditはアーキテクチャと依存関係グラフ、/brooks-debtは技術負債の分類、/brooks-testはテストスイート品質、/brooks-healthは重み付き総合スコア、/brooks-sweepは安全な修正を自動適用する全スキャン。Claude Codeでは、READMEに/plugin marketplace add hyhmrright/brooks-lintと/plugin install brooks-lint@brooks-lint-marketplaceとある。他のプラットフォームでは、curlインストーラがスキルをフラットにコピーする。READMEはClaude Code、Gemini CLI、Codex CLIはメンテナが検証済みと述べる。他のプラットフォームは公式スキル仕様から文書化されファイルレイアウトレベルでテストされているが、メンテナによるエンドツーエンドの実行はまだ行われていない。
ベンチマークの主張と再現可能な部分
READMEには2種類の結果が含まれる。Claude単体との比較表は説明用とラベル付けされ、brooks-lintの総合合格率94%、Claude16%と報告している。再現可能なのはパーサーの忠実度で、凍結された30件のモデル生成レポートに対してnpm run benchmarkを実行すると、重大度数の正確一致が30/30、56個の指摘レベルのリスクコードで適合率・再現率とも100%となる。厳格さプリセットは固定の指摘セットに対して固定スコアを生成する。strict 34、balanced 54、legacy-friendly 74。READMEはまた57シナリオの評価スイートを説明している。パーサーベンチマークはツールがレポート内のすべての指摘を読み取れるかを測定するもので、指摘自体の正しさを測定するものではないと明言し、厳格さと評価スイートの数値は単回のライブ測定であり変動するとしている。
設定、GitHub Action、SARIF出力
プロジェクトルートの.brooks-lint.yamlファイルで、厳格さ、無効化するリスクコード、重大度の上書き、無視するglob、フォーカスリスト、カスタムリスクコード、抑制ルールを制御する。READMEはすべての設定が任意であると述べている。GitHub ActionはPRコメントを投稿し、ヘルススコアがしきい値を下回った場合、重大な指摘が出現した場合、または前回からスコアが悪化した場合にチェックを失敗させることができる。SARIFファイルを出力してGitHub Code Scanningに使うこともできる。READMEはPR実行あたりのコストを約0.05〜0.15ドルと見積もり、diffサイズとモデルに依存するとし、pull_requestイベントでのみ実行することを推奨している。
ライセンス、検証状況、READMEが述べていないこと
プロジェクトはMITライセンスで、著作権はhyhmrrightが保有する。ライセンスは使用、複製、変更、統合、公開、配布、サブライセンス、販売を許可し、保証を放棄する。READMEは、インストーラプラットフォームの検証状況を除き、セキュリティ保証、サポート契約、本番準備性について述べていない。正式なバージョン履歴もなく、マイルストーン一覧と1.4.3を示すバージョンバッジがあるだけである。リポジトリメタデータは1284スター、61フォーク、2つの未解決問題を挙げ、プロジェクトはアーカイブされていない。
実際に試す場合は、まずリポジトリ直下の .brooks-lint.yaml を置かずに /brooks-review を実行し、症状、出典、結果、対策の順序で指摘が返るかを確認する。次に skills/_shared/source-coverage.md の対応表と出力のリスクコードを突き合わせると、書籍の概念が単なる飾りか、診断結果へ結び付いているかを判定できる。SARIF を使う運用では、GitHub Code Scanning に登録された重大度と、README が説明する赤黄緑の表示が一致するかも見る。
編集部の結論
brooks-lintは12冊の工学書を、引用・重大度・ヘルススコア付きの構造化レビューチェックリストに変換する。linterが見落とす劣化リスクを対象とし、再現可能なパーサーベンチマークを提供する一方、ライブモデル結果が変動することを認めている。MITライセンスがコードをカバーするが、READMEはサポートやセキュリティ保証について何も述べていない。
コミュニティノート