Troubleshoot

Objective

Reproduce and isolate the issue.

Identify the most probable root cause and next actions.

A bug or failure is reported or observed.

Symptoms are unclear and need narrowing down.

User-reported symptoms, logs, or reproduction steps.

AGENTS.md, rules, relevant code/tests.

Environment details if available.

1) Confirm and restate the symptom; note missing repro info.

2) Form quick hypotheses; prioritize simplest checks.

3) Collect minimal evidence (logs/tests/inputs) to confirm/deny hypotheses.

4) Identify the likely root cause or narrow to top candidates.

5) Propose next actions (fix path or deeper check) and validation steps.

Likely root cause (or narrowed hypotheses).

Evidence collected and what’s still unknown.

Proposed fix direction and validation plan.

If repro is missing, request exact steps or data.

Avoid broad changes; focus on evidence-driven narrowing.