investigate

Guide structured debugging to identify root causes of software failures.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The root-cause investigation systematizes debugging to identify the true source of failures before applying fixes, reducing wasted effort and regression risk.

Core Features & Use Cases

  • Structured phases: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis Testing, Phase 4 Implementation, Phase 5 Verification & Report.
  • Evidence-based decisions: Collect symptoms, review recent commits, reproduce the bug, and lock scope to minimize changes.
  • Real-world use: When an error occurs in production, follow the workflow to trace the fault to its core cause instead of patching symptoms.

Quick Start

Initiate Phase 1 by collecting symptoms and reproducing the issue to start root-cause investigation.

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 a software failure instead of just patching symptoms?

Root-cause debugging isolates the true source of software failures by collecting symptoms, reading recent commits, and reproducing the issue. This structured approach ensures you fix the actual fault rather than wasting effort patching surface symptoms.

How do I debug race conditions and state corruption systematically?

Debug race conditions and state corruption through pattern analysis that collects evidence and checks recent changes. The workflow applies structured phases to isolate faults in common build pipelines and services, ensuring traceable evidence guides your hypothesis.

How do I start a root-cause investigation when an error occurs in production?

Start root-cause investigation by collecting symptoms and reproducing the issue. This Phase 1 workflow locks scope and reviews recent code changes to minimize regression risk before moving to pattern analysis and hypothesis testing.

Can I use this debugging workflow for integration failures and configuration drift?

Yes, the debugging workflow handles integration failures and configuration drift alongside error patterns like nil propagation. It applies structured pattern analysis across common services and build pipelines to ensure traceable evidence validates the root-cause hypothesis.

Do I need reproducible test steps before fixing a bug?

Yes, reproducible test steps are required to validate fixes before shipping. The workflow enforces evidence-based decisions, ensuring you reproduce the bug and document a root-cause hypothesis that confirms the fix targets the true fault.

Why does patching symptoms without root-cause analysis increase regression risk?

Patching symptoms without root-cause analysis increases regression risk because the underlying fault remains unaddressed. The structured debugging workflow requires traceable evidence and a documented hypothesis to validate that fixes resolve the actual failure source.