brooks-audit について
コードベースのアーキテクチャを監査し、劣化リスクを報告する Brooks-Lint スキルです。オンボーディングモードでは診断ではなく、コードベースを説明します。
主な機能
- 01Mermaid によるモジュール依存図の作成
- 02アーキテクチャ劣化リスクのスキャン
- 03テスト容易性の接点の評価
- 04Conway's Law との整合性確認
- 05コードベースの導入説明の生成
活用シーン
- 01コードベースのアーキテクチャ健全性の確認
- 02モジュール依存や劣化問題の発見
- 03新規開発者向けコードベース案内の準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/brooks-auditを入力して読み込まれたか確認します。
同梱ファイルarchitecture-guide.mdonboarding-guide.md
詳細
Brooks-Lint — アーキテクチャ監査
セットアップ
次の順番で読みます。
../_shared/common.md— 鉄則、プロジェクト設定、レポートテンプレート、健全性スコア../_shared/source-coverage.md— 書籍のカバレッジ、例外、トレードオフ../_shared/decay-risks.md— 症状の定義と情報源の帰属architecture-guide.md（このディレクトリ）— 監査フレームワーク
プロセス
オンボーディングモード： ユーザーがオンボーディングレポート、コードベースの案内、または「新しい開発者にこのコードベースを説明して」と依頼した場合は、このディレクトリの onboarding-guide.md を読み、architecture-guide.md の代わりにその手順に従います。このモードでは診断ではなく説明を行います。健全性スコアも、鉄則に関する指摘もありません。
スコープ： ユーザーがファイルやディレクトリを指定していない場合は、まず自動スコープ検出（../_shared/common.md）を適用します。
- コードベースのコンテキストを収集し、モジュール依存関係グラフをMermaidで作成します（ガイドのステップ0～1）
- 指定された順番で、各劣化リスクを調査します（ガイドのステップ2～4）
- 調査結果に基づいて、Mermaid図のノードに色（赤／黄／緑）を割り当てます（ステップ4の後）
- テスト容易性シーム評価を実施します（ガイドのステップ5）
- コンウェイの法則のチェックを実施します（ガイドのステップ6）
- common.md のレポートテンプレートを使って出力します。最初にMermaidグラフ、その後に指摘事項を記載します。
レポートのモード行： Architecture Audit
コメント
Markdown 対応