Neura Market
brooks-lint logo

brooks-lint

Free

AI code reviews grounded in six classic engineering books — decay risk diagnostics with book citations, severity labels, and four analysis modes (PR review, architecture audit, tech debt, test quality). Install: `python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About brooks-lint

brooks-lint is an open-source AI code review tool that diagnoses code against six decay risk dimensions synthesized from twelve classic engineering books, including 'The Mythical Man-Month', 'Code Complete', 'Refactoring', and 'Clean Architecture'. It provides structured findings with book citations, severity labels, severity scores from 0 to 100, and concrete remedies. The tool supports six analysis modes: PR review, architecture audit with Mermaid dependency graphs, prioritized tech-debt roadmap, test-suite quality review, health dashboard across all dimensions, and a full-sweep mode that auto-fixes findings. It integrates with AI coding agents like Claude Code, Cursor, Codex, Gemini, Copilot, Windsurf, OpenCode, and Kiro, and can be installed via a plugin marketplace or a one-line shell script.

Key Features

Six decay risk dimensions synthesized from twelve classic engineering books
Structured findings with book citations, severity labels, and concrete remedies
Six analysis modes: PR review, architecture audit, tech-debt roadmap, test quality, health dashboard, full-sweep auto-fix
0–100 Health Score per finding
Mermaid dependency graph generation in architecture audit mode
Auto-fix capabilities in full-sweep mode
Supports multiple AI agent platforms (Claude Code, Cursor, Codex, Gemini, Copilot, Windsurf, OpenCode, Kiro)
Open source with multi-language documentation (English, Chinese, Japanese, Korean, Spanish)

Pros & Cons

Pros
  • Grounded in authoritative software engineering literature with direct book citations
  • Provides actionable, structured feedback with severity labels and health scores
  • Supports a wide range of popular AI coding agents and platforms
  • Free and open source with a permissive license
  • Offers six distinct analysis modes for different code review needs
  • Includes auto-fix capability for batch remediation
Cons
  • Requires integration with a supported AI agent or platform to function
  • Setup may involve installing plugins or running a shell script across multiple environments
  • Effectiveness depends on the underlying AI model's interpretation of the book principles

Best For

Reviewing pull requests for code quality and decay risksAuditing software architecture with dependency visualizationPrioritizing technical debt remediationEvaluating test suite quality and coverageMonitoring overall code health across multiple dimensionsAutomatically fixing identified code quality issues

FAQ

What platforms does brooks-lint support?
It supports Claude Code, Cursor, Codex, Gemini, Copilot, Windsurf, OpenCode, and Kiro platforms. It can be installed via each platform's plugin marketplace or a universal shell script.
How many books and decay risks does it use?
It synthesizes six decay risk dimensions from twelve classic software engineering books. The specific books and their contributions are documented in the repository.
What analysis modes are available?
Six modes: /brooks-review (PR review), /brooks-audit (architecture audit with Mermaid graphs), /brooks-debt (tech debt roadmap), /brooks-test (test quality), /brooks-health (health dashboard), /brooks-sweep (full auto-fix).