Systematic Debugging

Fix root causes, not symptoms. Do not edit code until you have reproduced the issue or gathered enough evidence to explain why reproduction is impossible.

Process

1. Reproduce

• Capture the exact command, input, or user steps.
• Read the full error message and stack trace.
• Confirm whether the issue is deterministic or intermittent.
• Record expected behavior versus actual behavior.

If the issue cannot be reproduced, gather logs or traces and report the missing data instead of guessing.

2. Trace Root Cause