investigate

Diagnoses root causes of bugs by analyzing logs, code, and evidence.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/TobiasPerry/aws-hackathon --skill investigate-tobiasperry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/TobiasPerry/aws-hackathon/tree/main/.claude/skills/gstack/investigate
Command: npx skills add https://github.com/TobiasPerry/aws-hackathon --skill investigate-tobiasperry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enforces a disciplined approach to debugging by preventing symptom-based fixes and guiding you toward the root cause. It helps teams collect symptoms, logs, and code evidence to form testable hypotheses and verifiable fixes.

Core Features & Use Cases

  • Collects error messages, stack traces, and diffs to surface root causes before proposing changes.
  • Reproduces issues across environments using git history, patches, and logs to validate hypotheses.
  • Proposes concrete fixes with regression tests and verification steps, reducing firefighting time.

Quick Start

Run the investigate skill to begin a structured root-cause analysis on the current project.

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 bug instead of just fixing the symptoms?

To find the root cause of a bug, you need to systematically collect error messages, stack traces, and code diffs to form testable hypotheses. This approach enforces disciplined debugging by gathering evidence before proposing changes.

What is the best way to reproduce an issue across different environments using git history?

Reproducing an issue across environments involves analyzing git history, patches, and logs to validate hypotheses. By tracking code changes and comparing runtime data, you can reliably isolate the specific commit or condition triggering the defect.

How do I propose a concrete bug fix that includes regression tests?

To propose a concrete bug fix with regression tests, you first verify your hypothesis by reproducing the issue. You then implement the code correction and add corresponding tests to prevent the same defect from recurring in future changes.

Can I use bash and grep to gather logs and code evidence for debugging?

Yes, you can use bash and grep to gather logs and code evidence for debugging. These tools allow you to search through codebases and runtime data to collect the stack traces and error messages needed for root-cause analysis.

Does systematic root-cause debugging work for any codebase or programming language?

Systematic root-cause debugging works across different codebases by applying standard evidence gathering and hypothesis verification techniques. It relies on analyzing logs and code behavior rather than language-specific features, making it broadly applicable.

Why should I gather stack traces and error messages before writing a code fix?

You should gather stack traces and error messages before writing a code fix to avoid symptom-based patches. Collecting this evidence first ensures you understand the underlying failure mechanism and can implement a verifiable solution.