Descubrimiento de Documentación mediante Scripts
Resumen
Descubrimiento de documentación basado en scripts usando el estándar llms.txt.
Ejecuta scripts para manejar todo el flujo de trabajo, sin necesidad de construir URLs manualmente.
Flujo de Trabajo Principal
SIEMPRE ejecuta los scripts en este orden:
# 1. DETECTAR el 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 automáticamente la construcción de URLs, cadenas de fallback y el manejo de errores.
Scripts
detect-topic.js - Clasificar el tipo de consulta
- Identifica consultas específicas de un tema vs. generales
- Extrae el nombre de la librería + la palabra clave del tema
- Devuelve JSON:
{topic, library, isTopicSpecific} - Ejecución de cero tokens
fetch-docs.js - Recuperar documentación
- Construye automáticamente las URLs de context7.com
- Maneja el fallback: tema → general → error
- Muestra el contenido de llms.txt o un mensaje de error
- Ejecución de cero tokens
analyze-llms-txt.js - Procesar llms.txt
- Categoriza las URLs (críticas/importantes/suplementarias)
- Recomienda la distribución de agentes (1 agente, 3 agentes, 7 agentes, por fases)
- Devuelve JSON con la estrategia
- Ejecución de cero tokens
Referencias de Flujo de Trabajo
Búsqueda Específica de un Tema - Ruta más rápida (10-15s)
Búsqueda General de Librería - Cobertura completa (30-60s)
Análisis de Repositorio - Estrategia de fallback
Referencias
patrones-context7.md - Patrones de URL, repositorios conocidos
errores.md - Manejo de errores, estrategias de fallback
avanzado.md - Casos límite, versionado, multi-lenguaje
Principios de Ejecución
- Primero los scripts - Ejecuta scripts en lugar de construir URLs manualmente
- Cero sobrecarga de tokens - Los scripts se ejecutan sin cargar contexto
- Fallback automático - Los scripts manejan las 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 de tema: "¿Cómo uso el selector de fecha 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 la recomendación
Entorno
Los scripts cargan .env: process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
Consulta .env.example para las opciones de configuración.