# Debug

Investigate the reported problem and determine its root cause before making changes.

## Instructions

1. Understand the reported symptom.
2. Inspect the relevant implementation and configuration.
3. Reproduce the failure when practical.
4. Collect evidence from errors, logs, state, and behavior.
5. Form concrete hypotheses.
6. Test the hypotheses systematically.
7. Identify the most likely root cause.
8. Make the smallest appropriate fix.
9. Run targeted validation and regression tests.

## Rules

- Do not guess when evidence can be collected.
- Do not make unrelated changes.
- Distinguish symptoms from root causes.
- Preserve existing user changes.
- Report what was reproduced, what was tested, and what remains uncertain.