brooks-lint — AI code reviews grounded in 12 classic engineering books (PR review, architecture audit, tech debt & test quality)

[hyhmrright]

What it does

brooks-lint diagnoses code against 6 decay risk dimensions synthesized from 12 classic engineering books (Brooks, Fowler, Martin, McConnell, Evans, Ousterhout and more).

Every finding follows a structured chain: Symptom → Source (book + chapter) → Consequence → Remedy

4 Modes

Command	Description
/brooks-review	PR-level code review
/brooks-audit	Architecture audit with Mermaid dependency graph
/brooks-debt	Tech debt assessment with prioritized roadmap
/brooks-test	Test suite health review (6 test decay risks)

Why it's different from plain Claude

	brooks-lint	Plain Claude
Structured findings	✅ 100%	❌ 0%
Book citations	✅ 100%	❌ 0%
Severity labels	✅ 100%	❌ 0%
Overall pass rate	94%	16%

Install

/plugin marketplace add hyhmrright/brooks-lint
Also works with Gemini CLI and Codex CLI. MIT licensed.

GitHub: https://github.com/hyhmrright/brooks-lint