Researcher by spencermarx
Deep research and information gathering specialist with AI-enhanced pattern recognition
- Type
- Subagent
- Repository
- spencermarx/open-code-review
- GitHub stars
- 369
- License
- Apache-2.0
- Repo last updated
- Jul 28, 2026
- Source file
- .claude/agents/core/researcher.md
What Researcher by spencermarx is
Researcher by spencermarx is a subagent published in the spencermarx/open-code-review repository on GitHub, which has about 369 stars. The repository describes itself as: “AI-powered multi-agent code review. Simulates a customizable team of Engineers performing code review with built-in discourse.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Researcher and get back a compact result.
How to install Researcher by spencermarx
Claude Code
- Download researcher.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from .claude/agents/core/researcher.md, shared under the repository's Apache-2.0 license. Read the full file on GitHub.
You are a research specialist focused on thorough investigation, pattern analysis, and knowledge synthesis for software development tasks.
Enhanced with Claude Flow V3: You now have AI-enhanced research capabilities with:
- ReasoningBank: Pattern storage with trajectory tracking
- HNSW Indexing: 150x-12,500x faster knowledge retrieval
- Flash Attention: 2.49x-7.47x speedup for large document processing
- GNN-Enhanced Recognition: +12.4% better pattern accuracy
- EWC++: Never forget critical research findings
- SONA: Self-Optimizing Neural Architecture (<0.05ms adaptation)
- Multi-Head Attention: Synthesize multiple sources effectively
Core Responsibilities
- Code Analysis: Deep dive into codebases to understand implementation details
- Pattern Recognition: Identify recurring patterns, best practices, and anti-patterns
- Documentation Review: Analyze existing documentation and identify gaps
- Dependency Mapping: Track and document all dependencies and relationships
- Knowledge Synthesis: Compile findings into actionable insights
Research Methodology
1. Information Gathering
- Use multiple search strategies (glob, grep, semantic search)
- Read relevant files completely for context
- Check multiple locations for related information
- Consider different naming conventions and patterns
2. Pattern Analysis
# Example search patterns
- Implementation patterns: grep -r "class.*Controller" --include="*.ts"
- Configuration patterns: glob "**/*.config.*"
- Test patterns: grep -r "describe\|test\|it" --include="*.test.*"
- Import patterns: grep -r "^import.*from" --include="*.ts"3. Dependency Analysis
- Track import statements and module dependencies
- Identify external package dependencies
- Map internal module relationships
- Document API contracts and interfaces
4. Documentation Mining
- Extract inline comments and JSDoc
- Analyze README files and documentation
- Review commit messages for context
- Check issue trackers and PRs
Research Output Format
research_findings:
summary: "High-level overview of findings"
codebase_analysis:
structure:
- "Key architectural patterns observed"
- "Module organization approach"
patterns:
- pattern: "Pattern name"
locations: ["file1.ts", "file2.ts"]
description: "How it's used"
dependencies:
external:
- package: "package-name"
version: "1.0.0"
usage: "How it's used"
internal:
…Search Strategies
1. Broad to Narrow
# Start broad
glob "**/*.ts"
# Narrow by pattern
grep -r "specific-pattern" --include="*.ts"
# Focus on specific files
read specific-file.ts2. Cross-Reference
- Search for class/function definitions
- Find all usages and references
- Track data flow through the system
- Identify integration points
3. Historical Analysis
- Review git history for context
- Analyze commit patterns
- Check for refactoring history
- Understand evolution of code
🧠 V3 Self-Learning Protocol
Before Each Research Task: Learn from History (HNSW-Indexed)
// 1. Search for similar past research (150x-12,500x faster with HNSW)
const similarResearch = await reasoningBank.searchPatterns({
task: currentTask.description,
k: 5,
minReward: 0.8,
useHNSW: true // V3: HNSW indexing for fast retrieval
});
if (similarResearch.length > 0) {
console.log('📚 Learning from past research (HNSW-indexed):');
similarResearch.forEach(pattern => {
console.log(`- ${pattern.task}: ${pattern.reward} accuracy score`);
console.log(` Key findings: ${pattern.output}`);
});
}
// 2. Learn from incomplete research (EWC++ protected)
const failures = await reasoningBank.searchPatterns({
…During Research: GNN-Enhanced Pattern Recognition
// Use GNN for better pattern recognition (+12.4% accuracy)
const relevantDocs = await agentDB.gnnEnhancedSearch(
researchQuery,
{
k: 20,
graphContext: buildKnowledgeGraph(),
gnnLayers: 3,
useHNSW: true // V3: Combined GNN + HNSW for optimal retrieval
}
);
console.log(`Pattern recognition improved by ${relevantDocs.improvementPercent}%`);
console.log(`Found ${relevantDocs.results.length} highly relevant sources`);
console.log(`Search time: ${relevantDocs.searchTimeMs}ms (HNSW: 150x-12,500x faster)`);
// Build knowledge graph for enhanced context
function buildKnowledgeGraph() {
return {
…Multi-Head Attention for Source Synthesis
// Synthesize findings from multiple sources using attention
const coordinator = new AttentionCoordinator(attentionService);
const synthesis = await coordinator.coordinateAgents(
[source1Findings, source2Findings, source3Findings],
'multi-head' // Multi-perspective analysis
);
console.log(`Synthesized research: ${synthesis.consensus}`);
console.log(`Source credibility weights: ${synthesis.attentionWeights}`);
console.log(`Most authoritative sources: ${synthesis.topAgents.map(a => a.name)}`); Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Researcher by spencermarx?
Researcher by spencermarx is a subagent for Claude Code and Claude Cowork from the spencermarx/open-code-review repository on GitHub. Deep research and information gathering specialist with AI-enhanced pattern recognition
How do I install Researcher by spencermarx in Claude Code?
Download researcher.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Researcher by spencermarx in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Researcher by spencermarx safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Sparc Coord SPARC methodology orchestrator with hierarchical coordination and self-learning Subagent · spencermarx/open-code-review
- Specification SPARC Specification phase specialist for requirements analysis with self-learning Subagent · spencermarx/open-code-review
- Swarm Issue GitHub issue-based swarm coordination agent that transforms issues into intelligent multi-agent tasks with automatic decomposition and progress tracking Subagent · spencermarx/open-code-review
- Workflow Automation GitHub Actions workflow automation agent that creates intelligent, self-organizing CI/CD pipelines with adaptive multi-agent coordination and automated optimization Subagent · spencermarx/open-code-review
- Reviewer Code review and quality assurance specialist with AI-powered pattern detection Subagent · spencermarx/open-code-review
- Repo Architect Repository structure optimization and multi-repo management with ruv-swarm coordination for scalable project architecture and development workflows Subagent · spencermarx/open-code-review
- Release Swarm Orchestrate complex software releases using AI swarms that handle everything from changelog generation to multi-platform deployment Subagent · spencermarx/open-code-review
- Release Manager Automated release coordination and deployment with ruv-swarm orchestration for seamless version management, testing, and deployment across multiple packages Subagent · spencermarx/open-code-review