I built a Claude Code plugin that reviews your code through the lens of 10 classic software engineering books — and v0.7.0 just shipped.
What is brooks-lint?
brooks-lint diagnoses code quality by applying principles from books like Refactoring, Clean Code, Designing Data-Intensive Applications, A Philosophy of Software Design, and 6 more.
It surfaces decay risks across four modes:
- PR Review — catch issues before merge
- Architecture Audit — spot structural decay
- Tech Debt Assessment — classify and prioritize debt
- Test Quality Review — evaluate test health
Each finding follows the Iron Law: Symptom → Source → Consequence → Remedy, with a Health Score (base 100, deductions per finding).
What's new in v0.7.0
Project config (.brooks-lint.yaml)
Teams can now customize review behavior per project:
disable: [T3] # skip coverage checks
severity:
R1: suggestion # downgrade severity
ignore: ["**/vendor/**"]
focus: [R1, R2, R3] # evaluate only these risks
10-book framework
Expanded from 6 to 10 books, adding:
- A Philosophy of Software Design — Ousterhout
- Software Engineering at Google
- Working Effectively with Legacy Code — Feathers
- xUnit Test Patterns — Meszaros
Short-form commands
/brooks-review, /brooks-audit, /brooks-debt, /brooks-test — no namespace prefix needed.
The 6 decay risks
| Code | Risk | Books |
|---|---|---|
| R1 | Responsibility Creep | Clean Code, Refactoring |
| R2 | Implicit Contract | Hyrum's Law |
| R3 | Shallow Module | A Philosophy of Software Design |
| R4 | Premature Generalization | Mythical Man-Month |
| R5 | Test-Prod Divergence | xUnit Test Patterns |
| R6 | Consistency Erosion | Software Engineering at Google |
Plus 6 test-space decay risks (T1–T6) for the Test Quality Review mode.
Install
# Via Claude Code plugin marketplace
/plugin marketplace add hyhmrright/brooks-lint
/plugin install brooks-lint@brooks-lint-marketplace
Links
- GitHub: https://github.com/hyhmrright/brooks-lint
- Feedback welcome in the issues section!
