do-debug

Diagnose root cause and fix through four phases: observe → pattern → hypothesis → harden.

Phases

1. Observe and Capture

• Reproduce deterministically. Capture exact error, steps, environment, and variance.
• Record what is known vs unknown before editing any code.

2. Pattern Analysis

• Compare failing path with a known-good reference (code, commit, or contract).
• Identify mismatches in assumptions, data shape, config, ordering, boundaries.
• Narrow to the smallest collision zone that explains the failure.

3. Hypothesis Testing