React Doctor — ferramenta de diagnóstico que valida por análise estática código React gerado por IA

Quem está revisando se o código React escrito por agentes de codificação com IA está realmente correto? O React Doctor é uma ferramenta que nasce exatamente dessa pergunta. Ao escanear um projeto com uma única linha, npx react-doctor@latest, os resultados do diagnóstico abrangendo gerenciamento de estado, efeitos colaterais, desempenho, segurança, acessibilidade e arquitetura em geral são exibidos no terminal junto com uma pontuação de 0 a 100. Foi desenvolvido pela Million.co e é disponibilizado sob licença MIT.

Principais características

• Oferece suporte explícito à integração com agentes de IA. Ao executar react-doctor install, ele registra automaticamente skills nos principais agentes, como Claude Code, Cursor, Codex e OpenCode, além de instalar hooks git post-checkout/post-merge. É uma estrutura em que um agente cria problemas e outro agente os corrige.
• Inclui mais de 100 regras baseadas em oxlint. As regras são implementadas diretamente em seu próprio plugin oxlint (oxlint-plugin-react-doctor), permitindo análises rápidas sem um runtime ESLint separado. Também há presets de regras específicos para frameworks como Next.js, TanStack, React Native e Expo.
• Integra regras do React Compiler. Por meio das regras da família react-hooks-js/*, ele detecta imediatamente quando ainda existe código de memoização manual em ambientes com o React Compiler ativado.
• Tem suporte nativo ao GitHub Actions. Ao adicionar a action oficial publicada no Marketplace, ele deixa os resultados do diagnóstico em cada PR com anotações inline e comentários fixos. Com o modo --diff, escaneia apenas os arquivos alterados para reduzir o tempo de CI.
• Usa um pipeline de streaming baseado em Effect v4. Internamente, o mecanismo de escaneamento é composto por injeção de dependência, erros tagueados e fluxo de controle baseado em geradores da biblioteca Effect, executando linting e análise de código morto em paralelo.
• Também permite acesso programático. Com a função diagnose() do pacote @react-doctor/api, é possível receber e processar diretamente no código Node.js resultados de diagnóstico tipados.
• Oferece compartilhamento de pontuação. Os resultados do escaneamento podem ser publicados em react.doctor/share para compartilhamento com a equipe ou externamente.

Diferenciais

Ao contrário dos plugins React tradicionais baseados em ESLint, nos quais o desenvolvedor precisa escolher e configurar regra por regra, o React Doctor se posiciona como uma “ferramenta de auditoria” que executa diagnósticos de categorias completas imediatamente após a instalação. Em especial, chama atenção o fato de colocar em destaque o cenário de uso de validar a qualidade de código escrito por IA.

A migração para Effect v4 no v0.2.4, a análise paralela e a detecção de agentes no v0.2.7, e o ritmo curto de lançamentos até o atual v0.2.8 mostram uma cadência contínua de releases. Como ainda não chegou à versão major, há espaço para mudanças na API, mas a velocidade de desenvolvimento e a tendência de expansão de cobertura seguem consistentes. Em um ambiente em que a geração de código por IA está se tornando rotina, é uma ferramenta que merece atenção por mirar o papel de último posto de verificação da qualidade do codebase.

[runedia]

Como também funciona com bunx, testei em um projeto em desenvolvimento e ele detecta uma quantidade enorme de erros e avisos.

A maioria não tem tanta importância, mas como encontrou alguns erros que eu tinha deixado passar, acho que é uma ferramenta que vale a pena experimentar pelo menos uma vez.