# Troubleshooting

Common failure modes and how to fix them. Each entry should have:

- **Symptom** — what the user sees
- **Cause** — what's actually wrong
- **Fix** — how to resolve it
- **Prevention** — how to avoid it next time
