gstack-openclaw-investigate

Diagnose bugs through root cause investigation, hypothesis testing, and verified fixes.

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill gstack-openclaw-investigate-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gstack-openclaw-investigate
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/openclaw/skills/gstack-openclaw-investigate
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill gstack-openclaw-investigate-sanjanb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging often devolves into guessing and symptom-patching, creating whack-a-mole cycles where each fix spawns new bugs. This Skill enforces a disciplined five-phase workflow that finds the actual root cause before any code changes, then proves the fix works with regression tests. ## Core Features & Use Cases - Root Cause Investigation: Collects symptoms, traces code paths, checks recent git history, and reproduces the bug before forming any hypothesis. - Pattern Analysis & Hypothesis Testing: Matches bugs against known patterns (race conditions, null propagation, state corruption, integration failures) and applies a 3-strike rule that stops blind guessing and escalates when hypotheses fail. - Verified Fixes with Regression Tests: Requires a test that fails without the fix and passes with it, plus a structured debug report saved to memory for future sessions. - Use Case: A user reports an intermittent production error with a stack trace. The Skill traces the failure path, checks recent commits, confirms a race condition hypothesis with a temporary log statement, applies a minimal fix, and ships a regression test with a full debug report. ## Quick Start Investigate this error and find the root cause before proposing any fix, then verify the fix with a regression test.

Frequently Asked Questions about gstack-openclaw-investigate

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

FAQPage Schema
How do I debug a bug without guessing at fixes?

Follow a root cause investigation process: collect symptoms and stack traces, trace the code path from the failure point, check recent git changes, and reproduce the bug before forming any hypothesis. Only propose a fix after confirming the hypothesis with evidence.

How to find the root cause of an intermittent bug?

Intermittent bugs often indicate race conditions or timing-dependent state issues. Check concurrent access to shared state, add temporary logging at suspected failure points, and gather evidence across multiple reproductions before concluding a cause.

What should I do after multiple fix attempts fail?

Stop after three failed hypotheses and question the architecture rather than guessing again. Escalate for human review, add instrumentation to catch the bug next time, or continue only with a clearly described new hypothesis.

Why write a regression test for every bug fix?

A regression test proves the fix works and prevents the bug from returning. It must fail without the fix and pass with it, confirming both that the test is meaningful and that the root cause was actually addressed.

When should a bug fix be escalated instead of shipped?

Escalate when the root cause remains unclear after investigation, when the fix touches more than five files, or when the bug cannot be reproduced and verified. Never ship a fix you cannot confirm with tests.