analyze

Diagnose software issues with structured evidence and competing hypotheses.

3|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Tienching/oh-my-codebuddy --skill analyze-tienching
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze
Source: https://github.com/Tienching/oh-my-codebuddy/tree/main/skills/analyze
Command: npx skills add https://github.com/Tienching/oh-my-codebuddy --skill analyze-tienching

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a disciplined framework to diagnose why a problem occurs in software systems by collecting observations, formulating competing hypotheses, and mapping evidence to support or refute each explanation, resulting in traceable, structured conclusions.

Core Features & Use Cases

  • ObservationHypotheses: Capture actual observations, propose multiple explanations, and link each to supporting and conflicting evidence.
  • Evidence Mapping: Gather artifacts like logs, configs, and file references to differentiate explanations and quantify their strength.
  • Team-mode readiness: Enable parallel hypothesis lanes and rebuttal rounds for complex investigations with defined guardrails.
  • Execution policy & guardrails: Enforce disciplined progress, explicit next steps, and safe handling of uncertain results.

Quick Start

Run an evidence-driven investigation by describing the observed issue and asking for a structured root-cause analysis.

Frequently Asked Questions about analyze

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

FAQPage Schema
How do I perform a structured root-cause analysis for a multi-file software bug?

Root-cause analysis for multi-file software bugs requires collecting observations, formulating competing hypotheses, and mapping supporting or conflicting evidence to reach traceable conclusions. This approach enforces an evidence-driven workflow by structuring logs and configs into hypothesis lanes with falsification plans.

What is the best way to investigate cross-file architecture problems using evidence?

Investigating cross-file architecture problems using evidence involves capturing actual observations and mapping artifacts like logs and file references to support or refute competing explanations. This structured method differentiates potential root causes by quantifying the strength of gathered evidence against each hypothesis.

Can I use a hypothesis-driven workflow for runtime performance investigations?

A hypothesis-driven workflow for runtime performance investigations lets you apply structured evidence gathering to test multiple explanations for observed issues. It enforces disciplined progress through observation collection, evidence mapping, and explicit falsification plans to safely handle uncertain results.

How does evidence mapping work when diagnosing complex software system failures?

Evidence mapping for diagnosing complex software system failures works by gathering artifacts such as logs and configurations to differentiate explanations and quantify their strength. It connects each piece of evidence directly to supporting or conflicting roles against specific hypotheses.

Does this structured investigation approach support parallel hypothesis tracking for teams?

This structured investigation approach supports parallel hypothesis tracking for teams through defined guardrails and parallel hypothesis lanes. It enables team-mode readiness by allowing multiple explanations to be investigated simultaneously with structured rebuttal rounds and explicit execution policies.

When should I not use a falsification plan for root-cause analysis?

You should not use a falsification plan for root-cause analysis when dealing with single-file syntax errors or isolated issues where the root cause is immediately observable without competing explanations. It is designed for complex cross-file investigations requiring competing hypotheses and evidence mapping.