Brooks-Lint

What's New

Mermaid Dependency Graph in Architecture Audit (Mode 2) — the plain-text ASCII dependency map is replaced with a visual Mermaid diagram that renders natively in GitHub, VS Code, and Notion.

Highlights

• Color-coded nodes by severity: red (Critical), yellow (Warning), green (clean)
• Folder-based grouping using Mermaid subgraphs
• Circular dependency marking with dotted labeled edges
• Graph-first report layout — diagram at the top for immediate architectural overview
• Two-pass generation — structure first, colors after findings

Example Output

graph TD
    subgraph src/api
        AuthController
        UserController
    end
    subgraph src/domain
        UserService
        OrderService
    end
    subgraph src/infra
        Database
        EmailClient
    end

    AuthController --> UserService
    UserController --> UserService
    UserController --> OrderService
    OrderService --> UserService
    OrderService --> EmailClient
    UserService --> Database
    EmailClient -.->|circular| OrderService

    classDef critical fill:#ff6b6b,stroke:#c92a2a,color:#fff
    classDef warning fill:#ffd43b,stroke:#e67700
    classDef clean fill:#51cf66,stroke:#2b8a3e,color:#fff

    class OrderService,EmailClient critical
    class AuthController warning
    class UserService,UserController,Database clean

Install

Claude Code

/plugin marketplace add hyhmrright/brooks-lint
/plugin install brooks-lint@brooks-lint-marketplace

Gemini CLI

/extensions install https://github.com/hyhmrright/brooks-lint

Full changelog: https://github.com/hyhmrright/brooks-lint/blob/main/CHANGELOG.md