Descoberta de Documentação via Scripts
Visão Geral
Descoberta de documentação baseada em scripts usando o padrão llms.txt.
Execute scripts para lidar com todo o fluxo de trabalho — sem necessidade de construção manual de URLs.
Fluxo de Trabalho Principal
SEMPRE execute os scripts nesta ordem:
# 1. DETECTAR o tipo de consulta (específica de tópico vs. geral)
node scripts/detect-topic.js "<consulta do usuário>"
# 2. BUSCAR documentação usando a saída do script
node scripts/fetch-docs.js "<consulta do usuário>"
# 3. ANALISAR os resultados (se múltiplas URLs forem retornadas)
cat llms.txt | node scripts/analyze-llms-txt.js -
Os scripts lidam automaticamente com construção de URLs, cadeias de fallback e tratamento de erros.
Scripts
detect-topic.js — Classifica o tipo de consulta
- Identifica consultas específicas de tópico vs. gerais
- Extrai nome da biblioteca + palavra-chave do tópico
- Retorna JSON:
{topic, library, isTopicSpecific} - Execução com zero tokens
fetch-docs.js — Recupera documentação
- Constrói URLs do context7.com automaticamente
- Lida com fallback: tópico → geral → erro
- Gera conteúdo de llms.txt ou mensagem de erro
- Execução com zero tokens
analyze-llms-txt.js — Processa llms.txt
- Categoriza URLs (críticas/importantes/suplementares)
- Recomenda distribuição de agentes (1 agente, 3 agentes, 7 agentes, em fases)
- Retorna JSON com estratégia
- Execução com zero tokens
Referências de Fluxos de Trabalho
Busca Específica de Tópico — Caminho mais rápido (10 a 15 segundos)
Busca Geral de Biblioteca — Cobertura abrangente (30 a 60 segundos)
Análise de Repositório — Estratégia de fallback
Referências
context7-patterns.md — Padrões de URL, repositórios conhecidos
errors.md — Tratamento de erros, estratégias de fallback
advanced.md — Casos extremos, versionamento, multilíngue
Princípios de Execução
- Scripts primeiro — Execute scripts em vez de construção manual de URLs
- Sobrecarga zero de tokens — Scripts são executados sem carregar contexto
- Fallback automático — Scripts lidam com as cadeias tópico → geral → erro
- Revelação progressiva — Carregue fluxos de trabalho/referências apenas quando necessário
- Distribuição de agentes — Scripts recomendam estratégia paralela de agentes
Início Rápido
Consulta de tópico: "Como usar o date picker no shadcn?"
node scripts/detect-topic.js "<consulta>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<consulta>" # → 2 a 3 URLs
# Leia as URLs com WebFetch
Consulta geral: "Documentação do 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}
# Distribua agentes conforme recomendação
Ambiente
Os scripts carregam .env: process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
Veja .env.example para opções de configuração.