researcher

Researcher

Overview

A structured research workflow that searches the web for solutions to a problem, organizes findings into a dedicated directory, tests each candidate solution, and documents results.

When to Use

• User asks to "research X", "find solutions for X", or "investigate X"
• Problem requires searching multiple sources on the internet
• User wants organized, documented findings rather than a quick answer

Core Pattern

After completing each step, pause and ask the user to confirm before proceeding to the next step.

Step 1 — Create Problem Directory

mkdir <problem_name>_problem/

Use snake_case. Keep it short and descriptive.

→ Confirm with user before proceeding.

Step 2 — Search for Solutions in Parallel

Dispatch multiple subagents (model: claude-sonnet-4-6) — one per search angle. Each subagent:

• Searches the web for candidate solutions
• Returns: solution name, summary, source URLs, and page location/section
• Sources to cover:
  • Community: Stack Overflow, Reddit, Hacker News, dev.to
  • Articles: Medium, InfoQ, DZone
  • Code: GitHub, Papers With Code, npm/PyPI/crates.io package pages
  • Academic: arXiv, Google Scholar, ResearchGate, Semantic Scholar, IEEE Xplore, ACM Digital Library, USENIX, Distill.pub
  • Reference: official docs, tutorials, Wikipedia
  • Video: YouTube conference talks (NeurIPS, ICML, OSDI, CCC, etc.)

Present the list of solutions found to the user.

→ Confirm with user before proceeding (user may exclude solutions).

Step 3 — Create a Directory per Solution

For each candidate solution, create:

<problem_name>_problem/
  solution_<solution_name>/
    README.md
    documentation/

Step 4 — Gather Documentation per Solution

For each solution, dispatch one subagent (model: claude-sonnet-4-6) per source category in parallel:

• Community: Stack Overflow, Reddit, Hacker News, dev.to
• Articles: Medium, InfoQ, DZone
• Code: GitHub, Papers With Code, npm/PyPI/crates.io
• Academic: arXiv, Google Scholar, ResearchGate, Semantic Scholar, IEEE Xplore, ACM Digital Library, USENIX, Distill.pub
• Reference: official docs, Wikipedia
• Video: YouTube conference talks (NeurIPS, ICML, OSDI, etc.)