ContentComposable · Yields to: Process, Voice, Density

Researcher

Deep web research. Diverse sources, cross-referencing, synthesis, and structured output.

When to Use

• User says "research X", "find info about Y", "what's the latest on Z"
• Need current information about tech, libraries, frameworks
• Gathering context before writing or planning

Triggers

"research X", "find info about Y", "what's the latest on Z",
"look up", "investigate", "gather context on"

Examples

Example 1

Research a technical topic

Deep dive into a specific technology.

/researcher what's the state of Mixture of Experts in 2026?

The agent searches multiple sources:
- Latest papers (Switch Transformer, GShard, DeepSeek-MoE)
- Blog posts from labs (Google, Meta, Mistral)
- GitHub repos with implementations
- Benchmark comparisons

Output: structured summary with citations, key findings,
open problems, and recommended reading.

Example 2

Research then document

Research a library, then write docs for it.

/researcher + /documenter

Researcher surveys how similar libraries handle their API
design, error messages, and documentation. Documenter
applies these patterns to write docs that follow industry
conventions.

Example 3

Research then plan

Gather context before making architecture decisions.

/researcher + /plan

Researcher compares CRDT vs OT vs hybrid approaches for
real-time collaboration. Planner uses the findings to
write an informed architecture decision record with
proper trade-off analysis.

Output Format

All research reports are saved as visual HTML dashboards — not plain text.

Folder Structure

~/researcher/<topic_slug>_<DD>_<MONTH>_<YYYY>/
├── index.html          # Main report (entry point)
├── sources.html        # Full source list + methodology
├── deep-dive.html      # (optional) Extended analysis
├── comparison.html     # (optional) Feature matrices
├── assets/
│   ├── style.css       # Dark-theme stylesheet
│   └── charts.js       # Chart.js visualizations
└── data/
    └── findings.json   # Machine-readable backup

Report Types

Goal	Generated Files	Visual Elements
Context Feed	index.html only	Stat cards, link grid, gotcha callouts
Overview	index.html + sources.html	Feature cards, ecosystem diagram
Deep Dive	index.html + deep-dive.html + sources.html	Benchmark charts, architecture diagrams
Comparison	index.html + comparison.html + sources.html	Feature matrix, radar charts, recommendation cards
Hypothesis Test	index.html + sources.html	Evidence badges, confidence meter
Diagnostic	index.html only	Symptom→cause flowchart, solution cards

Visual Design

• Dark theme (#0d1117 background, light text)
• Source type badges — blue (official), green (community), red (Chinese), purple (academic), yellow (blogs), orange (video)
• Charts — source distribution (doughnut), benchmarks (bar), feature comparison (radar)
• Stat cards — sources consulted, source types, confidence, freshness score
• Collapsible sections for extended analysis and methodology
• Self-contained — Chart.js (CDN) is the only external dependency

Source Evaluation

Evaluates sources on:

• Authority — who wrote it, what's their expertise
• Currency — when was it published/updated
• Accuracy — can claims be verified
• Purpose — why was it written