investigate

Diagnose software bug root causes through structured symptom collection and hypothesis testing.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/Jesse-L-M/scz-target-engine --skill investigate-jesse-l-m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/Jesse-L-M/scz-target-engine/tree/main/.claude/skills/gstack/investigate
Command: npx skills add https://github.com/Jesse-L-M/scz-target-engine --skill investigate-jesse-l-m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging with root cause investigation. The framework guides you through four phases: investigate, analyze, hypothesize, implement, ensuring you never fix symptoms without discovering the underlying cause.

Core Features & Use Cases

  • Structured, repeatable root-cause analysis from symptoms to fix.
  • Integrates with common developer workflows using Bash, Read, Write, Edit, Grep, Glob, and WebSearch.
  • Use cases include diagnosing intermittent failures, stack traces, or unexpected behavior across different modules and environments.

Quick Start

Start by collecting symptoms, reproducing the issue, and following the four phases to uncover the root cause before attempting a fix.

Frequently Asked Questions about investigate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to find the root cause of intermittent software failures?

Systematic root-cause debugging requires collecting symptoms, reproducing the issue, and confirming hypotheses through instrumentation and logs before implementing fixes, ensuring you address the underlying cause rather than just patching symptoms.

How do I debug a stack trace across different environments using a structured workflow?

Debug a stack trace across environments by following a four-phase workflow: investigate, analyze, hypothesize, and implement, using logs and controlled experiments to gather evidence and confirm the root cause before applying a fix.

Can I use bash and grep to diagnose unexpected behavior in diverse codebases?

Yes, you can use bash and grep to diagnose unexpected behavior in diverse codebases. The investigation workflow integrates these tools to search code, analyze logs, and gather evidence across modules to pinpoint the root cause.

Why should I reproduce an issue and gather evidence before implementing a code fix?

Reproducing an issue and gathering evidence before implementing a code fix prevents you from treating symptoms. This structured root-cause analysis requires instrumentation and controlled experiments to confirm hypotheses, ensuring the actual bug is resolved.

When do I need a systematic root-cause investigation workflow instead of directly patching code?

You need a systematic root-cause investigation workflow when facing unexpected behavior or intermittent failures that require instrumentation and controlled experiments to confirm hypotheses, preventing superficial symptom fixes across diverse codebases.