diff options
| author | Craig Jennings <c@cjennings.net> | 2026-05-06 05:23:01 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-05-06 05:23:01 -0500 |
| commit | 7f51ed751ce8bf1dad23cfd9534d1238f538671e (patch) | |
| tree | 2b3e21eccea8b67eddcd7c6318ee262216328dc6 /root-cause-trace | |
| parent | 40dda3a48fbfbc14dd76c3e21d289a1b0fa813a8 (diff) | |
| download | rulesets-7f51ed751ce8bf1dad23cfd9534d1238f538671e.tar.gz rulesets-7f51ed751ce8bf1dad23cfd9534d1238f538671e.zip | |
refactor(debug): make debug a triage router, align specialist cross-refs
I sharpened the debug skill so it stops duplicating root-cause-trace and five-whys. Phase 1 captures evidence and stops there. Phase 2 routes to the right specialist instead of asking why three times inline. Phases 3 and 4 keep the verify-and-fix discipline. I also updated the companion lines in root-cause-trace and five-whys so all three descriptions stay in sync.
Diffstat (limited to 'root-cause-trace')
| -rw-r--r-- | root-cause-trace/SKILL.md | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/root-cause-trace/SKILL.md b/root-cause-trace/SKILL.md index 210ee69..74e275d 100644 --- a/root-cause-trace/SKILL.md +++ b/root-cause-trace/SKILL.md @@ -1,6 +1,6 @@ --- name: root-cause-trace -description: Given an error that manifests deep in the call stack, trace backward through the call chain to find the original trigger, then fix at the source and add defense-in-depth at each intermediate layer. Covers the backward-trace workflow (observe symptom → identify immediate cause → walk up the chain → find origin → fix + layer defenses), when and how to add instrumentation (stack capture before the dangerous operation, not after), and the bisection pattern for identifying which test pollutes shared state. Use when an error appears in the middle or end of an execution path, when a stack trace shows a long chain, when invalid data has unknown origin, or when a failure reproduces inconsistently across runs. Do NOT use for clear local bugs where the fix site is obvious (just fix it), for design-level root-cause analysis of processes/decisions (use five-whys instead), for performance regressions (different class of investigation), or when there's no symptom yet to trace from. Companion to the general `debug` skill — `debug` is broader; `root-cause-trace` is specifically the backward-walk technique. +description: Given an error that manifests deep in the call stack, trace backward through the call chain to find the original trigger, then fix at the source and add defense-in-depth at each intermediate layer. Covers the backward-trace workflow (observe symptom → identify immediate cause → walk up the chain → find origin → fix + layer defenses), when and how to add instrumentation (stack capture before the dangerous operation, not after), and the bisection pattern for identifying which test pollutes shared state. Use when an error appears in the middle or end of an execution path, when a stack trace shows a long chain, when invalid data has unknown origin, or when a failure reproduces inconsistently across runs. Do NOT use for clear local bugs where the fix site is obvious (just fix it), for design-level root-cause analysis of processes/decisions (use five-whys instead), for performance regressions (different class of investigation), or when there's no symptom yet to trace from. Often dispatched from `debug`'s Phase 2 routing when the bug is a code-execution chain; usable directly when the symptom is already clearly a stack-trace walk. --- # Root-Cause Trace |
