investigate

Guide structured root-cause debugging through four phases with evidence gathering.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging with root-cause investigation to prevent solving symptoms and accelerate reliable fixes.

Core Features & Use Cases

  • Structured four-phase workflow: investigate, analyze, hypothesize, implement to descend from symptoms to root cause.
  • Safety rails and guidance: asks targeted questions when information is missing, locks scope to prevent scope creep, and records learnings for contributors.

Quick Start

Initiate the investigate workflow to begin structured root-cause debugging and follow the four phases.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I perform systematic root-cause debugging instead of just fixing symptoms?

Systematic root-cause debugging uses a structured four-phase workflow—investigate, analyze, hypothesize, and implement—to descend from initial symptoms to the underlying cause. This guided process enforces scope locks and decision points to prevent superficial fixes.

What is the best way to triage logs and narrow down a bug's root cause?

The best way to triage logs for root-cause analysis is to follow a structured investigation workflow that uses grep to search logs and gather evidence. It guides you through targeted questions to capture symptoms before forming hypotheses.

How do I prevent scope creep when investigating a complex technical bug?

You can prevent scope creep during an investigation by using a workflow that enforces scope locks at each phase. These safety rails restrict your debugging session to the current hypothesis and prevent drifting into unrelated system areas.

Can I use guided prompts to capture missing information during a debugging session?

Yes, guided prompts are used to ask targeted questions when information is missing during a debugging session. This ensures all necessary evidence is captured before moving to the hypothesis and implementation phases.

Does structured debugging work for fixing bugs across different technical systems?

Structured debugging works across different technical systems by using general evidence gathering and grep flows. The workflow applies systematic phases from symptom capture through validation regardless of the specific technical stack.