evidence-based-investigator

evidence-based-investigator is an agent for Claude Code from testdouble/han. It costs 85 tokens per session (1,069 once invoked), scanned A, original, MIT.

An investigation guide for finding the cause of a codebase problem using concrete evidence. It requires findings to be tied to file paths, line numbers, code, error messages, history, or test coverage.

In plain words
What is it for?
Use it to investigate bugs, failures, regressions, and unexpected behaviour in a repository. It helps trace reproduction paths, call chains, error propagation, contributing factors, and gaps in test coverage.
Why use it?
It reduces the risk of mistaking a visible symptom for the real cause. It also makes conclusions checkable by separating verified evidence from outside context and unknowns.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the han-core plugin — 2 skills, 22 agents shipped together

Good fit Use it to investigate bugs, failures, regressions, and unexpected behaviour in a repository. It helps trace reproduction paths, call chains, error propagation, contributing factors, and gaps in test coverage.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/testdouble/han/evidence-based-investigator
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/testdouble/han

Made for: Claude Code.

Or install han-core, the plugin that ships this one along with the rest of its 2 skills, 22 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 evidence-based-investigator

README.md
[![agentmods](https://agentmods.dev/badge/agents/testdouble/han/evidence-based-investigator/github.svg)](https://agentmods.dev/agents/testdouble/han/evidence-based-investigator)
Your own site
<a href="https://agentmods.dev/agents/testdouble/han/evidence-based-investigator"><img src="https://agentmods.dev/badge/agents/testdouble/han/evidence-based-investigator/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 evidence-based-investigator

Your own site · 80×15
<a href="https://agentmods.dev/agents/testdouble/han/evidence-based-investigator"><img src="https://agentmods.dev/badge/agents/testdouble/han/evidence-based-investigator.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 85 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,069 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 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.00085 $0.01069
Opus 5.5 $0.00034 $0.00428
Sonnet 5.5 $0.00017 $0.00214
Haiku 4.5 $0.00009 $0.00107

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

Security

Grade A, and why

evidence-based-investigator 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 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.

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.

han-core/agents/evidence-based-investigator.md · 100 lines

How it starts

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

You are an evidence-based investigator. Your job is to gather concrete, verifiable evidence about a codebase issue. Every claim you make must be backed by a file path, line number, and code snippet or error message.

Apply Han's canonical evidence rule. Codebase evidence (the focus of this agent) is the trusted current-state anchor and stands on a single citation per finding. When the investigation surfaces web-source context (RFCs, library docs, third-party explanations), label the trust class and apply the corroboration gate before letting that context drive a conclusion. When a question has no evidence at any tier, label it rather than fabricating an answer.

Domain Vocabulary

root cause, proximate cause, contributing factor, symptom vs. cause, reproduction path, minimal reproduction, blame annotation, bisect, regression commit, call chain, stack trace, data flow trace, error propagation path, silent failure, masked exception, correlation vs. causation, temporal correlation, test coverage gap, fixture drift

Anti-Patterns

  • Symptom-as-Cause: Investigator reports the visible symptom as the root cause without tracing further. Detection: evidence chain has only one hop from symptom to conclusion.
  • Stale Blame: Investigator cites git blame without checking whether the blamed commit is actually relevant (e.g., it was a formatting-only change). Detection: blame citations without reading the actual commit diff.
  • Single-Layer Investigation: Investigator examines only the layer where the symptom appears. Detection: all evidence items cite files in the same directory or module.
  • Missing Negative Evidence: Investigator does not report what was searched and not found. Detection: no "searched X, found nothing" entries in the evidence list.
  • Test Coverage Assumption: Investigator assumes untested code is correct because no test fails. Detection: "no test failures" cited as evidence of correctness without examining whether tests exist for the affected path.

Read the full file on GitHub · 100 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 · 100 lines · 85 tokens per session scan A 946e869fdd3a

Subscribe to this mod's changes

evidence-based-investigator is an agent published in the GitHub repository testdouble/han (316 stars, last pushed 3d ago), licensed MIT. It adds 85 tokens to every session and 1,069 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. 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

debugger

Use this agent for root-cause analysis of bugs, test failures, and unexpected behavior. Follows the 5 Whys protocol and produces ROOT-CAUSE.md with evidence chain and remediation plan. Examples: Context: A test suite is failing after a recent commit and the cause is unclear. user: "Figure out why the tests are…

lgbarn/shipyard · 305 tokens

parity-auditor

Re-derives rewrite parity from evidence — maps each obligation (acceptance probe, contract witness, ledger guarantee) to a test and a fresh run, rejecting stale, stubbed or excluded results. Use when /rewrite:verify scores a slice.

oliver-kriska/claude-elixir-phoenix · 56 tokens

testing-reviewer

Reviews test code for Elixir best practices - ExUnit patterns, Mox usage, LiveView testing, factory patterns. Use proactively after writing tests or during code review.

oliver-kriska/claude-elixir-phoenix · 38 tokens

shipyard:debugger

Use this agent for root-cause analysis of bugs, test failures, and unexpected behavior. Follows the 5 Whys protocol and systematic debugging methodology.

lgbarn/shipyard · 37 tokens

challenger

Use when: before the lead reports a root-cause conclusion, a 'done/verified' claim, an irreversible action about to run (commit/deploy/rm/push), or a 2nd-time fix — in APEX or plain conversation; also every eLicit round and Verify gate. Do NOT use for: code correctness/lint/types/API usage (sniper's job), or as a veto…

fusengine/agents · 92 tokens

ia-bug-reproduction-validator

Validates, reproduces, and root-cause analyzes bug reports (does not fix). Use when a bug report needs verification and root-cause identification before committing to a fix; invoked without a GitHub issue. For issue-linked reproduction use /ia-reproduce-bug.

iliaal/whetstone · 62 tokens