# hyhmrright/brooks-lint

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

Repository: https://github.com/hyhmrright/brooks-lint
Canonical: https://ross.abutalabs.com/products/brooks-lint
Homepage: https://hyhmrright.github.io/brooks-lint/
Language: JavaScript
License: MIT
License Family: permissive
Topics: architecture-review, code-quality, code-review, tech-debt, claude-code-plugin, clean-architecture, code-smells, refactoring, test-quality, gemini-cli-extension, codex-cli-plugin, ai-code-review, developer-tools, code-health, auto-fix, claude-code, static-analysis, agent-skills, deepseek-harness, dsh-plugin
Last push: 2026-08-24T04:07:06+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 98, longevity 11
- inputs: {"age_days": 160, "days_push": 9, "days_rel": 19, "gap_med": 1, "n_releases_24m": 32}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1418, forks 64 (observed 2026-08-28T04:04:40.251280+00:00)

## What it is
brooks-lint is an AI-powered code review plugin for Claude Code, Codex CLI, and Gemini CLI that diagnoses code against six decay risk dimensions synthesized from twelve classic software engineering books. It produces structured findings with book citations, severity labels, health scores, and concrete remedies, including a full-sweep mode that auto-fixes issues.

## Use cases
- review pull requests with AI grounded in classic engineering principles
- audit codebase architecture for dependency and complexity problems
- identify and prioritize technical debt with severity labels
- assess test suite quality and detect test decay
- generate a code health dashboard with a numeric score
- automatically fix code smells and architectural drift
- get cited explanations for why code is hard to maintain

## When to choose
- you use Claude Code, Codex CLI, or Gemini CLI and want structured, citation-backed code reviews
- you need to diagnose architectural drift, knowledge duplication, or accidental complexity beyond what linters catch
- you want consistent review output with a fixed Symptom → Source → Consequence → Remedy format
- you want language-agnostic code quality analysis with zero configuration

## When to avoid
- you need traditional deterministic linting with precise syntax rules
- you don't use any supported AI coding CLI and can't run LLM-based analysis
- you require guaranteed correctness of automated fixes without human review
- you need CI-native static analysis with low latency and no AI costs

## Facets
- artifact type: plugin
- maturity: active
- function: code-review, linter, developer-tools, llm-inference, prompt-engineering
- domain: developer-tools
- platform: cli, cross-platform
- tags: ai-code-review, claude-code-plugin, codex-cli-plugin, gemini-cli-extension, tech-debt, architecture-review, code-smells, refactoring, test-quality, auto-fix, agent-skills, book-citations, code-review, software-quality, automation

## Member repositories
- hyhmrright/brooks-lint (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:40.251280+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:57.574987+00:00, confidence not recorded.
  - readme: https://github.com/hyhmrright/brooks-lint (fetched 2026-08-28T04:04:40.251280+00:00, sha a612d6fb9492)
  - homepage: https://hyhmrright.github.io/brooks-lint/ (fetched 2026-08-29T11:50:41.261915+00:00, sha f146063df58d)
- Data as of 2026-08-30T08:39:29.467469+00:00.