root-cause-analyst

root-cause-analyst is an agent for Claude Code from NikiforovAll/claude-code-rules. It costs 23 tokens per session (174 once invoked), scanned A, a copy of root-cause-analyst, Apache-2.0.

A structured investigation guide for finding the underlying cause of complex failures. It uses evidence, competing explanations, and verification instead of stopping at visible symptoms.

In plain words
What is it for?
Use it to analyze logs and error patterns, test possible causes, trace recurring failures, and define a remediation plan.
Why use it?
It helps avoid guesses and incomplete fixes when several components may be involved. It also supports documenting evidence, timelines, conclusions, and prevention steps.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions subagents.

Part of the handbook plugin — 4 agents shipped together

Good fit Use it to analyze logs and error patterns, test possible causes, trace recurring failures, and define a remediation plan.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/nikiforovall/claude-code-rules/root-cause-analyst
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/NikiforovAll/claude-code-rules

Made for: Claude Code.

Or install handbook, the plugin that ships this one along with the rest of its 4 agents.

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-analyst

README.md
[![agentmods](https://agentmods.dev/badge/agents/nikiforovall/claude-code-rules/root-cause-analyst/github.svg)](https://agentmods.dev/agents/nikiforovall/claude-code-rules/root-cause-analyst)
Your own site
<a href="https://agentmods.dev/agents/nikiforovall/claude-code-rules/root-cause-analyst"><img src="https://agentmods.dev/badge/agents/nikiforovall/claude-code-rules/root-cause-analyst/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-analyst

Your own site · 80×15
<a href="https://agentmods.dev/agents/nikiforovall/claude-code-rules/root-cause-analyst"><img src="https://agentmods.dev/badge/agents/nikiforovall/claude-code-rules/root-cause-analyst.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 23 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 174 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 95% copy Near-identical to another mod 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.00023 $0.00174
Opus 5.5 $0.00009 $0.00070
Sonnet 5.5 $0.00005 $0.00035
Haiku 4.5 $0.00002 $0.00017

Measured 12d ago against content hash 9c7d845d405a, 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-analyst scanned grade A with 0 findings 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 12d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

95% identical to root-cause-analyst — 44 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

plugins/handbook/agents/root-cause-analyst.md · 19 lines

What it actually says

Root Cause Analyst

Find the underlying cause, not just the symptom. Keep several hypotheses open and test each against evidence (code, logs, data). Mark anything you could not verify as a hypothesis, and say where evidence contradicts a theory.

Important Guidelines

  • Use Explore SubAgent: Use built-in @agent-Explore to explore existing codebase when needed

Report

The root cause with its evidence chain and a confidence level, the blast radius, and remediation options with trade-offs. When the caller's brief defines a report shape, use that.

Do not change code unless the caller asks. The caller decides on the fix after reading your report.

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. 12d ago Changed · -34 lines 9c7d845d405a
  2. 24d ago First seen · 53 lines · 23 tokens per session scan A 3e599d297484

Subscribe to this mod's changes

root-cause-analyst is an agent published in the GitHub repository NikiforovAll/claude-code-rules (141 stars, last pushed 12d ago), licensed Apache-2.0. It adds 23 tokens to every session and 174 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 95% identical to root-cause-analyst, differing in 44 lines, and is treated as a copy.

Related

Other agents, from other repositories

dead-code-analyzer

Analyzes the codebase to find unused code — functions, imports, exports, variables, types, and classes — and produces a cleanup report with confidence levels. Never auto-deletes; reports findings for user review. Context: User wants to find unused code user: "find dead code" Context: User asks about code hygiene user…

lukaskellerstein/claude-my-marketplace · 160 tokens

queue-debugger

Use this agent when the user encounters "queue not delivering messages", "consumer errors", "DLQ filling up", "throughput issues", "message backlog", "queue timeout errors", or needs systematic Cloudflare Queues troubleshooting. Examples.

secondsky/claude-skills · 0 tokens

d1-debugger

Autonomous diagnostic agent that investigates Cloudflare D1 database issues through 9-phase analysis (config, migrations, queries, bindings, errors, limits, performance, Time Travel, report). Use when encountering D1 query errors, migration failures, binding issues, performance degradation, or limit/quota errors.

secondsky/claude-skills · 65 tokens

do-debugger

Autonomous Durable Objects debugger. Automatically detects and fixes DO configuration errors, runtime issues, and common mistakes without user intervention.

secondsky/claude-skills · 28 tokens

Turnstile CSP Debugger

This agent should be used when the user asks to "validate CSP for turnstile", "fix CSP errors", "check content security policy", or encounters error 200500. Analyzes Content Security Policy headers and suggests Turnstile-compatible configurations.

secondsky/claude-skills · 58 tokens

troubleshooting-agent

This agent should be used when the user asks to "debug Cloudflare Images errors", "troubleshoot upload failures", "diagnose CORS issues", "fix transformation errors", or encounters errors 5408, 9401-9413, multipart/form-data encoding issues, or API connectivity problems.

secondsky/claude-skills · 66 tokens