dev-trace

Generate ranked hypotheses with evidence for ambiguous engineering observations.

520|175|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/EvolutionAPI/evo-nexus --skill dev-trace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-trace
Source: https://github.com/EvolutionAPI/evo-nexus/tree/main/.claude/skills/dev-trace
Command: npx skills add https://github.com/EvolutionAPI/evo-nexus --skill dev-trace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents premature conclusions in investigations by generating multiple competing explanations for an observation, collecting evidence for and against each, ranking them by strength, and proposing a discriminating probe to resolve uncertainty.

Core Features & Use Cases

  • Multi-hypothesis generation: produce two or more plausible explanations for an ambiguous observation.
  • Evidence collection and comparison: gather and organize evidence FOR and AGAINST each hypothesis and apply analytical lenses such as systems thinking, premortem, and scientific skepticism.
  • Decision guidance and reporting: rebut strong alternatives, synthesize a provisional best explanation, and output a structured report saved to the workspace for follow-up.
  • Use cases include intermittent bugs, regional anomalies, unexplained performance regressions, and architectural root-cause exploration.

Quick Start

Use the dev-trace skill to evaluate competing explanations for a recent regression by generating hypotheses, collecting supporting and contradicting evidence, ranking them, and proposing the next discriminating test.

Frequently Asked Questions about dev-trace

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

FAQPage Schema
How do I systematically find the root cause of an intermittent bug with multiple possible explanations?

Root cause analysis of intermittent bugs requires generating multiple plausible hypotheses, evaluating evidence for and against each, and ranking them by strength to identify the most likely explanation. This approach prevents premature conclusions by ensuring competing causes are systematically compared before resolution.

What is the best way to investigate unexplained performance regressions across regional anomalies?

Investigating performance regressions across regional anomalies demands evidence-driven causal tracing to generate competing explanations for the observation. By applying analytical lenses like systems thinking and premortem, you can gather supporting and contradicting evidence for each hypothesis to isolate the true underlying cause.

How do I stop jumping to conclusions during incident investigation when several root causes seem equally valid?

Incident investigation benefits from generating two or more plausible explanations for an ambiguous observation and systematically collecting evidence for and against each. Ranking these hypotheses by evidence strength and proposing a discriminating probe helps resolve uncertainty and prevents premature conclusions during the investigation.

Can I use hypothesis testing to debug architectural regressions without immediate code changes?

Hypothesis testing for architectural regressions involves applying scientific skepticism to evaluate competing causal explanations before making code changes. By synthesizing a provisional best explanation and proposing a discriminating test, you validate the root cause safely and output a structured report for follow-up.

When should I use causal tracing instead of standard debugging methods for ambiguous engineering observations?

Causal tracing is necessary for ambiguous engineering observations when standard debugging fails to isolate a single root cause. Use it when multiple hypotheses exist for intermittent bugs, regional anomalies, or performance regressions, and you need to rank competing causes by evidence strength to determine the next probe.

Does dev-trace support generating a structured report for follow-up after ranking competing root cause hypotheses?

Dev-trace supports generating a structured report saved to the workspace for follow-up after ranking competing root cause hypotheses. The process involves collecting evidence, rebutting strong alternatives, synthesizing a provisional best explanation, and outputting the final decision guidance and findings for future reference.