React Doctor — herramienta de diagnóstico que valida con análisis estático el código React generado por IA

¿Quién está revisando si el código React escrito por agentes de codificación con IA realmente es correcto? React Doctor es una herramienta que parte justamente de esa pregunta. Con una sola línea, npx react-doctor@latest, escanea el proyecto y muestra en la terminal los resultados del diagnóstico sobre gestión de estado, efectos secundarios, rendimiento, seguridad, accesibilidad y arquitectura en general, junto con una puntuación de 0 a 100. Fue desarrollada por Million.co y está publicada bajo licencia MIT.

Características clave

• Soporta explícitamente la integración con agentes de IA. Al ejecutar react-doctor install, registra automáticamente skills en agentes principales como Claude Code, Cursor, Codex y OpenCode, y también instala hooks de git post-checkout/post-merge. Es una estructura en la que un agente causa el problema y otro lo corrige.
• Incluye más de 100 reglas basadas en oxlint. Implementa las reglas directamente en su propio plugin de oxlint (oxlint-plugin-react-doctor), lo que permite un análisis rápido sin un runtime separado de ESLint. También hay presets de reglas por framework para Next.js, TanStack, React Native, Expo y otros.
• Integra reglas de React Compiler. A través de reglas de la familia react-hooks-js/*, detecta de inmediato cuando todavía queda código de memoización manual en entornos donde React Compiler está habilitado.
• Tiene soporte nativo para GitHub Actions. Si agregas la acción oficial publicada en Marketplace, deja resultados de diagnóstico en cada PR mediante anotaciones inline y comentarios fijos. Si usas el modo --diff, escanea solo los archivos modificados para reducir el tiempo de CI.
• Usa un pipeline de streaming basado en Effect v4. Internamente, el motor de escaneo está construido con inyección de dependencias, tagged errors y control de flujo basado en generadores de la librería Effect, y ejecuta en paralelo el linting y el análisis de código muerto.
• También permite acceso programático. Con la función diagnose() del paquete @react-doctor/api, se pueden recibir y procesar directamente en código Node.js resultados de diagnóstico tipados.
• Ofrece función para compartir puntuaciones. Los resultados del escaneo pueden publicarse en react.doctor/share para compartirlos con el equipo o con terceros.

Diferenciadores

A diferencia de los plugins de React tradicionales basados en ESLint, donde el desarrollador debe elegir y configurar las reglas una por una, React Doctor está posicionado como una “herramienta de auditoría” que ejecuta diagnósticos de categorías completas apenas se instala. En particular, llama la atención que ponga al frente como caso de uso la validación de la calidad del código escrito por IA.

Se mantiene un ciclo corto de lanzamientos: la migración a Effect v4 en la v0.2.4, el análisis en paralelo y la detección de agentes en la v0.2.7, y ahora la versión actual v0.2.8. Como todavía no ha llegado a una versión major, existe la posibilidad de que la API cambie, pero la velocidad de desarrollo y la expansión de cobertura se han mantenido constantes. Vale la pena seguirla como una herramienta que apunta a ser la última barrera de control de calidad del codebase en un entorno donde la generación de código con IA se ha vuelto cotidiana.

[runedia]

Como también funciona con bunx, lo probé en un proyecto que estoy desarrollando y detecta muchísimos errores y advertencias.

La mayoría no son cosas muy significativas, pero como encontró algunos errores que se me habían pasado por alto, me parece una herramienta que vale la pena probar al menos una vez.