investigate

Diagnose bugs through systematic root cause investigation before implementing fixes.

Updated Jun 16, 2026
One-click install
npx skills add https://github.com/adamtpang/summon.company --skill investigate-adamtpang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: investigate
Source: https://github.com/adamtpang/summon.company/tree/main/.claude/skills/investigate
Command: npx skills add https://github.com/adamtpang/summon.company --skill investigate-adamtpang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging often leads to hasty patches that mask symptoms instead of fixing the underlying issue. This Skill enforces a disciplined four-phase workflow—investigate, analyze, hypothesize, implement—with an iron law of no fixes without an identified root cause. ## Core Features & Use Cases - Structured Debugging Phases: Guides the AI through investigation, analysis, hypothesis formation, and implementation in a strict sequence. - Proactive Error Response: Automatically activates when users report errors, stack traces, 500 errors, or unexpected behavior like "it was working yesterday." - Context-Aware Sessions: Loads prior investigations, project learnings, and past eureka moments from the gstack knowledge store to avoid repeating past mistakes. - Use Case: A user reports "the login endpoint returns 500 after the last deploy." The Skill investigates logs and code, forms a hypothesis about the root cause, confirms it, and only then implements a fix. ## Quick Start Ask the AI to investigate why the application is throwing an error and find the root cause before fixing it.

Frequently Asked Questions about investigate

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

FAQPage Schema
How do I debug a bug systematically instead of guessing fixes?

Use a phased debugging workflow: investigate the symptoms, analyze the evidence, form a hypothesis about the root cause, and only then implement a fix. This Skill enforces that sequence and blocks edits until the root cause is identified.

What is root cause analysis in software debugging?

Root cause analysis traces a failure back to the underlying defect rather than its visible symptom. This Skill applies it by requiring investigation and hypothesis confirmation before any Edit or Write operation is allowed.

When should I use this debugging skill?

Invoke it when you see errors, stack traces, 500 responses, or behavior that regressed after a change. It also activates proactively when you report that something stopped working or was working yesterday.

Does this skill work in headless or CI environments?

Yes, it detects the session kind (interactive, spawned, or headless) and adapts. In headless mode it blocks instead of prompting, and in spawned sessions it auto-selects recommended options and reports results as prose.

Why does the skill block edits during debugging?

A PreToolUse hook runs a freeze check on Edit and Write operations to enforce the scope boundary. This prevents premature fixes before the root cause is confirmed, keeping the investigation disciplined.