quality-debug

Core workflow: Gather Symptoms -> Generate Hypotheses -> Parallel Investigation -> Parallel Fix Attempts -> Unify Results

Iron Law

NO FIX PROPOSALS WITHOUT ROOT CAUSE EVIDENCE. Before proposing any fix, you MUST have reproduced/confirmed the symptom, gathered evidence, and identified the root cause with file:line references.

Red Flags — These Thoughts Mean STOP

• "Quick fix for now, investigate later" / "I don't fully understand but this might work"
• "The fix is obvious, I don't need to reproduce it" / "Multiple changes at once will be faster"
• "I already know what the problem is" (without evidence) All mean: return to evidence gathering.

Escalation Rule

After wave 1, if 0 hypotheses confirmed (all refuted/inconclusive/failed) AND total hypotheses >= 3: STOP. Skip wave 2. Summarize failures, question architecture assumptions, present to user via request_user_input for guidance before proceeding.