investigate

Diagnose software failures by tracing symptoms to root causes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging of software issues by identifying root causes before implementing fixes, reducing firefights and repeated work in debugging sessions.

Core Features & Use Cases

  • Structured four-phase workflow (investigate, analyze, hypothesize, implement) to trace issues from symptoms to root cause.
  • Integrated guidance to read code, grep for references, reproduce scenarios, and document findings for sharing with teammates.
  • Works across error messages, stack traces, and shifting project states, with proactive prompts to gather context.

Quick Start

Describe the failing behavior and provide reproduction steps to start root-cause investigation.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I systematically debug software failures by tracing symptoms to root causes?

Systematic debugging traces symptoms to root causes using a structured four-phase workflow: investigate, analyze, hypothesize, and implement. It enforces disciplined evidence collection from error messages and stack traces to validate hypotheses before applying fixes.

What is the best way to reproduce an error scenario and read code with grep for root-cause analysis?

Root-cause analysis uses grep to read code and find references, combined with proactive prompts to reproduce scenarios. This structured evidence collection ensures you validate hypotheses against actual behavior before implementing code repairs.

Why does my debugging process repeatedly fail to find the actual software failure root cause?

Debugging fails to find root causes when fixes are applied before validating hypotheses. A disciplined workflow gathering context from error messages, stack traces, and recent changes prevents repeated work and reduces firefights.

Do I need to provide stack traces and reproduction steps to start a root-cause investigation?

Yes, you need to describe the failing behavior and provide reproduction steps to start root-cause investigation. The workflow gathers context from stack traces and error messages to guide disciplined evidence collection.

Can I use this structured debugging workflow across shifting project states and different error messages?

Yes, this structured debugging workflow works across error messages, stack traces, and shifting project states. It proactively prompts you to gather context and document findings for reliable repairs.

How do I document debugging findings to share with teammates after tracing a root cause?

Document debugging findings by following the implement phase, which records validated hypotheses and evidence collected from code reading and reproduction steps. This documentation shares root-cause context with teammates to drive reliable repairs.