Verified project record

millionco/react-doctor

react-doctor deterministically scans React codebases to find issues across state, performance, architecture, security, and accessibility. It installs a skill for AI coding agents so they can learn from detected issues and fix them in future code.

Project overview

By giving coding agents a learned skill derived from deterministic codebase scans, react-doctor targets the category of React-specific defects that AI-generated code commonly introduces, closing the loop between detection and prevention.

Project type: AI Coding
Use cases: Coding & Development
Deployment: Refer to project documentation
License: License pending

Best for

Developers and teams who use AI coding agents on React codebases and want deterministic detection of state, performance, architecture, security, and accessibility issues.
Teams that want each pull request reviewed for only the issues a change introduced.

Key capabilities

Scans the codebase deterministically and reports issues across state and effects, performance, architecture, security, and accessibility.
Installs a skill so the coding agent can learn from the issues found during the scan and fix them in the future.
Reviews every pull request and reports only the issues that a given change introduced.
Lets you configure which rules to run and how to run them through a doctor.config.ts file.

Limitations and risks

The GitLab CI integration is limited to a gate-only scaffold, which may offer less functionality compared with other CI platforms.
By default the CLI reports crashes, basic run traces, and anonymous usage counters to Sentry; teams with strict data-boundary requirements should account for this before adoption.

Getting started

Run the following at your project root to get an audit: npx react-doctor@latest. No installation is required because the package is executable via npx.

Evidence and sources

GitHub project description: Your agent writes bad React. This catches it
README: React Doctor deterministically scans your codebase and finds issues across state & effects, performance, architecture, security, and accessibility.
README: Once you have an audit, you can install the skill for your coding agent to learn from the issues and fix them in the future. ```bash npx react-doctor@latest install ``` Works with…
README: React Doctor reviews every pull request and reports only the issues your change introduced, not your existing backlog. Set it up with one command: ```bash npx react-doctor@latest…
README: You can configure which rules to run and how to run them in `doctor.config.ts`.

Reviewed at: 2026-07-21T22:19:15Z