rai-debug

Guide root-cause analysis with 5 Whys, Ishikawa, and Gemba methods.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/fcastrillo/carbtrack-ai --skill rai-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rai-debug
Source: https://github.com/fcastrillo/carbtrack-ai/tree/main/.claude/skills/rai-debug
Command: npx skills add https://github.com/fcastrillo/carbtrack-ai --skill rai-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically identify and fix the root cause of defects, errors, or unexpected behavior using lean problem-solving methods (5 Whys, Ishikawa, Gemba), preventing symptom-based fixes.

Core Features & Use Cases

  • 5 Whys analysis to trace root causes
  • Ishikawa diagrams to map multiple potential causes
  • Gemba observations to validate real-world behavior
  • A3 thinking for structured problem documentation
  • Documented countermeasures and preventive measures to avoid recurrence
  • Knowledge capture for audits and team learning

Quick Start

Run the rai-debug workflow against a documented issue and follow the steps to define the problem, apply 5 Whys and Ishikawa analyses, verify root causes, implement fixes, and add preventive measures.

Frequently Asked Questions about rai-debug

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

FAQPage Schema
How do I perform root-cause analysis for software defects using lean methods?

Root-cause analysis uses lean methods like 5 Whys and Ishikawa diagrams to trace defects beyond surface symptoms. You systematically define the problem, gather evidence, test hypotheses, and document countermeasures to fix the actual underlying cause.

What is the best way to identify the root cause of unexpected system behavior or errors?

Identifying the root cause of unexpected behavior requires structured problem-solving techniques such as Gemba observations and 5 Whys. This approach validates real-world behavior and maps multiple potential causes to uncover actionable fixes rather than applying temporary symptom-based patches.

When should I use Ishikawa diagrams and 5 Whys for debugging?

Use Ishikawa diagrams and 5 Whys for debugging when you need to map multiple potential causes or trace a defect's origin sequentially. These lean methods are essential when symptom-based fixes fail and you need documented countermeasures to prevent recurrence.

Can I apply lean problem-solving methods to performance issues and process defects?

Yes, lean problem-solving methods apply to performance issues and process defects across software and workflows. Techniques like Gemba observations and A3 thinking validate real-world behavior and structure problem documentation to guide teams toward actionable fixes.

How do I document countermeasures and preventive measures after finding a root cause?

Document countermeasures and preventive measures using A3 thinking for structured problem documentation. After verifying root causes through hypothesis testing, you record implemented fixes and prevention measures to reduce recurrence and capture knowledge for team learning and audits.