Brooks Lint

Visão Geral

Brooks Lint é uma habilidade do Claude Code que revisa seu código através das lentes de 12 livros clássicos de engenharia de software. Em vez de verificar regras de estilo, ele pergunta: "O que os autores de The Pragmatic Programmer, Clean Code e Designing Data-Intensive Applications diriam sobre este código?"

Ele sintetiza os princípios de livros de engenharia marcantes em feedback acionável e estruturado — identificando "cheiros" de design, acoplamento forte, abstrações ausentes e riscos arquiteturais que linters e ferramentas de IA normalmente não pegam.

Nomeado em homenagem a Fred Brooks, autor de The Mythical Man-Month — porque os bugs mais difíceis são conceituais, não sintáticos.

Os 12 Livros

Quando Usar Esta Habilidade

• Use quando quiser feedback arquitetural além do que os linters fornecem
• Use antes de refatorações importantes para identificar dívida estrutural
• Use ao revisar código que "funciona, mas parece errado"
• Use ao se integrar a uma base de código para mapear rapidamente áreas de risco
• Use para revisões de design antes de iniciar um novo módulo ou serviço

Como Funciona

Brooks Lint aplica os princípios centrais de cada livro como uma lente de revisão:

1. Detecção de "cheiros": Sinaliza violações de DRY, SRP, Lei de Deméter, etc.
2. Análise de acoplamento: Identifica dependências fortes e camadas de abstração ausentes
3. Crítica de nomenclatura: Aplica regras de nomenclatura do Clean Code a variáveis, métodos e classes
4. Revisão de arquitetura: Verifica lacunas de consistência de dados e tolerância a falhas no estilo DDIA
5. Padrões de estabilidade: Sinaliza timeouts ausentes, retentativas e disjuntores (Release It!)
6. Pontuação de complexidade: Aplica métricas de complexidade do APOSD para identificar seções excessivamente projetadas

Instalação

# Install via Claude Code plugin marketplace
# Search: "brooks-lint" in Claude Code > Extensions

# Or install via NPX (Antigravity)
npx agentic-awesome-skills --claude
# Then invoke: @brooks-lint

Exemplos

Exemplo 1: Revisar uma Classe de Serviço

@brooks-lint review src/services/PaymentService.ts

Saída do Brooks Lint:

[Pragmatic Programmer] DRY violation: payment validation logic duplicated in 3 places
[Clean Code] Method processPayment() does 4 things — violates Single Responsibility
[Release It!] No timeout on external payment gateway call — risk of cascade failure
[DDIA] No idempotency key — retry on network error will double-charge
[APOSD] PaymentService knows too much about UserRepository — high coupling

Exemplo 2: Revisão Arquitetural de Base de Código Completa

@brooks-lint analyze the overall architecture of this codebase

Exemplo 3: Revisão Pré-Refatoração

@brooks-lint what are the biggest design smells in this module before I refactor it?

Categorias de Revisão

Melhores Práticas

…