problem-analysis

Analyze symptoms and data to identify root causes of software issues.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sachio222/based-stack --skill problem-analysis-sachio222
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: problem-analysis
Source: https://github.com/sachio222/based-stack/tree/main/problem-analysis
Command: npx skills add https://github.com/sachio222/based-stack --skill problem-analysis-sachio222

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies root causes of issues by analyzing observable symptoms and data, not proposing fixes.

Core Features & Use Cases

  • Structured five-phase workflow (Gate, Hypothesize, Investigate, Formulate, Output) to diagnose issues systematically.
  • Supports generating and evaluating multiple hypotheses, iterative evidence gathering, and producing a structured root-cause report for downstream actions.
  • Applicable to debugging, performance degradation, reliability problems, and unexpected behavior across software systems.

Quick Start

Run the problem-analysis analyze script to begin root-cause investigation.

Frequently Asked Questions about problem-analysis

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

FAQPage Schema
How do I find the root cause of software debugging issues instead of just patching symptoms?

To find the root cause of debugging issues, you need a structured investigation workflow that analyzes observable symptoms and data rather than proposing immediate fixes. A deterministic, phase-driven approach ensures you systematically diagnose software problems before taking action.

What is the best way to troubleshoot performance degradation and reliability problems across software systems?

The best way to troubleshoot performance degradation and reliability problems is by applying a phase-driven investigation workflow. This involves generating multiple hypotheses, iteratively gathering evidence, and formulating a structured root-cause report for downstream actions.

How do I systematically investigate unexpected behavior in software engineering?

You investigate unexpected behavior by passing observable symptoms and data through a five-phase workflow: Gate, Hypothesize, Investigate, Formulate, and Output. This deterministic process evaluates multiple hypotheses to pinpoint the exact root cause of the software issue.

Can I use this root-cause analysis approach for any software system or does it require specific dependencies?

You can apply this root-cause analysis approach across any software system because it operates without dependencies. It is designed to diagnose debugging, performance degradation, and reliability problems universally by analyzing observable symptoms and data.

Does this troubleshooting method generate actual code fixes for the identified issues?

No, this troubleshooting method does not propose fixes or generate code. It strictly identifies root causes by analyzing observable symptoms and data, producing a structured root-cause report that informs downstream actions for other tools or engineers to implement.

When should I use a structured root-cause investigation workflow instead of standard debugging?

Use a structured root-cause investigation workflow when standard debugging fails to resolve persistent performance degradation, reliability problems, or unexpected behavior. It systematically evaluates hypotheses and evidence to pinpoint underlying causes that quick fixes often miss.