hyhmrright/brooks-lint

<p align="center"> <img src="assets/logo.svg" alt="brooks-lint" width="200"> </p> <h1 align="center">brooks-lint</h1> <p align="center"> <strong>AI code reviews grounded in twelve classic engineering books.<br> Consistent. Traceable. Actionable.</strong> </p> <p align="center"> <strong>English</strong> · <a href="README.zh-CN.md">简体中文</a> </p> <p align="center"> <a href="#the-six-decay-risks">The Six Decay Risks</a> • <a href="#what-it-looks-like">What It Looks Like</a> • <a href="#benchmark">Benchmark</a> • <a href="#installation">Installation</a> </p> <p align="center"> <img src="https://img.shields.io/badge/version-1.3.0-blue.svg" alt="Version"> <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License"> <img src="https://img.shields.io/badge/Claude_Code-Plugin-blueviolet.svg" alt="Claude Code Plugin"> <img src="https://img.shields.io/badge/Codex_CLI-Skill-orange.svg" alt="Codex CLI Skill"> <img src="https://img.shields.io/github/stars/hyhmrright/brooks-lint?style=social" alt="GitHub Stars"> </p> <p align="center"> <a href="https://hyhmrright.github.io/brooks-lint/"><img src="assets/demo.gif" alt="brooks-lint reviewing code: a /brooks-review command produces a 28/100 health score and cited Symptom → Source → Consequence → Remedy findings" width="820"></a> </p> <p align="center"> <strong><a href="https://hyhmrright.github.io/brooks-lint/">→ Visit the website</a></strong> </p>

---

"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, produ