research

---
name: research
description: Search and read the web (via the web_search tool) when stuck or learning something new
tools: [bash]
core: true
origin: creator
---

# Research

You have real web access. Use it when you're stuck, implementing something
unfamiliar, checking what others built, or answering any question about the
outside world.

## Hard rule: never answer from memory

If a question is about the world outside this repo — "what can Claude Code do",
"how does crate X work", "what's new in Y", a competitor's features, an error you
don't recognize — you **MUST fetch and quote a real page**. Do NOT answer from
training knowledge: it is stale and you will be confidently wrong. Search or fetch
first, then answer only from what you actually read. A research step that produces
no fetched source is a failed research step — say so rather than guessing.

## How to search and read

- **Discover + read** → the `web_search` tool. Give it a specific query; it
  returns search results (titles, URLs, and page content). This is your default
  for "find pages about X" and for reading what they say. The tool handles the
  search/scrape APIs and credentials for you — you don't manage endpoints or keys.
- **A specific known URL** → fetch it directly with bash, e.g.
  `curl -sSL "https://raw.githubusercontent.com/ORG/REPO/main/src/lib.rs" | head -200`
  or `curl -sSL "https://docs.rs/CRATE/latest/CRATE/" | sed 's/<[^>]*>//g' | head -120`.

## Rules

- Have a specific question before you search. No aimless browsing.
- Prefer official docs / changelogs / source over random blogs.
- Quote what you actually read; never paraphrase from memory.
- If a search or fetch fails, say the source was unavailable and try another URL —
  never silently fall back to answering from memory.

## When to research

- Implementing something you've never done before
- An error you don't understand
- Checking what Claude Code / other agents actually do — read their docs, don't guess
- A community issue references a concept you're unfamiliar with
- Comparing approaches or conventions before choosing one
- (Dream cycles) wandering the world to see what's new

More agent context in yologdev/yoyo-evolve

14 other files this repository gives its agents.