Este Linter Elimina o 'AI Code Slop'

Prompts sozinhos não salvarão sua base de código do lixo gerado por IA. Agentes de IA frequentemente ignoram ou contornam os padrões de codificação que você define meticulosamente em suas instruções, permitindo que código de baixa qualidade, ou "slop", entre em seus projetos. É fácil para os agentes desconsiderar as regras dos prompts, introduzindo inconsistências e problemas potenciais que comprometem a qualidade do código.

Esse slop normalmente não é um bug que interrompe a compilação imediatamente. Em vez disso, é um código de baixa evidência, como conversões de tipo inseguras (unsafe type casting), que corrói a type safety ao longo do tempo. O código compila normalmente, mas cria bugs sutis e difíceis de rastrear que surgem muito mais tarde, transformando pequenos descuidos em grandes dores de cabeça de depuração.

Considere um exemplo clássico: você extrai dados de uma JSON API, incluindo um campo createdAt que chega como uma string. Seu agente de IA pode converter isso diretamente para um objeto Date, apesar de o JSON não ter um tipo Date nativo. O código compila sem reclamações porque você disse explicitamente ao TypeScript para confiar em você. Mas isso cria uma bomba-relógio, pronta para travar sua aplicação no momento em que qualquer coisa tentar realizar uma operação de Date nessa string, que permanece sendo uma string.

Esqueça a esperança de que seus agentes de IA sigam magicamente suas diretrizes de codificação. Em vez disso, conheça o anti-slop: uma coleção de regras opinativas projetadas para o Oxlint. Este linter, escrito em Rust, ostenta uma velocidade incrível, rodando de 50 a 100 vezes mais rápido que o ESLint. Esse tipo de desempenho é crucial para ciclos de feedback rápidos, permitindo que desenvolvedores e agentes vejam problemas de código quase instantaneamente.

Ao contrário da natureza probabilística da engenharia de prompts, o linting é inteiramente determinístico. Ele atua como uma falha rígida, sinalizando imediatamente quaisquer padrões de código que sua equipe baniu explicitamente. Isso não é uma sugestão que sua IA pode considerar; é um portão de qualidade inegociável, garantindo que o 'slop' não possa se infiltrar em sua base de código.

O verdadeiro poder do anti-slop reside na sua personalização. Você não precisa adotar cada regra do pacote. As equipes podem selecionar meticulosamente as regras específicas que se alinham perfeitamente aos seus padrões de codificação existentes, criando um mecanismo de aplicação automatizado e altamente personalizado. Trata-se de construir um sistema robusto e previsível para a qualidade, não apenas jogar mais prompts no problema.

A verdadeira inovação com o anti-slop não é apenas sua velocidade; é a qualidade absoluta de suas mensagens de erro. Esqueça a saída tipicamente críptica do TypeScript que deixa os desenvolvedores coçando a cabeça, imaginando o que deu errado. Este linter diz exatamente por que seu código gerado por IA é problemático e, crucialmente, como corrigi-lo. Ele oferece insights diretos e acionáveis em vez de reclamações vagas.

Este feedback descritivo transforma mensagens de erro em "juicy data" (dados valiosos) para um agente de IA. Em vez de um simples passar/falhar, o linter evolui para um professor poderoso, guiando o agente a entender e reparar seus próprios erros. Isso muda seu papel significativamente, de um verificador de código básico para um ciclo de feedback inteligente e de autoaperfeiçoamento, economizando incontáveis horas de depuração manual.

O agentic workflow torna-se notavelmente eficiente:

• Um agente de IA produz seu código inicial.
• O anti-slop é executado, sinalizando instantaneamente quaisquer problemas.
• O agente então analisa a mensagem de erro detalhada, que inclui instruções específicas.
• Finalmente, o agente repara o código com base nessas diretrizes precisas, resultando em uma saída de maior qualidade. Esse processo iterativo evita que padrões de baixa evidência cheguem à produção. Para uma lista completa dessas regras opinativas, confira o repositório GitHub - dmmulroy/anti-slop: Opinionated Oxlint rules for rejecting low-evidence TypeScript and JavaScript patterns.

Implementar regras de anti-slop muda fundamentalmente o foco do seu desenvolvimento. Em vez de reagir a bugs após eles se manifestarem, você previne proativamente os padrões de baixa qualidade que os causam. Este linter detecta código problemático na fonte, como uma chain type assertion insegura que descarta evidências de tipo críticas. Por exemplo, converter uma resposta de API para unknown e depois para User pode ocultar o fato de que createdAt pode ser uma string, não uma data, introduzindo um bug latente antes mesmo de ser compilado.

Além da prevenção, o anti-slop formaliza os padrões de codificação da sua equipe. Ele estabelece um conjunto de regras legível por máquina e aplicável, economizando um tempo valioso de revisão humana em problemas comuns, porém críticos. Isso significa que você não precisa de um humano para sinalizar coisas como funções que retornam unknown ou outros padrões de TypeScript de baixa evidência. O linter sinaliza esses problemas, explicando por que são problemáticos e como corrigi-los, por exemplo, analisando entradas não confiáveis em seu limite.

Integre o anti-slop ao seu CI/CD pipeline ou a um ciclo de desenvolvimento local, e você poderá sistematicamente 'anti-slop' toda a sua base de código. Isso garante que tanto as contribuições humanas quanto as de IA atendam consistentemente a um padrão mais alto de qualidade e evidência. Agentes de IA, em particular, aprendem a produzir código à prova de falhas ao corrigir com base no feedback claro e acionável do linter, criando um sistema verdadeiramente robusto e sustentável.

O que é Anti-slop?

Anti-slop é um conjunto de regras de linting opinativas para Oxlint, um linter de JavaScript/TypeScript de alto desempenho. Ele foi projetado para rejeitar padrões de código de baixa evidência e baixo sinal, frequentemente produzidos por agentes de IA.

Como o Anti-slop melhora o código gerado por IA?

Ele cria um ciclo de feedback. Um agente de IA gera código, o linter é executado e fornece erros altamente descritivos sobre por que um padrão é ruim e como corrigi-lo. O agente então usa esse feedback para reparar o código, melhorando a qualidade de forma determinística.

O Anti-slop é um substituto para o ESLint?

O Anti-slop fornece regras que rodam no Oxlint, que é um linter que pode ser usado junto ou como uma alternativa muito mais rápida ao ESLint. O Oxlint é avaliado como sendo de 50 a 100 vezes mais rápido que o ESLint.

Que tipo de padrões de código o Anti-slop detecta?

Ele detecta código que pode compilar, mas é considerado um 'code smell'. Exemplos incluem asserções de tipo encadeadas (por exemplo, as unknown as User), funções com parâmetros ou tipos de retorno desconhecidos e outros padrões de baixa evidência que descartam a segurança de tipo.