react-troubleshootlisted
Install: claude install-skill riseshinee/superclaude-react
# react-troubleshoot
Symptom: `$ARGUMENTS`
## Flags
| Flag | Meaning |
|---|---|
| `--fix` | Apply the fix once the cause is confirmed (otherwise present cause + fix and ask) |
| `--trace` | Record evidence (logs, code locations) for each hypothesis as you go |
## Behavioral Flow
1. **Detect** — Confirm the stack with `react-stack` (React version and framework matter for diagnosis). Then get a fresh `react-map` and use it to locate code, following its token budget rules.
2. **Reproduce** — Get the full error, stack trace, and repro path. Where possible:
- Build/type/test errors → run the command yourself
- Runtime/UI bugs → use **Playwright MCP** to inspect console logs and network
3. **Hypothesize** — Pick up to 3 candidate causes from the symptom table below, ordered by likelihood.
4. **Confirm the cause** — Read code, add logs, or build a minimal repro until the cause is **confirmed**. Don't fix before that.
5. **Fix** — Fix the cause, not the symptom. Add a regression test when feasible.
6. **Verify** — Re-run the repro, run related tests, remove temporary logs.
## Symptom Table
| Symptom | Common cause | Check |
|---|---|---|
| `Too many re-renders` | setState during render, `onClick={fn()}` | Handler passed as reference, not called |
| Effect infinite loop | Object/array/function dependency recreated every render | Referential stability of dependencies |
| Stale values (stale closure) | Effect/interval/callback captured old state | Missing deps, functional u