brooks-lint
Portable AI code quality reviews for Codex, Cursor, Copilot and other coding agents: six Agent Skills for architecture, technical debt, tests and remediation.
What is brooks-lint?
Portable AI code quality reviews for Codex, Cursor, Copilot and other coding agents: six Agent Skills for architecture, technical debt, tests and remediation.
Overview of brooks-lint
What it is
brooks-lint is an AI code review tool that diagnoses code against six decay risk dimensions synthesized from twelve classic engineering books. It produces structured findings with book citations, severity labels, and concrete remedies. The tool is grounded in works by Brooks, McConnell, Fowler, Martin, Hunt & Thomas, Evans, Ousterhout, Winters, Meszaros, Osherove, Feathers, and the Google Testing team.
Key features
- Six production-code decay risks: Cognitive Overload, Change Propagation, Knowledge Duplication, Accidental Complexity, Dependency Disorder, Domain Model Distortion
- Six test-suite decay risks (from books on unit testing and legacy code)
- Structured findings format: Symptom → Source → Consequence → Remedy with book citations
- Health Score (0–100) per finding
- Six analysis modes: /brooks-review, /brooks-audit, /brooks-debt, /brooks-test, /brooks-health, /brooks-sweep
- Architecture audit with Mermaid dependency graph (color-coded by severity)
Use cases
- Pull request review
- Architecture audit
- Technical debt assessment
- Test quality review
- Full-sweep auto-fix analysis
Getting started
bash# 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 ask (e.g., “review this PR”, “audit the architecture”) or run one of the six commands.
License and pricing
License: MIT. Pricing: open source (free).
Based on the project's public README and repository metadata.