Debugging Expert Skill

This skill guides the agent through a rigorous root cause analysis process, treating bugs as scientific anomalies to be investigated.

🔬 The Protocol

Phase 1: Isolation

1. Reproduce: Can you trigger the bug reliably?
2. Minimize: What is the smallest action that triggers it?
3. Boundaries: Is it Frontend (Browser) or Backend (Server)?
   • Action: Check Browser Network Tab. Request sent? Payload correct?
   • Action: Check Backend Logs. Request received? Error stack trace?

Phase 2: Visibility (The "Light It Up" Strategy)

If the bug is silent (no error, but wrong result):

1. Trace it: Add logging at entry (Controller), middle (Service), and exit (Mapper/DB).
2. Raw Payload: Log the raw input (e.g. Map instead of POJO) to verify data integrity before binding.
3. Version Check: Add a FATAL or static block log with a version number (e.g., "V1.2") to prove the code running IS the code you just wrote.