TL;DR

React Doctor는 결정론적 정적 스캔을 통해 상태·effect·성능·아키텍처·보안·접근성 영역의 문제를 탐지하는 CLI 기반 도구이다. 프로젝트 루트에서 npx로 즉시 실행할 수 있으며 풀리퀘스트 단위 검사로 변경에 의해 새로 도입된 문제만 식별하고 CI에 통합해 요약 코멘트를 게시하도록 설계되었다. 추가로 감지 결과를 에이전트 스킬로 연계해 코딩 에이전트가 유사한 문제를 수정하거나 회피하도록 만들 수 있으며 익명화된 텔레메트리 수집은 `--no-telemetry`로 비활성화할 수 있다. 이 도구는 다양한 React 생태계를 지원함으로써 여러 프로젝트에 일관된 규칙을 적용하는 데 유용하지만 개별 규칙의 세부 동작과 적용 범위는 구성 파일로 조정해야 한다.

핵심 포인트

• 변경 기반(PR 스코프) 검사로 기존 코드베이스의 누적 이슈를 반복해서 경고하지 않고 오직 변경으로 도입된 문제만 보고하도록 작동한다. 이 방식은 CI에서의 노이즈를 줄이고 리뷰어가 실제로 수정해야 할 항목에만 집중하게 만든다. README는 `react-doctor ci install`로 워크플로를 설치해 이 동작을 자동화할 수 있음을 명시한다.
• 다양한 React 생태계와 호환되도록 설계되어 Next.js, Vite, TanStack, React Native, Expo 등에서 동작을 목표로 한다. 프레임워크별 별도 설정 없이 프로젝트 형태를 인식해 검사 범위를 결정하는 것으로 설계되어 있어 여러 코드베이스를 가진 조직에서 일관된 검사가 가능하다. 이 호환성은 라이브러리·플랫폼 전반에서 동일한 규칙 세트를 적용할 수 있게 한다.
• 에이전트 스킬 설치 기능을 통해 감지된 패턴을 코딩 에이전트에 연계할 수 있다는 점이 차별화 요소다. 스킬을 설치하면 에이전트가 이전에 기록된 이슈 유형을 바탕으로 향후 자동 수정을 시도하거나 코드를 생성할 때 회피하도록 동작할 수 있다. 이 통합은 반복적인 수리 작업을 자동화하고 에이전트의 출력 품질을 점진적으로 개선하는 운영 흐름을 만든다.
• 프로젝트 전체를 결정론적으로 스캔해 상태와 effect 관련 패턴, 성능 병목, 아키텍처 반패턴, 보안 취약점, 접근성 문제를 규칙 기반으로 탐지한다. 이 과정은 런타임 없이 소스코드 분석을 통해 수행되며 프레임워크 구분 없이 Next.js, Vite, TanStack, React Native, Expo 같은 환경에서 동작을 목표로 한다. 검사 결과는 CLI 출력과 CI 주석으로 전달되어 개발 흐름에 통합된다.