evidence-debugger

Diagnoses bugs and regressions from logs, errors, and test failures with explicit confidence levels.

8|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Gold-b/claude-code-governance --skill evidence-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evidence-debugger
Source: https://github.com/Gold-b/claude-code-governance/tree/main/bundle/skills/evidence-debugger
Command: npx skills add https://github.com/Gold-b/claude-code-governance --skill evidence-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose bugs, regressions, and unexpected behavior without guessing. It turns scattered evidence such as logs, errors, and test failures into a structured root-cause analysis with a confidence level, clear proof boundaries, and a minimal fix path.

Core Features & Use Cases

  • Evidence-first debugging: Separates direct evidence from indirect clues so conclusions stay grounded in facts.
  • Confidence-based diagnosis: Produces 1-3 hypotheses, ranks them by confidence, and refuses to overstate weak conclusions.
  • Minimal fix planning: Suggests the smallest targeted change needed to address the leading cause, plus regression checks and a gotcha entry to prevent recurrence.
  • Use Cases: Investigating a production error from logs, analyzing a regression after a recent commit, validating whether a bug matches a known pitfall in project memory, or preparing a safe handoff to an implementation skill.

Quick Start

Ask the evidence-debugger skill to analyze your error logs, expected behavior, and actual behavior to identify the most likely root cause with confidence and a minimal fix path.

Frequently Asked Questions about evidence-debugger

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

FAQPage Schema
How do I find a root cause from error logs and test failures without guessing?

To find a root cause from error logs, you can use evidence-first debugging to separate direct evidence from indirect clues. This approach analyzes logs, errors, and test failures to produce ranked hypotheses with explicit confidence levels and clear proof boundaries.

What is the best way to diagnose a software regression after a recent commit?

Diagnosing a software regression involves inspecting git history and analyzing evidence to identify the most likely root cause. This process applies evidence-first reasoning to separate proven versus unproven claims, generating a minimal targeted fix path without executing code changes.

Can I use evidence-based root cause analysis to investigate a production error?

Yes, evidence-based root cause analysis can investigate a production error by turning scattered logs and errors into a structured diagnosis. It produces 1-3 ranked hypotheses by confidence, refuses to overstate weak conclusions, and suggests regression checks to prevent recurrence.

How do I generate a minimal fix path for a bug?

To generate a minimal fix path for a bug, analyze the diagnostic evidence to identify the leading cause. The process suggests the smallest targeted change needed to address it, plus regression checks and a gotcha entry to prevent future recurrence.

What are the limitations of read-only debugging analysis?

Read-only debugging analysis limitations include the inability to execute code changes directly. It strictly separates proven versus unproven claims and refuses to overstate weak conclusions, meaning it provides diagnosis and fix planning but requires a separate implementation step.