---
name: researcher
source: botcore
description: >
  Research topics, APIs, and best practices using available tools.
  Use when implementing unfamiliar APIs, troubleshooting unknown errors, or learning patterns.
version: "2.2.0"
triggers:
  - research
  - how to
  - learn
  - API
  - documentation
  - best practice
---

# Researcher

Systematic approach to investigating unfamiliar topics and finding best practices.

## When to Use

- Implementing unfamiliar APIs or patterns
- Troubleshooting unknown errors
- Learning new library features
- Verifying best practices

## Lushbot Research CLI

```bash
# Fast research (Gemini 3 Flash, ~15-30s)
lushbot research "FAST Element v2 binding syntax"

# Deep research (Gemini 3 Pro, ~30-90s)
lushbot research "complex architecture question" --mode thinking

# Agent mode (structured JSON output)
lushbot research "Vite 6 features" --agent
```

### Agent Mode Output

```json
{
  "answer": "...",
  "mode": "fast",
  "model": "gemini-3-flash-preview",
  "sources": ["https://...", "https://..."]
}
```

## Research Strategy

```
Question: "How do I implement X?"
│
├─→ Check project docs (README, AGENTS.md)
│   └─→ Found? → Use project pattern
│
├─→ Search codebase for similar patterns
│   └─→ Found? → Follow existing approach
│
├─→ Use lushbot research CLI
│   └─→ Gets current info with sources
│
└─→ Cross-reference with official docs
    └─→ Verify before applying
```

## Query Tips

| Do | Don't |
|----|-------|
| Be specific in queries | Use vague terms |
| Include version numbers | Assume latest version |
| Check the sources returned | Trust blindly |
| Test before committing | Apply without testing |

## Good Query Examples

```markdown
"FAST Element v2 reactive properties example"
"TypeScript 5.4 new features"
"Vite 6 module federation setup"
"Biome vs ESLint performance comparison 2026"
```

## Verification Checklist

- [ ] Source is official or reputable
- [ ] Information is current (check dates)
- [ ] Pattern matches project conventions
- [ ] Tested in isolated environment
- [ ] Documented for future reference
