debugging-protocol

Value: Feedback -- systematic investigation produces understanding. Understanding produces correct fixes. Correct fixes prevent recurrence. Skipping investigation produces symptom fixes that hide bugs.

Teaches a disciplined 4-phase debugging process that enforces root cause analysis before any fix attempt. Prevents the most common debugging failure mode: jumping to a fix without understanding why the problem exists.

Never change code to fix a bug until you have completed root cause investigation. When you see an error and immediately know the fix, that is exactly when you are most likely to be wrong. Investigate first.

系統的な 4 段階のデバッグ: 障害を理解し、仮説を立て、一度に 1 つの変更をテストし、自信を持って修正します。テストが予期せず失敗した場合、エラーが発生した場合、動作が間違っている場合、または以前は機能していたものが壊れた場合にアクティブ化します。トリガー条件: 「デバッグ」、「なぜこれが失敗するのか」、「テストの失敗」、「予期しないエラー」、「バグ」、「壊れた」。 ソース: jwilger/agent-skills。