Planejador de Documentação
Identifique lacunas no site de documentação e produza um backlog priorizado.
Entradas
- Escopo: Área a ser avaliada — toda a documentação, uma seção específica ou uma área de funcionalidade. Padrão: toda.
- Sinais (opcional): Issues do GitHub, perguntas da comunidade, threads de suporte.
- Contexto competitivo (opcional): O que concorrentes documentam que nós não.
Processo
Passo 1: Inventariar a documentação atual
Leia site/src/config/navigation.yml para a árvore de navegação completa — esta é a fonte de navegação oficial do site Astro, carregada por site/astro.config.mjs via site/src/sidebar.ts. Faça glob em site/src/content/docs/**/*.{md,mdx} para todos os arquivos de conteúdo. Classifique cada um por tipo de conteúdo (tutorial, how-to, referência, explicação, misto) e área de cobertura (quickstart, ferramentas, agentes, multi-agente, implantação, etc.).
Passo 2: Identificar lacunas
Compare o inventário com:
- Superfície do SDK: Todas as funcionalidades principais estão documentadas? Funcionalidades sem páginas de documentação são lacunas.
- Completude Diataxis: Para cada área de funcionalidade, existe documentação em todos os quatro tipos? Uma funcionalidade com referência mas sem tutorial possui uma lacuna.
- Sinais da comunidade: Se o CLI do GitHub estiver disponível, puxe issues abertas rotuladas como "documentation" do repositório strands-agents/harness-sdk. Mapeie perguntas para documentação existente (pouco clara/difícil de encontrar) ou documentação ausente (lacuna de conteúdo).
- Comparação competitiva (se fornecida): O que LangChain, CrewAI, Anthropic e OpenAI documentam sobre funcionalidades equivalentes que nós não?
Passo 3: Priorizar
Atribua uma pontuação a cada lacuna com base no impacto para o desenvolvedor e no esforço:
- P0 (faça agora): Alto impacto, qualquer esforço. Quickstart, getting-started, conceitos principais.
- P1 (faça em breve): Médio impacto, baixo esforço. Guias how-to faltantes para tarefas comuns.
- P2 (planeje para): Médio impacto, alto esforço. Novos tutoriais, explicações arquiteturais.
- P3 (backlog): Baixo impacto. Cenários de nicho, documentação de casos extremos.
Passo 4: Produzir o backlog
Saída em markdown:
## Backlog de Documentação: [Escopo]
**Gerado em:** [data]
**Páginas inventariadas:** [contagem]
**Lacunas identificadas:** [contagem]
### P0: Faça Agora
- [ ] [Tarefa] — [tipo de conteúdo] — [página alvo] — [motivo]
### P1: Faça em Breve
- [ ] [Tarefa] — [tipo de conteúdo] — [página alvo] — [motivo]
### P2: Planeje para
- [ ] [Tarefa] — [tipo de conteúdo] — [página alvo] — [motivo]
### P3: Backlog
- [ ] [Tarefa] — [tipo de conteúdo] — [página alvo] — [motivo]
### Matriz de Cobertura
| Área de Funcionalidade | Tutorial | How-To | Referência | Explicação |
|---|---|---|---|---|
| Básico de agente | S | ~ | S | N |
| Ferramentas personalizadas | S | S | S | N |
| Multi-agente | ~ | N | S | ~ |
### Insights Baseados em Sinais
- [Tema dos sinais da comunidade mapeado para lacunas de documentação específicas]
O Que Essa Skill NÃO Faz
- Não escreve documentação (use docs-writer para isso)
- Não requer pipelines de sinais externos (funciona apenas com o inventário local)
- Não cria tarefas automaticamente em ferramentas externas