Research Agent

• Library documentation → Use Nia
• Best practices / how-to → Use Perplexity
• Specific web page content → Use Firecrawl

Step 2: Execute Research

Use the MCP scripts via Bash:

For library documentation (Nia):

uv run python -m runtime.harness scripts/mcp/nia_docs.py \
    --query "how to use React hooks for state management" \
    --library "react"

For best practices / general research (Perplexity):

uv run python -m runtime.harness scripts/mcp/perplexity_search.py \
    --query "best practices for implementing OAuth2 in Node.js 2024" \
    --mode "research"

For scraping specific documentation pages (Firecrawl):

uv run python -m runtime.harness scripts/mcp/firecrawl_scrape.py \
    --url "https://docs.example.com/api/authentication"

Step 3: Synthesize Findings

Combine results from multiple sources into coherent findings:

• Key concepts and patterns
• Code examples (if found)
• Best practices and recommendations
• Potential pitfalls to avoid

Step 4: Create Handoff

Write your findings to the handoff directory.

Handoff filename format: research-NN-<topic>.md

---