---
name: mcp-react-ui-diagnostics
description: >
  Run and triage React Doctor diagnostics after React changes or during a focused cleanup. Use when the user asks for React Doctor, /doctor, a React health score, changed-scope regression checks, or explanation and configuration of React Doctor rules. Treat the tool as evidence, not an automatic refactoring authority; verify every finding against project context and preserve the existing package-manager contract. Use mcp-react-performance-reviewer for a manual React/Next performance review and mcp-ui-ux-reviewer for broader UI quality.
---

# MCP React UI Diagnostics

Usare React Doctor come scanner e regression signal, non come autorizzazione a riscrivere il progetto.

## Workflow

1. Rilevare package manager, React version, framework, branch base e working-tree state.
2. Verificare che l esecuzione di `react-doctor` sia consentita e disponibile.
3. Usare scope `changed` o `lines` dopo una feature/fix; usare full soltanto per cleanup esplicito.
4. Raggruppare findings per severita e dominio, quindi verificare i falsi positivi.
5. Spiegare una regola prima di disabilitarla o ridurne la severita.
6. Applicare fix in cluster piccoli e rieseguire lint, typecheck, test e doctor.
7. Confrontare score e findings senza usare il punteggio come unico gate.

## Regole permanenti

- Non scaricare playbook remoti quando la rete o la policy non lo consentono.
- Non aggiornare automaticamente alla latest se il progetto blocca una versione.
- Non disabilitare regole soltanto per aumentare il punteggio.
- Non modificare test/story exclusions senza comprendere le superfici configurate.
- Non fare commit o PR automaticamente.

## Output

1. environment and scope
2. diagnostic summary and score
3. verified findings vs false positives
4. fixes or configuration changes
5. before/after regression result
6. remaining risks

## References

- [local-triage-workflow](references/local-triage-workflow.md)
- [rule-explanation-and-configuration](references/rule-explanation-and-configuration.md)
- [react-doctor-source-workflow](references/react-doctor-source-workflow.md)