brooks-sweep
Ajuda seu agente a analisar e corrigir vários aspectos da qualidade do código automaticamente. Ele aplica correções seguras e pede confirmação para as mais arriscadas.
O que ela faz
Esta ferramenta analisa seu código em busca de problemas como envelhecimento, má arquitetura, dívida técnica e falhas nos testes. Ela tenta corrigir automaticamente os problemas mais simples e pede sua permissão para corrigir os mais complexos.
Quando usar
- ✓Quando o código está ficando difícil de entender ou manter.
- ✓Antes de adicionar novas funcionalidades importantes.
- ✓Se você suspeita que há muitos erros escondidos no código.
Exemplo do que pedir para a IA
“Por favor, analise e corrija meu código em busca de problemas de qualidade.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta verifica seu código em quatro áreas: qualidade geral, testes, dívida técnica e auditoria. Ela aplica correções seguras automaticamente e pede sua aprovação para as mais arriscadas, sempre verificando se as correções funcionam.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill brooks-sweepOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/brooks-sweep/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Brooks-Lint — Varredura Completa e Correção Automática
Quando Usar
Use esta habilidade quando precisar do modo de varredura completa: executa uma análise unificada em todas as dimensões de qualidade — decadência de código, arquitetura, débito técnico e qualidade de testes — e então aplica correções diretamente na base de código. Mudanças seguras são aplicadas automaticamente; mudanças arriscadas são confirmadas antes da execução. Baseado em doze clássicos...
Configuração
- Leia
../_shared/common.mdpara as regras da Lei de Ferro, Configuração de Projeto, Modelo de Relatório e Pontuação de Saúde - Leia
../_shared/source-coverage.mdpara cobertura em nível de livro, exceções e trade-offs - Leia
../_shared/decay-risks.mdpara definições de sintomas de risco de produção - Leia
../_shared/test-decay-risks.mdpara definições de sintomas de risco de teste - Leia
sweep-guide.mdneste diretório para o processo unificado de varredura e correção
Processo
Se o usuário não especificou um projeto ou diretório: aplique a Detecção de Escopo Automática
de ../_shared/common.md para determinar o escopo da revisão antes de prosseguir.
- Mostre o aviso de consentimento pré-voo e aguarde a aprovação única do usuário (Passo 0 do guia)
- Enumere o escopo e inicialize o estado
unresolvable/non_critical_rounds/fix_log(Passo 1 do guia) - Execute as quatro dimensões em sequência — revisão, teste, débito, auditoria — cada uma escaneando, classificando, aplicando correções Seguras + Estendidas-Seguras e verificando através do comando de teste do projeto (Passos 2–5 do guia)
- Itere: re-escanear arquivos modificados + mesmo módulo + consumidores estáticos; convergir para uma rodada limpa, aposentar falhas de 3 tentativas no conjunto
unresolvable, limitar rodadas não críticas a 3 (Passo 6 do guia) - Agregue itens residuais e irresolúveis e gere o Relatório de Varredura Completa (Passos 7–8 do guia)
Linha de modo no relatório: Full Sweep
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente à sua fonte upstream e ao contexto do projeto local.
- Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar mudanças.
- 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.
Perguntas frequentes
O que são 'mudanças seguras' e 'mudanças arriscadas'?
Mudanças seguras são aquelas que a ferramenta tem alta confiança de que não vão quebrar o código. Mudanças arriscadas são aquelas que podem ter um impacto maior e, por isso, pedem sua permissão antes de serem aplicadas.
O que acontece se a ferramenta não conseguir corrigir um problema?
Problemas que não puderam ser resolvidos automaticamente são registrados para que você possa analisá-los depois.
Preciso aprovar cada correção?
Não, apenas as correções consideradas arriscadas. As seguras são aplicadas automaticamente.
Detalhes
Descrição original do autor
Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, architecture, tech debt, and test quality — then applies fixes directly to the codebase. Safe changes are auto-applied; risky changes are confirmed before execution.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #2449
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
cpp-testing
Faz seu agente escrever e melhorar testes para código C++. Ajuda a configurar ferramentas de teste e a corrigir erros.
affaan-m/ECC
csharp-testing
Ajuda seu agente a criar testes para código C# e .NET. Ele usa as melhores práticas para garantir que os testes sejam eficientes e confiáveis.
affaan-m/ECC
django-tdd
Faz seu agente aplicar estratégias de teste para Django com pytest-django e TDD. É útil para escrever testes robustos e garantir a qualidade do código, especialmente para APIs DRF.
affaan-m/ECC