investigate

Identify true root causes of software bugs through a structured four-phase investigation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging with root cause investigation. Four phases: investigate, analyze, hypothesize, implement. Iron Law: no fixes without root cause. Use when asked to "debug this", "fix this bug", "why is this broken", "investigate this error", or "root cause analysis". Proactively suggest when the user reports errors, unexpected behavior, or is troubleshooting why something stopped working.

Core Features & Use Cases

  • Structured root-cause workflow guiding users from symptoms to hypotheses to fixes.
  • Proactive detection and escalation prompts, scope locking, and evidence collection.
  • Telemetry and contributor-mode hooks to improve tooling and collaboration.

Quick Start

Summarize symptoms, collect logs, and begin structured 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 find the root cause of a software bug instead of just patching symptoms?

Root cause analysis requires a structured investigation process that prevents premature fixes. This approach enforces a four-phase workflow—investigate, analyze, hypothesize, implement—ensuring you collect evidence and confirm the true cause before modifying code.

What is the best way to structure debugging and troubleshooting for unexpected regressions?

Structured debugging organizes troubleshooting into explicit phases: locking scope, collecting telemetry, and testing hypotheses. This methodical approach guides you from observed symptoms to a confirmed root cause, preventing speculative fixes for regressions.

How do I test hypotheses during an error investigation?

Hypothesis testing during error investigation involves using tool-based workflows to gather telemetry and evidence. You lock the scope of the anomaly, formulate a hypothesis, and validate it against collected data before proceeding to implementation.

Can I use this structured investigation workflow for performance anomalies and complex errors?

Yes, structured root-cause investigation is designed for error investigations, regressions, and performance anomalies. It provides guided prompts to collect evidence and systematically trace symptoms back to their origin across various software failure types.

When should I avoid applying fixes during root cause analysis?

You must avoid applying fixes until the root cause is explicitly identified and confirmed. This iron law of investigation prevents patching symptoms, ensuring that any implemented fix actually resolves the underlying error or unexpected behavior.

Do I need telemetry and logs to start a root cause investigation?

Summarizing symptoms and collecting logs or telemetry is the recommended quick start for root-cause investigation. This evidence collection forms the foundational step needed to lock scope and test hypotheses effectively before fixing.