Systematic Debugging

• Start from the failure point.
• Trace backwards through variables and function calls.
• Verify assumptions at each step (e.g., using bash for targeted logs).

4. Create Regression Test

Before fixing, write a test that fails due to this specific root cause. Verify it fails (RED).

5. Minimal Fix

Implement the smallest possible fix that addresses the root cause. Verify the regression test passes (GREEN).

6. Verify All Tests

Run the full test suite to ensure no regressions.

Forbidden Actions

• Guessing "maybe this will work".
• Changing code before understanding why it fails.
• Blindly applying "best practices" to fix a bug.
• Trusting partial verification.

Key Mindset

• You don't know what's wrong yet.
• Every assumption is a potential lie.
• Proof is better than confidence.