O que search-drill-iterate faz?
Pesquisa profunda iterativa via subagentes. Cada iteração constrói sobre a anterior, analisando as seções estruturadas do documento e mirando nas lacunas de maior valor.
Quando usar
- Pesquisa profunda / completa / abrangente sobre um tópico
- Construir ou melhorar um documento de pesquisa
- Executar passes adicionais em um arquivo de pesquisa existente
Entradas
| Entrada | Obrigatório | Descrição |
|---|
| Tópico | Sim | O que pesquisar |
| Doc. de pesquisa | Não | Caminho para documento existente (criado se ausente) |
| Iterações | Sim | Número de passes a executar |
Como funciona
- O orquestrador recebe as entradas e preenche o template em
templates/pass.md
- Para cada iteração, um subagente é criado com o template preenchido
- O subagente lê o documento, analisa as seções do esquema, pesquisa lacunas e atualiza o documento
- O próximo subagente retoma de onde o anterior parou — o documento é a única entrega
Esquema do documento
Todo documento de pesquisa segue este esquema. O template do subagente ensina cada agente a analisá-lo e atualizá-lo.
---
title: ...
topic: ...
created: ...
last-updated: ...
pass: N
status: rascunho | completo
---
## Descobertas
O conteúdo da pesquisa organizado por subtópico. A saída principal. Os subagentes
adicionam, expandem e refinam — nunca excluem descobertas anteriores.
## Caminhos Investigados
Registro do que foi pesquisado e o resultado. Os subagentes verificam isso antes
de cada pesquisa para evitar re-pesquisar.
- `<consulta ou abordagem>` → <resultado>
## Registro de Decisões
Escolhas feitas durante a pesquisa e sua justificativa. Ajuda passes futuros a
entender por que coisas foram priorizadas ou despriorizadas.
- [pass N] <decisão> — <justificativa>
## Perguntas Abertas
Lacunas a preencher. Cada entrada tem contexto sobre o que foi tentado. Lacunas
genuinamente sem resposta são marcadas como INPREENCHEVÉL: <motivo>.
Por que essas seções
| Seção | Propósito |
|---|
| Descobertas | A pesquisa real — o que você leria |
| Caminhos Investigados | Evita re-pesquisa — o maior desperdício de rodadas |
| Registro de Decisões | Preserva o raciocínio para que passes futuros possam fazer compensações informadas |
| Perguntas Abertas | A entrega — diz ao próximo passe exatamente onde focar |
Placeholders no template
| Placeholder | Descrição |
|---|
<ARQUIVO_DE_PESQUISA> | Caminho absoluto para o documento de pesquisa (criado se não existir) |
<TOPICO> | Tópico de pesquisa em linguagem simples |
<ESCOPO> | O que está dentro do escopo |
<EXCLUSOES> | O que está fora do escopo |
<PERGUNTAS_DE_PESQUISA> | Perguntas priorizadas a investigar |
Arquivos
SKILL.md este arquivo
templates/pass.md template do prompt do subagente (um template, todas as iterações)
docs/anti-duplication.md regras que evitam re-pesquisa
docs/logging-markers.md marcadores estruturados para auditoria e calibração
examples/example-output.md exemplo mostrando o esquema do documento na prática