hyhmrright/brooks-lint

brooks-lint は何をしますか？

10冊の古典的エンジニアリング書籍に基づくAIコードレビュー — 書籍引用、重大度ラベル、4つの分析モードを備えた劣化リスク診断ツール

概要

hyhmrright/brooks-lint は、以下の古典的エンジニアリング書籍の原則に基づいてコードをレビューし、設計劣化リスクを診断するAIエージェントスキルです。

• 『人月の神話』 — フレデリック・ブルックス
• 『デザインパターン』 — GoF
• 『Clean Code』 — ロバート・C・マーチン
• 『リファクタリング』 — マーティン・ファウラー
• 『ソフトウェアアーキテクチャの基礎』 — リチャーズ＆フォード
• 『実践ソフトウェアエンジニアリング』 — マンデルブロ
• 『Joel on Software』 — ジョエル・スポルスキー
• 『Code Complete』 — スティーブ・マコネル
• 『レガシーコード改善ガイド』 — マイケル・フェザーズ
• 『The Pragmatic Programmer』 — ハント＆トーマス

機能

• 書籍引用: 各指摘に関連する書籍と原則を引用
• 重大度ラベル: Critical / Major / Minor / Info
• 4つの分析モード:
  1. アーキテクチャモード: システム構造と設計パターンの問題
  2. 結合度モード: モジュール間の依存関係と結合度
  3. 凝集度モード: クラス/関数の責務と凝集度
  4. コードスメルモード: リファクタリングが必要な典型的なコードスメル

使い方

AIエージェント（Claude Code、Cursor、Codexなど）で使用する場合、以下のように指示してください：

/use hyhmrright/brooks-lint

その後、分析したいコードを提供するか、以下のモードを指定してください：

• architecture — アーキテクチャ分析
• coupling — 結合度分析
• cohesion — 凝集度分析
• smell — コードスメル分析

例

/use hyhmrright/brooks-lint
モード: architecture

以下のコードを分析してください：
[コードブロック]

出力形式

各分析結果は以下の形式で提供されます：

**問題**: [簡単な説明]
**書籍**: [書籍名] — [関連原則/引用]
**重大度**: [Critical/Major/Minor/Info]
**推奨**: [改善提案]

注意事項

• このスキルはコードレビューの補助ツールであり、人間のレビュワーに代わるものではありません。
• 引用される書籍の原則は一般的なガイドラインであり、特定のプロジェクト状況に応じて適宜判断してください。

---

このスキルは古典的エンジニアリングの知恵を現代の開発フローに取り入れるために設計されています。