Setup React Doctor

What This Sets Up

• react-doctor package for codebase health scoring (0-100)
• doctor package.json script
• react-doctor.config.json disabling biome-overlapping rules
• Stop hook running doctor on changed files, failing on score drop

Steps

1. Install

bun add -D react-doctor --yarn

2. Add package.json script

{
  "scripts": {
    "doctor": "react-doctor ."
  }
}

3. Create react-doctor.config.json

{
  "ignore": {
    "rules": [
      "react-hooks/exhaustive-deps",
      "react/no-nested-component"
    ]
  }
}

4. Create Stop hook script

Copy scripts/react-doctor-stop.sh into .claude/hooks/. Make executable.

5. Configure hook in .claude/settings.json

Add to hooks config: Stop: .claude/hooks/react-doctor-stop.sh

6. Codex compatibility (optional)

If the project also uses OpenAI Codex, run codex-compat to generate .codex/hooks.json from the Claude Code config.

7. Verify & Commit

• bun run doctor works
• react-doctor.config.json exists
• Stop hook is executable

Commit: Add react-doctor health scoring with Stop hook