investigate

Identify and resolve software bug root causes through a phased investigative workflow.

43|7|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/lucas-flatwhite/gstack-ko --skill investigate-lucas-flatwhite
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/lucas-flatwhite/gstack-ko/tree/main/investigate
Command: npx skills add https://github.com/lucas-flatwhite/gstack-ko --skill investigate-lucas-flatwhite

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic root-cause debugging workflow helps teams identify the underlying cause of bugs before applying fixes, reducing wasted effort and repeated regressions.

Core Features & Use Cases

  • Phase-driven investigation: collect symptoms, inspect code paths, and check recent changes to form evidence-based hypotheses.
  • Hypothesis testing and controlled experiments: validate root-cause hypotheses with minimal, safe changes and verifications.
  • Telemetry and documentation: record decisions, outcomes, and rationale to enable future debugging and audits, even across teams.

Quick Start

Describe the bug symptoms and let me guide you through the root-cause investigation workflow.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I find the root cause of a software bug instead of just patching symptoms?

Root-cause debugging uses a phased investigative workflow to identify underlying causes before applying fixes. You collect symptoms, inspect code paths, check recent changes, and form evidence-based hypotheses to prevent wasted effort and repeated regressions.

What is the best way to debug intermittent errors across a codebase?

Debugging intermittent errors requires a structured investigation workflow with deterministic steps. You apply phased analysis—investigate, analyze, hypothesize, implement—to systematically trace symptoms through code paths and verify outcomes using telemetry.

How do I test a root-cause hypothesis safely during debugging?

Hypothesis testing during debugging validates root-cause theories with minimal, safe changes and controlled experiments. You verify each hypothesis systematically before implementing fixes to ensure the change addresses the actual cause without introducing regressions.

Can I use a phase-driven investigation workflow for failing reproductions?

Phase-driven investigation applies to debugging tasks ranging from failing reproductions to intermittent errors. The workflow enforces structured analysis across investigate, analyze, hypothesize, and implement phases, with escalation when needed for complex cases.

Why do I need telemetry and documentation for root-cause debugging?

Telemetry and documentation record decisions, outcomes, and rationale during root-cause debugging to verify fixes and enable future audits. This structured recording prevents repeated regressions and supports knowledge transfer across teams.