React Doctor — Diagnose-Tool zur Validierung von von KI erzeugtem React-Code per statischer Analyse

Wer prüft eigentlich, ob React-Code, den ein KI-Coding-Agent geschrieben hat, wirklich korrekt ist? Genau von dieser Frage aus startet React Doctor. Mit einer einzigen Zeile, npx react-doctor@latest, wird ein Projekt gescannt, und die Diagnoseergebnisse zu Zustandsverwaltung, Seiteneffekten, Performance, Sicherheit, Barrierefreiheit und der gesamten Architektur werden zusammen mit einer Bewertung von 0 bis 100 im Terminal ausgegeben. Entwickelt wurde das Tool von Million.co und es ist unter der MIT-Lizenz veröffentlicht.

Wesentliche Merkmale

• Explizite Unterstützung für die Anbindung von AI-Agenten. Wenn man react-doctor install ausführt, werden Skills automatisch in gängigen Agenten wie Claude Code, Cursor, Codex und OpenCode registriert, außerdem werden git-Hooks für post-checkout und post-merge installiert. Die Idee ist eine Struktur, in der ein Agent Probleme verursacht und ein anderer sie direkt behebt.
• Mehr als 100 Regeln auf Basis von oxlint sind integriert. Die Regeln werden direkt im eigenen oxlint-Plugin (oxlint-plugin-react-doctor) implementiert, sodass schnelle Analysen auch ohne separates ESLint-Runtime möglich sind. Für Next.js, TanStack, React Native, Expo und weitere Frameworks stehen jeweils eigene Regel-Presets bereit.
• Integration von React-Compiler-Regeln. Über Regeln der Reihe react-hooks-js/* werden verbliebene manuelle Memoisierungs-Codes in Umgebungen mit aktiviertem React Compiler sofort erkannt.
• Native Unterstützung für GitHub Actions. Fügt man die offizielle Action aus dem Marketplace hinzu, hinterlässt sie bei jedem PR Diagnoseergebnisse als Inline-Anmerkungen und Sticky-Kommentare. Mit dem Modus --diff werden nur geänderte Dateien gescannt, was die CI-Zeit reduziert.
• Streaming-Pipeline auf Basis von Effect v4. Intern besteht die Scan-Engine aus Dependency Injection, Tagged Errors und generatorbasiertem Kontrollfluss aus der Effect-Bibliothek; Linting und Dead-Code-Analyse laufen parallel.
• Auch programmatischer Zugriff ist möglich. Über die Funktion diagnose() des Pakets @react-doctor/api lassen sich typisierte Diagnoseergebnisse direkt in Node.js-Code empfangen und verarbeiten.
• Funktion zum Teilen von Bewertungen. Scan-Ergebnisse können auf react.doctor/share veröffentlicht und mit dem Team oder extern geteilt werden.

Unterscheidungsmerkmale

Während bestehende React-Plugins auf ESLint-Basis verlangen, dass Entwickler Regeln einzeln auswählen und konfigurieren, positioniert sich React Doctor als „Audit-Tool“, das unmittelbar nach der Installation eine Diagnose über die gesamten Kategorien hinweg ausführt. Besonders auffällig ist, dass das Nutzungsszenario der Qualitätsprüfung von KI-generiertem Code klar in den Vordergrund gestellt wird.

Auf die Effect-v4-Migration in v0.2.4 folgten die Parallelanalyse und Agentenerkennung in v0.2.7, und inzwischen setzt sich der kurze Release-Zyklus bis zur aktuellen Version v0.2.8 fort. Da noch keine Major-Version erreicht ist, besteht zwar Spielraum für API-Änderungen, doch das Entwicklungstempo und der Trend zur Ausweitung der Abdeckung bleiben konstant. In einer Umgebung, in der KI-Codegenerierung zum Alltag geworden ist, ist dies ein bemerkenswertes Tool, das darauf abzielt, als letzte Kontrollinstanz für die Qualität einer Codebasis zu dienen.

[runedia]

Es läuft auch mit bunx, also habe ich es in einem Projekt ausprobiert, an dem ich gerade arbeite, und es findet unglaublich viele Fehler und Warnungen.

Die meisten sind nicht besonders relevant, aber weil es auch ein paar Fehler entdeckt hat, die mir entgangen waren, scheint es mir ein Tool zu sein, das man zumindest einmal ausprobieren sollte.