root-cause-tracing

Trace execution errors backward through call chains to identify root causes.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill root-cause-tracing-krzemienski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: root-cause-tracing
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/root-cause-tracing
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill root-cause-tracing-krzemienski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematically traces errors back to their original trigger, adding instrumentation when needed to locate root causes.

Core Features & Use Cases

  • Backtrace through call stack with instrumentation
  • Quantitative trace tracking via Serena
  • Root cause identification before fixes

Quick Start

Apply root-cause tracing to a failing operation and identify the trigger.

Frequently Asked Questions about root-cause-tracing

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

FAQPage Schema
How do I trace a bug back to its root cause instead of just fixing the symptom?

Root-cause tracing systematically backtracks through your call stack with instrumentation to identify the original trigger, not the surface error. This approach captures the full propagation chain, quantifies execution paths via structured metadata, and pinpoints where invalid data or incorrect behavior first originated, enabling targeted fixes rather than band-aids.

Can I trace errors deep in complex call chains when reproduction is difficult?

Yes. Root-cause tracing is designed for errors buried deep in long call stacks and contexts where reproduction is nontrivial, such as test or instrumentation environments. It adds instrumentation to capture symptom data, tracks propagation through the chain, and identifies the original trigger without requiring easy reproduction.

What's the difference between tracing a symptom versus finding the root cause?

Tracing symptoms stops at the visible error; root-cause tracing goes backward through execution to find where the problem actually started. Root-cause tracing adds instrumentation to map the full propagation path, captures quantitative metadata, and identifies the original invalid condition or incorrect decision that led to the eventual failure.

How do I instrument my code to capture the full execution trace?

Root-cause tracing supports backward call-chain instrumentation that captures execution context and data flow. The Skill generates structured trace metadata documenting each step in the propagation chain, enabling you to see where data became invalid or logic went wrong and trace it back to the original trigger.

When should I use root-cause tracing versus just reading the stack trace?

Stack traces show where an error occurred, not why. Root-cause tracing is essential when the origin is unclear, errors propagate through multiple layers, or the actual bug is nowhere near where the crash happens. It's especially valuable in test and instrumentation contexts where manual reproduction is slow or impractical.

Can root-cause tracing work with unclear data corruption or invalid state?

Yes. Root-cause tracing handles scenarios where the origin of invalid data is unclear by tracking propagation through the call chain with instrumentation. It captures when and where data became corrupted or state became invalid, then backtracks to identify the original source of the problem.