Descubrimiento de Documentación mediante Scripts
Resumen
Descubrimiento de documentación basado en scripts utilizando el estándar llms.txt.
Ejecuta scripts para manejar todo el flujo de trabajo: no es necesario construir URLs manualmente.
Flujo de trabajo principal
SIEMPRE ejecuta los scripts en este orden:
# 1. DETECTAR tipo de consulta (específica de un tema vs. general)
node scripts/detect-topic.js "<consulta del usuario>"
# 2. OBTENER documentación usando la salida del script
node scripts/fetch-docs.js "<consulta del usuario>"
# 3. ANALIZAR resultados (si se devuelven múltiples URLs)
cat llms.txt | node scripts/analyze-llms-txt.js -
Los scripts manejan la construcción de URLs, cadenas de respaldo y gestión de errores automáticamente.
Scripts
detect-topic.js - Clasificar tipo de consulta
- Identifica consultas específicas de un tema vs. generales
- Extrae el nombre de la librería + palabra clave del tema
- Devuelve JSON:
{topic, library, isTopicSpecific} - Ejecución sin consumo de tokens
fetch-docs.js - Recuperar documentación
- Construye URLs de context7.com automáticamente
- Maneja respaldo: tema → general → error
- Genera contenido llms.txt o mensaje de error
- Ejecución sin consumo de tokens
analyze-llms-txt.js - Procesar llms.txt
- Categoriza URLs (críticas/importantes/suplementarias)
- Recomienda distribución de agentes (1 agente, 3 agentes, 7 agentes, por fases)
- Devuelve JSON con la estrategia
- Ejecución sin consumo de tokens
Referencias de Flujo de Trabajo
Búsqueda Específica de Tema - Ruta más rápida (10-15 s)
Búsqueda General de Librería - Cobertura completa (30-60 s)
Análisis de Repositorio - Estrategia de respaldo
Referencias
patrones-context7.md - Patrones de URL, repositorios conocidos
errores.md - Gestión de errores, estrategias de respaldo
avanzado.md - Casos extremos, versionado, multilingüe
Principios de Ejecución
- Primero los scripts - Ejecuta scripts en lugar de construir URLs manualmente
- Sin sobrecarga de tokens - Los scripts se ejecutan sin cargar contexto
- Respaldo automático - Los scripts manejan cadenas tema → general → error
- Divulgación progresiva - Carga flujos de trabajo/referencias solo cuando sea necesario
- Distribución de agentes - Los scripts recomiendan una estrategia de agentes en paralelo
Inicio rápido
Consulta específica de tema: "¿Cómo uso el selector de fechas en shadcn?"
node scripts/detect-topic.js "<consulta>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<consulta>" # → 2-3 URLs
# Lee las URLs con WebFetch
Consulta general: "Documentación para Next.js"
node scripts/detect-topic.js "<consulta>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<consulta>" # → 8+ URLs
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# Despliega agentes según recomendación
Entorno
Los scripts cargan .env: process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
Consulta .env.example para opciones de configuración.