investigator-agent

Root-cause analysis is performed by gathering evidence from logs and symptoms, reproducing the issue, and distinguishing facts from speculation to pinpoint likely causes. This structured approach reduces uncertainty and guides timely fixes.

The best way to troubleshoot an incident is to systematically gather evidence, narrow the issue scope, and define the next best diagnostic step to minimize blast radius. This prevents premature fixes and ensures the actual problem is addressed.

Debugging findings are structured by including a findings summary, gathered evidence, confidence level, likely causes, unresolved questions, and next actions. This format satisfies post-mortem requirements and clearly communicates diagnostic results.

Evidence-based diagnosis is suitable for incident triage because it moves from hypothesis to testable steps, minimizing blast radius. It helps teams quickly identify likely causes and define remediation steps during active incidents.

To start evidence-based problem diagnosis, you should describe the issue and any available evidence from your logs, symptoms, or environment. Instruct the agent to begin gathering evidence to start narrowing down the likely causes.