hyhmrright/brooks-lint: README-based editorial guide

hyhmrright/brooks-lint describes itself in the README as "AI code reviews grounded in 12 classic engineering books , decay risk diagnostics with book citations, severity labels, and 6 analysis modes including full-sweep auto-fix". This article keeps to facts that can be checked in the repository. Stars, forks, and promotional badges are signals of attention, not proof of quality. Under "README", the README says: > "The bearing of a child takes nine months, no matter how many women are assigned." > , Frederick Brooks, The Mythical Man-Month (1975). That establishes the project's stated boundary, not a production test.

The README's "Roadmap" section gives a useful starting point for deciding whether the project fits: v0.5,v0.7: Test Quality Review, Mermaid dependency graph, .brooks-lint.yaml, 10-book expansion. If that problem is not yours, popularity is a poor reason to adopt it. Project names, commands, and component names are kept as written so a reader can return to the primary source without guessing at terminology. Another checkable README item is: v0.2,v0.4: Plugin infrastructure, six-book framework, decay risk dimensions, benchmark suite. It can shape a first test, but it does not replace testing in the intended environment.

The operating model is spread across sections such as "README". The source evidence includes: 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. This article does not turn missing architecture, performance, or security details into claims. A real deployment still needs a look at the repository layout, configuration files, and release history.

Start installation from the README's documented entry point. A command that can be checked in the source is: # 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 · … curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- <platform> When the README contains no runnable command, this article does not invent one. Open its "The Twelve Books" section and confirm system dependencies, default ports, and first-run initialization before using a public server.