Debugging
- Reproduce the failure with the exact command, input, environment, and observed output.
- Separate symptom, trigger, and root cause. Inspect logs, stack traces, state transitions, recent diffs, and boundary conditions.
- Add temporary targeted instrumentation when evidence is missing; avoid broad logging noise.
- Fix the root cause at the narrowest ownership boundary.
- Add a regression test that fails before the fix and passes after it.
- Remove temporary diagnostics and rerun the original reproduction plus nearby tests.