React Doctor: scanner que audita React gerado por IA

React Doctor é um scanner de qualidade que aponta o que agentes de IA fazem errado quando escrevem código React. O repositório da Million.co passou de 9.054 stars no GitHub em maio de 2026, com 286 forks e 12 contributors ativos. A proposta é simples: rodar um comando na raiz do projeto e receber um score de 0 a 100 com diagnósticos acionáveis sobre estado, efeitos, performance e arquitetura.

A ferramenta funciona com Next.js, Vite e React Native, distribuída via npm sob licença MIT. Está em alta porque resolve uma dor concreta de quem usa vibe coding para gerar interfaces React: o agente entrega código que compila mas tem useEffect mal escrito, prop drilling (passagem excessiva de props por vários níveis) absurdo e re-renders desnecessários. Sem auditoria, esse débito técnico fica invisível até quebrar em produção. O React Doctor expõe esses problemas antes do merge.

O que faz

O React Doctor escaneia o codebase inteiro e classifica cada arquivo em quatro categorias: state & effects (gerenciamento de estado e efeitos), performance, arquitetura e padrões React. O output final é um score numérico (75+ Excelente, 50-74 Precisa de trabalho, abaixo de 50 Crítico).

Cada problema vem com localização exata (arquivo:linha), explicação do porquê é ruim e sugestão de correção. Não é um linter (verificador de estilo de código) genérico — o foco é em padrões que agentes de IA tipicamente erram, como useEffect com dependências quebradas, componentes que re-renderizam sem memoização e estado duplicado entre pai e filho.

Funciona com qualquer projeto React moderno. A instalação é via npx, sem precisar adicionar dependência permanente ao package.json. Roda local, sem mandar código para servidor externo — importante para quem trabalha com base proprietária.

O caso de uso central é direto: você usou Cursor, Claude Code ou Copilot pra gerar uma feature inteira em React. Antes de abrir o PR (pull request), roda o React Doctor e descobre o que o agente fez de errado.

Por que está em alta

O repositório saltou de cerca de 1.200 para 9.054 stars entre janeiro e maio de 2026 — crescimento expressivo em quatro meses. O motivo é simples: a adoção de agentes de IA pra gerar código React explodiu no mesmo período.

Cada empresa que adotou Cursor, Lovable, Bolt ou v0 percebeu rapidamente o mesmo problema. O código gerado compila e funciona no caminho feliz, mas acumula débito técnico invisível: hooks mal escritos, anti-padrões de performance, arquitetura confusa.

Ferramentas tradicionais (ESLint, TypeScript) pegam erros sintáticos. Não pegam decisões ruins de design React. O React Doctor preencheu esse gap específico no momento certo. O último commit foi há menos de 24 horas (referência: maio 2026), com a release 2 publicada em 17/04/2026.

Métricas do projeto

Métrica	Valor
Stars	9.054
Licença	MIT
Último update	< 1 dia atrás
Linguagem	TypeScript
Contributors	12

Para quem serve / Para quem NÃO serve

Serve para: times que usam agentes de IA pra escrever React em escala. Freelancers e agências que entregam projetos rápido com Cursor ou Lovable. Tech leads que querem auditar PRs sem ler 800 linhas de diff manualmente.

Empreendedores fazendo vibe coding e que querem garantir que o MVP não vai virar pesadelo de manutenção em seis meses. Funciona bem em projetos Next.js, Vite e React Native. Roda local, então quem tem código sensível pode usar sem medo de vazamento.

NÃO serve para: projetos que não usam React. Códigos legados em Class Components recebem análise limitada — o foco é em hooks e padrões modernos. Quem quer reescrever automaticamente também vai se frustrar: o Doctor aponta problemas, não corrige (você ou o agente precisam aplicar as sugestões).

É limitado também para microfrontends complexos com builds customizados — pode gerar falsos positivos em padrões de arquitetura não convencionais. A ferramenta ainda concentra 87% dos commits em um único dev, e a maturidade está em 11/25 no scorecard de saúde.

Alternativas

SonarQube — análise estática que cobre múltiplas linguagens. Plano gratuito self-hosted, cloud a partir de US$ 32/mês. Mais genérico, menos foco em padrões React específicos de agentes. sonarqube.org

Codacy — auditoria automatizada de código com plano gratuito para projetos open-source e a partir de US$ 15/dev/mês para times. Bom para CI/CD, mas não diferencia código humano de código de IA. codacy.com

ESLint + plugin-react-hooks — gratuito, open-source. Pega erros sintáticos e dependências de hooks quebradas. Não dá score consolidado nem cobre arquitetura.

Sourcery — sugere refatorações automáticas com IA, a partir de US$ 10/mês. Foco maior em Python; suporte React ainda em beta.

Nenhuma das alternativas combina o foco específico em código React gerado por IA com output de score numérico consolidado.

Veredicto

Para quem usa agentes de IA pra escrever React, é instalação obrigatória. Custo de rodar é zero (npx, MIT), benefício é capturar problemas antes do merge. A maturidade ainda é baixa (12 contributors, dependência forte em um único dev), então não dá pra confiar como única fonte de verdade. Use combinado com ESLint, code review e testes. Para que seu produto chegue ao ponto de conversão com escala, código React saudável é prerequisito.

Fonte: react-doctor no GitHub