General Library Documentation Search

Use when: User asks about entire library/framework

Speed: ⚡⚡ Moderate (30-60s) Token usage: 🟡 Medium Accuracy: 📚 Comprehensive

Trigger Patterns

"Documentation for [LIBRARY]"
"[LIBRARY] getting started"
"How to use [LIBRARY]"
"[LIBRARY] API reference"

Workflow (Script-First)

# STEP 1: Execute detect-topic.js script
node scripts/detect-topic.js "<user query>"
# Returns: {"isTopicSpecific": false} for general queries

# STEP 2: Execute fetch-docs.js script (handles URL construction)
node scripts/fetch-docs.js "<user query>"
# Script constructs context7.com URL automatically
# Script handles GitHub/website URL patterns
# Returns: llms.txt content with 5-20+ URLs

# STEP 3: Execute analyze-llms-txt.js script
cat llms.txt | node scripts/analyze-llms-txt.js -
# Groups URLs: critical, important, supplementary
# Recommends: agent distribution strategy
# Returns: {totalUrls, grouped, distribution}

# STEP 4: Deploy agents based on script recommendation
# - 1-3 URLs: Single agent or direct WebFetch
# - 4-10 URLs: Deploy 3-5 Explorer agents
# - 11+ URLs: Deploy 7 agents or phased approach

# STEP 5: Aggregate and present
# Synthesize findings: installation, concepts, API, examples

Examples

Astro framework:

# Execute scripts (no manual URL construction)
node scripts/detect-topic.js "Documentation for Astro"
# {"isTopicSpecific": false}

node scripts/fetch-docs.js "Documentation for Astro"
# Script fetches: context7.com/withastro/astro/llms.txt
# Returns: llms.txt with 8 URLs

node scripts/analyze-llms-txt.js < llms.txt
# {totalUrls: 8, distribution: "3-agents", grouped: {...}}

# Deploy 3 Explorer agents as recommended:
# Agent 1: Getting started, installation, setup
# Agent 2: Core concepts, components, layouts
# Agent 3: Configuration, API reference

# Aggregate and present comprehensive report

Agent Distribution

1-3 URLs: Single agent 4-10 URLs: 3-5 agents (2-3 URLs each) 11-20 URLs: 7 agents (balanced) 21+ URLs: Two-phase (critical first, then important)

Known Libraries

Next.js: vercel/next.js
Astro: withastro/astro
Remix: remix-run/remix
shadcn/ui: shadcn-ui/ui
Better Auth: better-auth/better-auth

Fallback

Scripts handle fallback automatically:

fetch-docs.js tries context7.com
If 404, script suggests WebSearch for llms.txt
If still unavailable: Repository Analysis

2.4 KiB Raw Blame History