Brooks Lint

brooks-lint

AI code reviews grounded in twelve classic engineering books. Consistent. Traceable. Actionable.

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español

Quick Start • The Six Decay Risks • What It Looks Like • Benchmark • Installation

→ Visit the website

---

"The bearing of a child takes nine months, no matter how many women are assigned." — Frederick Brooks, The Mythical Man-Month (1975)

50 years later, Brooks was still right — and so were McConnell, Fowler, Martin, Hunt & Thomas, Evans, Ousterhout, Winters, Meszaros, Osherove, Feathers, and the Google Testing team.

Most code quality tools count lines and cyclomatic complexity. brooks-lint goes deeper — it diagnoses your code against six decay risk dimensions synthesized from twelve classic engineering books, producing structured findings with book citations, severity labels, and concrete remedies every time.

For the full source-to-skill mapping, including exceptions and false-positive guards, see skills/_shared/source-coverage.md.

Quick Start

# Claude Code
/plugin marketplace add hyhmrright/brooks-lint
/plugin install brooks-lint@brooks-lint-marketplace

# Any other Agent Skills platform — Cursor · Codex · Gemini · Copilot · Windsurf · OpenCode · Kiro · Bob …
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- 

Then just ask ("review this PR", "audit the architecture"), or run one of the six commands — /brooks-review, /brooks-audit, /brooks-debt, /brooks-test, /brooks-health, /brooks-sweep (what each one does).

Every finding comes back as Symptom → Source → Consequence → Remedy with a book citation and a 0–100 Health Score. Full install options (10 more platforms) and CI/CD setup are below.

The Twelve Books

Book	Author	Contributes to
The Mythical Man-Month (1975)	Frederick P. Brooks Jr.	R2, R4, R5
Code Complete (1993, 2nd ed. 2004)	Steve McConnell	R1, R4
Refactoring (1999, 2nd ed. 2018)	Martin Fowler	R1, R2, R3, R4, R6
Clean Architecture (2017)	Robert C. Martin	R2, R5
The Pragmatic Programmer (1999, 20th Anniv. 2019)	Andrew Hunt & David Thomas	R2, R3, R4, R5, T2, T3
Domain-Driven Design (2003)	Eric Evans	R1, R3, R6
A Philosophy of Software Design (2018)	John Ousterhout	R1, R4
Software Engineering at Google (2020)	Winters, Manshreck & Wright	R2, R5
The Art of Unit Testing (2009, 3rd ed. 2023)	Roy Osherove	T1, T2, T4, T5
How Google Tests Software (2012)	Whittaker, Arbon & Carollo	T5, T6
Working Effectively with Legacy Code (2004)	Michael Feathers	T4, T5, T6
xUnit Test Patterns (2007)	Gerard Meszaros	T1, T2, T3, T4

The Six Decay Risks

brooks-lint evaluates your code across six production-code decay risks and six test-suite decay risks synthesized from twelve classic engineering books: