root-cause-analyzer

root-cause-analyzer is an agent for Claude Code from alirezarezvani/claude-code-tresor. It costs 43 tokens per session (2,619 once invoked), scanned A, original, MIT.

A debugging agent focused on root-cause analysis: finding the underlying reason a problem occurs rather than only treating its visible symptom. It covers bugs, performance problems, and production incidents.

In plain words
What is it for?
Use it to analyse system failures, interpret stack traces, test possible explanations, propose low-impact fixes, and plan safeguards against repeat incidents.
Why use it?
It provides a systematic way to investigate failures and reduce the chance that a temporary fix will leave the problem recurring.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: model in frontmatter; positional $N argument.

Good fit Use it to analyse system failures, interpret stack traces, test possible explanations, propose low-impact fixes, and plan safeguards against repeat incidents.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/alirezarezvani/claude-code-tresor/root-cause-analyzer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/alirezarezvani/claude-code-tresor

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for root-cause-analyzer

README.md
[![agentmods](https://agentmods.dev/badge/agents/alirezarezvani/claude-code-tresor/root-cause-analyzer/github.svg)](https://agentmods.dev/agents/alirezarezvani/claude-code-tresor/root-cause-analyzer)
Your own site
<a href="https://agentmods.dev/agents/alirezarezvani/claude-code-tresor/root-cause-analyzer"><img src="https://agentmods.dev/badge/agents/alirezarezvani/claude-code-tresor/root-cause-analyzer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for root-cause-analyzer

Your own site · 80×15
<a href="https://agentmods.dev/agents/alirezarezvani/claude-code-tresor/root-cause-analyzer"><img src="https://agentmods.dev/badge/agents/alirezarezvani/claude-code-tresor/root-cause-analyzer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 43 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,619 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00043 $0.02619
Opus 5.5 $0.00017 $0.01048
Sonnet 5.5 $0.00009 $0.00524
Haiku 4.5 $0.00004 $0.00262

Measured 1mo ago against content hash e0a254dd6edf, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

root-cause-analyzer scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -v -X GET https://api.example.com/endpoint
agents/root-cause-analyzer.md · 397 lines

How it starts

The opening of the file, as written. The whole thing — 397 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are an expert debugging specialist with deep understanding of system behavior, failure patterns, and systematic problem-solving methodologies. You focus on finding root causes rather than applying band-aid fixes, ensuring sustainable solutions that prevent recurring issues.

Your Debugging Expertise

As a debugging specialist, you excel in:

  • Root Cause Analysis: Systematic investigation to find underlying causes
  • Pattern Recognition: Identifying recurring issues and failure patterns
  • Hypothesis Testing: Scientific approach to debugging with measurable validation
  • Minimal-Impact Fixes: Solutions that address root causes without side effects
  • Prevention Strategies: Implementing safeguards to prevent similar issues

Working with Skills

While no skill specifically handles debugging, you benefit from skills detecting symptoms:

Skills Detect Symptoms (Autonomous):

  • code-reviewer skill flags code smells that may cause bugs
  • security-auditor skill detects vulnerabilities that lead to failures
  • test-generator skill identifies untested code paths

You Diagnose Root Causes (Expert):

  • System-level failure analysis
  • Stack trace interpretation
  • Performance bottleneck identification
  • Complex bug reproduction and isolation

Complementary Approach: Skills surface potential issues during development. When failures occur in production or complex bugs appear, you provide systematic root cause analysis and sustainable fixes. Skills help prevent bugs; you fix the ones that slip through.

Debugging Methodology

When invoked, systematically approach debugging by:

  1. Issue Assessment: Capture error details, symptoms, and environmental context
  2. Information Gathering: Collect logs, system state, and reproduction steps
  3. Hypothesis Formation: Develop testable theories about potential causes
  4. Investigation: Use debugging tools and techniques to validate hypotheses
  5. Root Cause Identification: Pinpoint the underlying cause, not just symptoms
  6. Solution Implementation: Apply minimal, targeted fixes
  7. Validation: Verify the fix resolves the issue without introducing new problems
  8. Prevention: Recommend safeguards to prevent recurrence

Read the full file on GitHub · 397 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 397 lines · 43 tokens per session scan A e0a254dd6edf

Subscribe to this mod's changes

root-cause-analyzer is an agent published in the GitHub repository alirezarezvani/claude-code-tresor (782 stars, last pushed 3mo ago), licensed MIT. It adds 43 tokens to every session and 2,619 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

qa-analyzer

Use this agent after cycle completion or when the user requests bug hunting and QA analysis. World-class QA analyst that finds bugs before users do — thinks like a confused user, power user, and malicious attacker. Documents each issue precisely so it can be filed as a bug. Context: User just completed a cycle and…

drobins25/craft · 223 tokens

fixer

Use for quick fixes, hotfixes, urgent patches, and time-sensitive bug repairs.

AgentWorkforce/relay · 21 tokens

tester

Use this agent after chunk implementation to create comprehensive test suites, or when the user requests test generation. Creates unit, integration, and edge case tests to ensure code works correctly and provide shipping confidence. Context: All chunks are implemented, orchestrator invokes testing phase. user: "All…

drobins25/craft · 200 tokens

rn-code-architect

Designs implementation blueprints for React Native features by analyzing existing codebase patterns, then providing specific files to create/modify, component designs, testID placement, store slice design, and build sequences. Triggers: "design the architecture", "plan the implementation", "create a blueprint", "what…

Lykhoyda/rn-dev-agent · 238 tokens

code-mapper

Use when quick reconnaissance is complete and an unfamiliar or risky bounded scope needs a read-only trace or thorough map of ownership, contracts, consumers, and unknowns.

tdwhere123/do-it · 36 tokens

Debug

Systematic debugger - diagnoses root causes, fixes bugs, and prevents regressions using methodical investigation.

saajunaid/caddis-plugin · 21 tokens