trace

Trace causal observations to rank competing explanations for system behavior.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/INNERJOINT/HarnessSkills --skill trace-innerjoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/INNERJOINT/HarnessSkills/tree/main/skills/trace
Command: npx skills add https://github.com/INNERJOINT/HarnessSkills --skill trace-innerjoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Trace provides a structured, evidence-first workflow to explain why an observed system behavior occurred instead of jumping straight to fixes, reducing false assumptions and improving diagnostic clarity.

Core Features & Use Cases

  • Hypothesis-driven orchestration: restates the observation, generates competing hypotheses, and assigns one tracer lane per hypothesis.
  • Parallel evidence gathering: runs multiple tracer workers in Claude built-in team mode to collect evidence for and against each hypothesis.
  • Evidence ranking and rebuttal: ranks evidence strength, runs rebuttal rounds, detects convergence or separation, and proposes the highest-value discriminating probe.
  • Use Cases: runtime bugs and regressions, performance/latency analysis, configuration/orchestration failures, scientific experiment tracing, and architecture premortems/postmortems.

Quick Start

Use the trace skill to analyze why a service's latency spiked by restating the observation, generating three competing hypotheses, gathering evidence in parallel, and recommending the single best discriminating probe.

Frequently Asked Questions about trace

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

FAQPage Schema
What is the best way to identify the root cause of a runtime bug or performance regression?

Root cause analysis for runtime bugs or performance regressions works best by restating the observation, generating competing hypotheses, and gathering evidence in parallel to rank explanations. This structured approach reduces false assumptions and improves diagnostic clarity before jumping to fixes.

How do I debug orchestration failures using an evidence-driven approach?

Debug orchestration failures by assigning one tracer lane per competing hypothesis to collect evidence in parallel. Rank evidence strength, run rebuttal rounds to detect convergence or separation, and propose the single best discriminating probe to isolate the failure.

Can I use parallel hypothesis tracking for incident response and postmortem analysis?

Incident response and postmortem analysis benefit from parallel hypothesis tracking by gathering evidence for and against competing explanations simultaneously. This evidence-first workflow ranks explanations, runs rebuttals, and recommends the highest-value discriminating probe.

How does evidence ranking work when tracing ambiguous causal observations?

Evidence ranking for ambiguous causal observations works by running multiple tracer workers in parallel to collect supporting and opposing evidence per hypothesis. It ranks evidence strength, runs rebuttal rounds, detects convergence or separation, and proposes the single best discriminating probe.

When should I use hypothesis-driven tracing instead of jumping straight to a fix?

Hypothesis-driven tracing is needed when you face ambiguous causal observations like configuration failures, latency spikes, or experiment analysis. It prevents false assumptions by structuring evidence collection across competing explanations before proposing fixes.

Does this approach work for architecture premortems and scientific experiment tracing?

Architecture premortems and scientific experiment tracing fit this approach by applying evidence-first causal analysis to rank competing explanations. It restates observations, gathers parallel evidence, runs rebuttals, and proposes discriminating probes for complex systemic questions.