Root Cause Analysis Assistant

Most debugging with an AI turns into guess-and-check: it proposes a fix, you try it, it proposes another, and three rounds later the real cause is still untouched. Systematic debugging is a discipline. Root Cause Analysis Assistant runs it on your error. Give it the symptom, the stack trace, the logs, the scope (always or intermittent, one environment or all), and what recently changed, and it reconstructs what actually happened — reading the trace to the real origin, not just the top frame — separates the symptom location from where the bad state originated, forms ranked hypotheses using the common failure patterns (a recent change, a null from upstream, an edge input, an environment or config difference, a race, an external dependency, a wrong assumption about the data), and recommends the single cheapest diagnostic that eliminates the most possibilities rather than a shotgun of speculative fixes. It names the most likely root cause with the evidence, gives the fix and how to confirm it addresses the cause rather than silencing the symptom, and offers a fallback hypothesis if the top one is wrong. The download includes three reference files: the diagnosis worksheet, a common-root-cause pattern guide, and a worked sample diagnosis. It reasons from what you provide — it doesn't run your code, reproduce the bug, or access your system, so its diagnosis is a ranked hypothesis to verify. Works with Claude Code, Cursor, Codex CLI, Gemini CLI, and any SKILL.md agent.