debugging

Use TodoWrite to track debugging progress through the UNDERSTAND checklist:

IF same fix proposed twice → Stop; use SequentialThinking:processthought IF error is unclear → Research via WebSearch → Parallel Search; verify with docs IF area is unfamiliar → Explore with codebasesearch; don't guess IF fix seems too easy → Confirm it addresses root cause (not symptom) IF context is cluttered → Restart at 50% with summary

IF multiple hypotheses exist → Evaluate explicitly (evidence for/against) IF similar code works → Find and diff via codebasesearch/readfile IF declaring success → Show changed lines; test fail-before/pass-after IF fix spans multiple files → Search and patch all occurrences IF library behavior assumed → Check Context7:get-library-docs

التصحيح المنهجي الذي يحدد الأسباب الجذرية بدلاً من علاج الأعراض. يستخدم التفكير المتسلسل للتحليل المعقد، والبحث على الويب للبحث، والتحقيق المنظم لتجنب التفكير الدائري والإصلاحات المزعجة. المصدر: ratacat/claude-skills.