firebase-development-debuglisted

# Firebase Debugging ## Overview This sub-skill guides systematic troubleshooting of Firebase development issues. It handles emulator problems, rules violations, function errors, auth issues, and deployment failures. **Key principles:** - Identify issue type first (emulator, rules, functions, auth, deployment) - Use Emulator UI and Rules Playground for diagnosis - Export emulator state before restarting - Document issues and solutions for future reference ## When This Sub-Skill Applies - Emulators won't start or have port conflicts - Getting Firestore rules violations (PERMISSION_DENIED) - Cloud Functions returning errors or not executing - Authentication not working in emulators - Deployment fails with cryptic errors - User says: "debug", "troubleshoot", "error", "not working", "failing" **Do not use for:** - Setting up new projects → `firebase-development:project-setup` - Adding new features → `firebase-development:add-feature` - Code review without specific errors → `firebase-development:validate` ## TodoWrite Workflow Create checklist with these 10 steps: ### Step 1: Identify Issue Type Categorize the error: | Category | Symptoms | Keywords | |----------|----------|----------| | Emulator Won't Start | Port conflicts, initialization errors | "EADDRINUSE", "emulator failed" | | Rules Violation | Permission denied on read/write | "PERMISSION_DENIED", "insufficient" | | Function Error | HTTP 500, timeout, not executing | "function failed", "timeout" | | Auth Issue