researcher-agent

researcher-agent is an agent for Claude Code from leee880619-commits/ClaudeCode-Harness-Setup-Assistant. It costs 36 tokens per session (425 once invoked), scanned A, original, Apache-2.0.

A codebase research agent that deeply examines folders, files, dependencies, call flows, and business rules, then saves its findings in a research.md file.

In plain words
What is it for?
Use it before implementing a change when you need to find relevant files, understand how functions connect, record design questions, or check an existing code map.
Why use it?
It gives developers a documented map of unfamiliar code without changing the code. Unknown or unclear details are marked instead of guessed.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter.

Part of the harness-architect plugin — 2 skills, 7 commands, 25 agents, 1 hook shipped together

Good fit Use it before implementing a change when you need to find relevant files, understand how functions connect, record design questions, or check an existing code map.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent
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/leee880619-commits/ClaudeCode-Harness-Setup-Assistant

Made for: Claude Code.

Or install harness-architect, the plugin that ships this one along with the rest of its 2 skills, 7 commands, 25 agents, 1 hook.

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 researcher-agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent/github.svg)](https://agentmods.dev/agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent)
Your own site
<a href="https://agentmods.dev/agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent"><img src="https://agentmods.dev/badge/agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent/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 researcher-agent

Your own site · 80×15
<a href="https://agentmods.dev/agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent"><img src="https://agentmods.dev/badge/agents/leee880619-commits/claudecode-harness-setup-assistant/researcher-agent.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 36 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 425 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.00036 $0.00425
Opus 5 $0.00018 $0.00212
Sonnet 5 $0.00007 $0.00085
Haiku 4.5 $0.00004 $0.00042

Measured 12d ago against content hash e65d3d09852e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

researcher-agent 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.

.claude/templates/workflows/strict-coding-6step/agents/researcher-agent.md · 28 lines

What it actually says

You are a code researcher for strict-coding-6step STEP 1.

Identity

  • 대상 코드베이스를 겉핥기가 아닌 깊이, 매우 상세히 분석하는 전문가
  • 레이어 구조·호출 흐름·의존성·도메인 규칙을 모두 추적한다
  • 발견하지 못한 항목은 "미확인"으로 표시하고, 가정하지 않는다

Playbooks

작업 시 다음 방법론을 Read하여 따른다:

  • playbooks/code-research.md

Rules

  • 코드를 수정하지 않는다. 읽기·분석만 수행
  • 산출물: docs/{task-name}/research.md
  • 채팅으로 요약하지 않고 반드시 파일로 저장
  • 관련 파일의 전체 경로·핵심 함수·호출 관계를 명시
  • 확인 불가한 항목은 "미확인"으로 표시하고 이유를 기록
  • 불명확한 설계 결정은 Escalations 섹션에 기록
  • 코드맵 우선 탐색 (이 프로젝트가 code-navigation 규칙을 채택한 경우):
    • docs/architecture/code-map.md 존재 시: 코드베이스 직접 탐색 전에 먼저 Read. 관련 위치만 타겟팅하여 소스 Read. 부족한 영역만 Grep/Glob으로 확장
    • 코드맵 부재 시: Grep/Glob 무차별 탐색으로 진행. 동시에 docs/{task-name}/ 안의 이전 research.md에 이미 code-map 부재 Escalation이 있는지 확인하고, 없을 때만 이번 research.md의 Escalations에 [ASK] code-map.md 부재 — 생성할지 확인 필요 추가. 중복 기록 금지
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 First seen · 28 lines · 36 tokens per session scan A e65d3d09852e

Subscribe to this mod's changes

researcher-agent is an agent published in the GitHub repository leee880619-commits/ClaudeCode-Harness-Setup-Assistant (2 stars, last pushed 2mo ago), licensed Apache-2.0. It adds 36 tokens to every session and 425 once invoked, about $0.0002 per session on Opus 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-31.

Related

Other agents, from other repositories

persona-innovator

Generates naming candidates, frame proposals, and external frontier absorption signals for harness evolution. Combines the harness owner's ideation algorithm with external frontier scanning. Use when new naming or frames are needed, or during autonomous meta-simulation rounds. Supports environments without naming…

chrono-meta/forge-harness · 61 tokens

quench-challenger

Dedicated quench attack-prescription synthesis agent — Devil (6-axis harness-specific attack) + Innovator (immediate alternatives) + Prescriber (one-line surgical prescription) 3-DNA synthesis. Every attack is paired with a concrete fix direction — no pure criticism. Built-in replacement engine for steel-quench Wave…

chrono-meta/forge-harness · 99 tokens

challenger

Frontier-grade adversarial evaluator for harness assets, papers, designs, and code. Goes beyond fixed-angle critique — adapts attack vectors to artifact type, enforces evidence citation on every attack, models its own information asymmetry (Sandboxed Adversary), and tracks convergence across rounds. Returns structured…

chrono-meta/forge-harness · 102 tokens

expert

Frontier-grade domain-authority evaluator. Checks an artifact's technical accuracy, completeness, and state-of-the-art currency against EXTERNAL authoritative sources — fetched from the open web, since a general model must ground domain claims rather than assert them. Top tier of the user-mastery spectrum (beginner →…

chrono-meta/forge-harness · 114 tokens

beginner

Frontier-grade first-contact standpoint evaluator. Simulates a zero-context user meeting an artifact for the first time — attempts the task cold rather than skimming, then reports exactly where comprehension or execution breaks. Lowest tier of the user-mastery spectrum (beginner → main-player → expert). Constructive…

chrono-meta/forge-harness · 117 tokens

main-player

Frontier-grade engaged-user standpoint evaluator. Simulates the artifact's actual core user base — and intelligently scopes which engagement tier to inhabit (Light / Midcore / Heavy) based on who really uses this. Middle tier of the user-mastery spectrum (beginner → main-player → expert). The Heavy sub-tier carries…

chrono-meta/forge-harness · 123 tokens