Brooks-Lint — Revisão de PR

Quando Usar

Use esta habilidade quando precisar de revisões de código de PR que identifiquem riscos de deterioração, "cheiros" de design e problemas de manutenibilidade com descobertas concretas de Sintoma → Origem → Consequência → Remédio, baseadas em doze livros clássicos de engenharia. Dispara quando: o usuário pede para revisar código, verificar um PR, compartilha um diff ou cola código pedindo...

Configuração

1. Leia ../_shared/common.md para as regras da Lei de Ferro, Configuração do Projeto, Modelo de Relatório e Pontuação de Saúde
2. Leia ../_shared/source-coverage.md para cobertura em nível de livro, exceções e trade-offs
3. Leia ../_shared/decay-risks.md para definições de sintomas e atribuições de origem
4. Leia pr-review-guide.md neste diretório para o processo de análise

Processo

Se o usuário não especificou arquivos ou colou código: aplique a Detecção Automática de Escopo de ../_shared/common.md para determinar o escopo da revisão antes de prosseguir.

1. Entenda o escopo da revisão, depois escaneie cada risco de deterioração na ordem especificada (Passos 1–6 do guia)
2. Execute o Teste Rápido (Passo 7 do guia) — pule para alterações apenas de documentação ou não de produção
3. Aplique a Lei de Ferro a cada descoberta
4. Saída usando o Modelo de Relatório de common.md

Linha de modo no relatório: PR Review

Exemplo

Solicitação do usuário:

Use @brooks-review para esta tarefa: Revisão de código de PR que identifique riscos de deterioração, "cheiros" de design e problemas de manutenibilidade com descobertas concretas de Sintoma → Origem → Consequência → Remédio, baseadas em doze livros clássicos de engenharia.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte upstream e ao contexto local do projeto.
• Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
• Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.