Root Cause Analysis Protocol

When a feature is broken, don't just add logging - find and fix the ACTUAL problem.

Methodology

1. Understand the Symptom:

   • What does the user see/experience?
   • What SHOULD happen?
   • What ACTUALLY happens?

2. Trace the Data Flow:

   • Follow code execution from UI → ViewModel → Service → Backend
   • Check each layer for failures
   • Use breakpoint logic (mental trace)

3. Check Dependencies:

   • Is the service initialized? (DIContainer.shared.service)
   • Are databases/indexes ready?