React Doctor가 완전히 AI 코드 리뷰의 결정판이 되었습니다.

2026년 7월 기준 모든 기능이 엄청납니다 ↓
・npx react-doctor@latest (코드베이스 전체를 점검하여 0~100점으로 점수화)
・install (Claude Code, Cursor, Codex 등 주요 에이전트에 점검 기술 추가)
・ci install (모든 Pull Request를 자동으로 점검 + 요약 댓글 게시)
・/doctor (점검 → 필터링 → 분류 → 수정 → 재점검의 루프를 통해 매일 구현 실행)
・/improve-react (소스 코드를 다시 작성하지 않고 개선 계획 수립)

GitHub Star 13,700개 이상을 기록 중인 완전판의 상세 분석 ↓

도입부의 영상은 제작자 @aidenybai 의 공식 데모 영상입니다. 예시 코드로 메커니즘을 묘사한 것이며, 실제 프로젝트의 점검 결과는 아닙니다.

먼저, React Doctor란 무엇인가.

한마디로 설명하면 ↓
"AI 에이전트가 작성한 React 코드의 결함을 정해진 규칙에 따라 기계적으로 점검하는 도구"

【규모감】

【기능 ①】npx react-doctor@latest: 코드베이스를 그 자리에서 통째로 점검.

도입의 간편함에 특화.

【기능】
・명령어 한 번으로 코드를 실행하지 않고 전체 스캔
・0~100점으로 점수화. 75점 이상은 "Great", 50점 미만은 "Critical"
・--verbose 옵션으로 해당 파일명과 행 번호까지 표시
・--scope

【기능 ②】install: 주요 AI 에이전트에 점검 기술을 추가.

Claude Code, Cursor, Codex 등 평소 사용하는 에이전트에 특화.

【기능】
・명령어 한 번으로 에이전트용 기술 도입
・발견된 문제를 에이전트가 학습하여 이후 구현 시 수정 가능하도록 함

【기능 ③】ci install: Pull Request (코드 변경 제출)마다 자동 체크를 수행하도록 통합.

팀 단위의 코드 리뷰 운영에 특화.

【기능】
・GitHub Actions 워크플로우를 자동으로 추가
・Pull Request가 올 때마다 자동으로 스캔
・점검 결과 요약 댓글을 Pull Request에 자동으로 게시

【기능 ④】/doctor: 점검부터 수정까지 하나의 루프로 실행.

매일의 구현 작업에 특화.

【기능】
・점검 → 필터링 → 분류 → 수정 → 재점검의 5단계 루프
・워킹 트리 (Working Tree, 작업 중인 코드)를 직접 수정
・커밋이나 Pull Request 생성은 하지 않는, 그 자리에서의 수정 역할
・Claude

【최대의 차별점】/improve-react.

코드를 직접 수정하지 않는, 계획 수립 전문 에이전트.

【메커니즘】
React Doctor로 사전 점검 → 계획 수립을 위한 5개 카테고리를 여러 AI가 병렬로 점검 → 우선순위 지정 → 개선 계획을 파일로 작성

【특징】
・소스 코드는 일절 변경하지 않음 (읽기 전용)