| name | debug-flutter-issues |
| description | Systematically diagnose Flutter failures from logs to root cause across Dart, package graph, Android, and iOS. |
Debug Flutter Issues
Use for compiler/build/runtime failures.
Workflow
- Capture exact failing command and complete logs.
- Classify failure layer:
- Dart analyzer/compiler
- pub dependency resolution
- Android Gradle/Kotlin/AGP
- iOS/macOS native dependency resolution (
Swift Package Manager, CocoaPods), Xcode, or signing
- Reproduce with minimal scope.
- Apply smallest deterministic fix.
- Validate with rerun and impacted tests.
Guardrails
- Do not propose a fix without a reproducible command or clear log evidence.
- Keep fixes minimal and limited to the failing layer unless a cross-layer root cause is proven.
- Call out unknowns explicitly instead of guessing when logs are incomplete.
- Do not assume Apple-side failures come from CocoaPods before checking SPM/Xcode package resolution state.
- Include one preventive follow-up even when the fix is minimal.
Output format
- Root cause.
- Applied fix.
- Verification steps.
- Preventive follow-up (optional).
