Estrutura de Pesquisa Setorial
Esta habilidade é um framework para pesquisa setorial longa e redação publicável. Ela não inclui raspadores, fontes de dados ou modelos de relatório fixos; em vez disso, prescreve convenções para como um agente de IA persiste o estado, separa evidências da prosa, evita desvios de tópico, agenda revisões e transforma um amplo backend de pesquisa em um artigo ou relatório limpo voltado para leitores.
1. Motivação
Agentes de pesquisa longa tendem a falhar de cinco maneiras recorrentes:
- Sobreajuste de tópico: um método destilado de um projeto é tratado falsamente como o modelo universal.
- Vazamento de processo: o artigo final parece um registro de trabalho, com frases como "o usuário forneceu" ou "o material mostra".
- Desvio de evidências: fontes, alegações, incertezas e julgamento do autor se fundem em um argumento indiferenciado.
- Falsa conclusão: um marco parcial é relatado como conclusão final antes de a cobertura, revisão e revisão de qualidade para leitores serem concluídas.
- Colapso de profundidade: um relatório satisfaz contagens de fontes e listas de verificação de cobertura, mas é muito curto, comprimido ou raso para a profundidade de pesquisa esperada pelo usuário.
Cada mecanismo neste framework tem como alvo uma dessas falhas.
2. Contrato de Escopo
Esta habilidade é um framework de execução para produzir entregas substanciais de pesquisa. Não é um sistema teórico, arquitetura de produto ou linguagem de modelagem universal.
Mantenha dentro desta habilidade:
- Processo: calibração de escopo de pesquisa, execução em estágios, processamento de fontes, redação, revisão, revisão e limpeza final.
- Estado: estado da tarefa, progresso, descobertas, suposições, decisões e rastreamento de direção.
- Auditoria: verificações de fonte, alegação, incerteza, cobertura, profundidade e qualidade para leitores.
Mantenha fora desta habilidade, a menos que o usuário peça explicitamente um projeto separado de design de sistema:
- Ontologias de domínio, taxonomias universais ou linguagens de modelagem generalizadas.
- Representações intermediárias, sistemas de pontuação, embeddings, grafos de conhecimento ou mecanismos de classificação.
- Dashboards, CLIs, bancos de dados, pipelines de automação ou arquitetura de produto.
- Manifestos de metodologia que não melhoram diretamente a entrega atual de pesquisa.
Se uma tarefa começar a desviar para as camadas excluídas, preserve o caminho atual da entrega, registre a ideia como uma extensão futura e não expanda o fluxo de trabalho.
3. Restrições Comportamentais
- Entrega primeiro: se a saída solicitada for um artigo ou relatório, não desvie para design de sistema, design de prompt ou exposição de fluxo de trabalho.
- Portão do briefing de pesquisa antes da coleta: faça um lote compacto de esclarecimentos quando informações críticas para decisão estiverem faltando.
- Estado antes da escala: para tarefas longas, escreva o estado da tarefa em arquivos antes de expandir a coleta de fontes.
- Evidência não é prosa: registros, logs, rótulos de auditoria e falhas de acesso ficam nos bastidores, a menos que o usuário solicite um apêndice de auditoria.
- Orçamento de profundidade antes da redação: registre a profundidade esperada, a faixa aproximada de tamanho, o plano de expansão por unidade e o que "muito curto" significaria para esta tarefa.
- Execução em estágios: planeje, colete, analise, redija, revise, revise e atualize o estado antes de passar para a próxima unidade.
- Progresso por seção: escreva trabalhos complexos por seção, empresa, caso, período ou argumento; não gere o relatório inteiro em uma passada.
- Apenas lentes opcionais: análise de enquadramento/categoria, análise horizontal-vertical, análise de capital e análise de adoção são ferramentas, não estrutura padrão.
- Revisão fecha o ciclo: cada descoberta de auditoria deve se tornar uma ação de revisão, uma alegação rebaixada ou uma limitação explícita.
- Revisão do leitor por último: melhore a legibilidade somente depois que as verificações factuais, de cobertura, estrutura e profundidade estiverem estáveis.
4. Arquitetura
Agente Principal
possui tese, estrutura, julgamento final
Backend de Pesquisa Frontend de Publicação
arquivos de estado tese / seções
registro de fontes mecanismos / síntese
registro de alegações contra-evidências
lista de incertezas referências voltadas para o leitor
logs de revisão limpeza final da prosa
Subagentes podem inspecionar ou desafiar partes delimitadas do backend, mas o agente principal possui o argumento e a prosa final.
5. Arquivos de Estado
Para trabalhos substanciais, crie:
{tarefa}/state/
task_spec.md # objetivo, leitor, saída, escopo, profundidade, padrão de evidência, suposições
progress.json # estágio, unidades concluídas, problemas abertos, stale_count
findings.jsonl # descobertas e julgamentos somente em apêndice
directions_tried.json # direções já tentadas
iteration_log.jsonl # resumos de estágio
{tarefa}/logs/
work.jsonl # decisões de execução
review.jsonl # descobertas de revisão e correções encaminhadas
{tarefa}/data/
source_registry.csv
claims_registry.csv
uncertainty_registry.csv
Use arquivos de estado para se recuperar após perda de contexto. Não confie no histórico de chat como a única memória.
Protocolo de Recuperação de Contexto
Ao retomar após perda de contexto, reinício de sessão ou transferência:
- Leia
state/task_spec.mdpara objetivo, escopo, leitor, saída, profundidade, padrão de evidência e suposições. - Leia
state/progress.jsonpara o estágio atual, unidades concluídas, problemas abertos, stale_count e próxima ação. - Leia as entradas mais recentes em
state/findings.jsonlestate/iteration_log.jsonlpara recuperar a direção recente. - Leia
state/directions_tried.jsonpara evitar repetir caminhos falhos ou esgotados. - Retome a partir da etapa correspondente no loop operacional.
Não re-execute estágios concluídos. Não re-pergunte o briefing de pesquisa se task_spec.md já registra as respostas.
6. Portão do Briefing de Pesquisa
Antes da coleta, decida se a solicitação contém informações críticas para decisão suficientes. Caso contrário, faça um lote compacto de perguntas antes de começar. O lote deve geralmente conter de 3 a 7 perguntas e deve cobrir o comprimento ou profundidade esperados quando estiver faltando.
Pergunte apenas por informações críticas ausentes:
- objeto de pesquisa e limites de escopo
- leitor-alvo e contexto de decisão
- formato de saída, idioma e contexto de publicação
- profundidade esperada, faixa aproximada de tamanho ou nível de profundidade
- unidades obrigatórias, exclusões e áreas prioritárias
- fontes ou materiais necessários, exclusões de fontes e padrão de evidência
- período de tempo, geografia, prazo final e se gráficos/tabelas são esperados
Se o usuário já forneceu contexto suficiente, não faça perguntas rituais. Prossiga, registre suposições em task_spec.md e marque detalhes não críticos não resolvidos como suposições ou incertezas.
Se detalhes críticos permanecerem sem resposta após um lote de esclarecimento, faça suposições conservadoras, registre-as e comece com um Estágio 1 delimitado, em vez de estagnar.
7. Loop Operacional
Para cada estágio:
- Execute o portão do briefing de pesquisa, depois planeje o escopo, entradas, saída e critérios de conclusão.
- Colete ou processe apenas as fontes necessárias para aquele estágio.
- Converta fontes em alegações, incertezas e notas de análise.
- Redija uma seção ou unidade delimitada.
- Revise a seção quanto a evidências, cobertura, estrutura, ceticismo e prosa.
- Revise a seção e os registros.
- Atualize o progresso e defina o próximo estágio.
Se um ciclo não adicionar novas evidências, casos, contraexemplos, frameworks ou julgamentos, incremente stale_count. Se stale_count >= 2, mude o ângulo estrutural em vez de apenas pesquisar mais.
Para entregas longas, não use contagem de fontes, contagem de alegações, contagem de links ou tamanho de arquivo como substitutos de conclusão. Eles são sinais de saúde do backend, não prova de que o relatório final tem profundidade suficiente. Antes da montagem final, compare o rascunho com o orçamento de profundidade e expanda unidades finas antes da revisão do leitor.
8. Disciplina de Fontes e Alegações
Classifique as fontes pelo que elas podem provar:
- materiais oficiais mostram posição declarada, intenção, superfície do produto ou política formal
- dados primários apoiam alegações mensuráveis quando as definições e os métodos de coleta são claros
- materiais de especialistas explicam raciocínio, contexto e interpretação
- materiais de mídia mostram enquadramento público, mas precisam de corroboração para fatos concretos
- evidências de usuários/comunidade mostram recepção, mas não são automaticamente representativas
- contra-evidências limitam, enfraquecem ou falsificam a alegação principal
Classifique as alegações separadamente:
- fato verificado
- alegação de fonte
- interpretação
- julgamento do autor
- especulação
Toda alegação importante deve ter um limite de confiança. Não transforme RP de empresa, esperanças de investidores ou amplificação da mídia em fato.
9. Agendamento de Lentes de Análise
Escolha a lente que se adapta à pergunta de pesquisa:
- análise de enquadramento/categoria: posicionamento, legitimidade, criação de categoria, significado público e tradução na mídia
- análise horizontal-vertical: profundidade da linha do tempo mais comparação atual de concorrentes/substitutos
- análise de adoção: comportamento do usuário, mudança no fluxo de trabalho, substituição, atrito
- análise de capital: preço, receita, avaliação, financiamento, estrutura de custos, margens
- análise de organização/talento: modelo operacional, contratações, liderança, fluxo de talentos
- análise de política/legitimidade: regulação, conformidade, confiança, pressão geopolítica ou institucional
- análise de contra-caso: explicação alternativa mais forte e modos de falha
Escolha uma lente primária e no máximo duas lentes secundárias, a menos que o usuário solicite explicitamente um relatório multimétodo.
Leia references/optional-analysis-lenses.md ao escolher lentes. Leia references/horizontal-vertical-analysis.md somente depois que essa lente tiver sido selecionada.
10. Agendamento de Subagentes
Use subagentes apenas para trabalho delimitado:
- mapeamento de requisitos
- descoberta de fontes para regiões, atores ou classes de fonte separados
- verificação da cadeia de evidências
- auditoria de cobertura
- revisão cética
- revisão de estrutura
- revisão de qualidade para leitores após o rascunho estar estável
Um prompt de subagente deve incluir objetivo, arquivos ou seções a inspecionar, formato de saída, critérios de APROVADO/REPROVADO e limites. Subagentes não devem reescrever o relatório inteiro ou possuir a tese.
Leia references/subagents-and-review-loop.md antes de delegar.
11. Finalização
O artigo ou relatório final deve conter apenas material voltado para o leitor:
- insights com a conclusão primeiro, quando útil
- nota de escopo
- seções analíticas organizadas por argumento, caso, período ou mecanismo
- síntese entre unidades
- contra-evidências e incertezas expressas de forma limpa
- implicações
- apêndice de referências voltado para o leitor
Remova:
- IDs de fonte visíveis
- rótulos de auditoria
- caminhos de arquivo
- "o usuário forneceu"
- "o material mostra"
- "esta fonte complementa"
- "esta seção passou na auditoria"
- ressalvas excessivas que enfraquecem em vez de esclarecer o julgamento
12. Validação e Limites
Antes de declarar conclusão:
- O portão do briefing de pesquisa foi concluído ou as suposições foram registradas.
- A cobertura necessária está completa ou as limitações são explícitas.
- As principais alegações remontam a fontes ou registros de incerteza.
- Fatos, alegações de fonte, interpretações e julgamentos do autor permanecem distintos.
- As contra-evidências foram abordadas.
- O rascunho atende ao orçamento de profundidade ou explica explicitamente por que a profundidade esperada original não é mais apropriada.
- A revisão do leitor foi realizada após a revisão factual, de cobertura, estrutura e profundidade.
- A prosa final soa como um relatório de autor, não como um relatório de processo de agente.
Limites:
- O framework reduz erros de citação e evidência; não os elimina.
- A revisão do subagente é uma verificação, não uma verdade externa.
- Lentes opcionais podem sobreajustar o relatório se usadas mecanicamente.
- Arquivos de estado ajudam na recuperação, mas só funcionam se atualizados durante a tarefa, não reconstruídos após o fato.
13. Barreiras de Execução
Use estas barreiras para evitar loops, coleta excessiva e desvio de escopo:
- Coleta de fontes: se três buscas ou passagens de fonte consecutivas não adicionarem evidências relevantes, pare de coletar nessa direção, atualize
directions_tried.jsone redija ou mude de direção. - Extração de alegações: se
source_registry.csvcrescer enquantoclaims_registry.csvpermanece enxuto, pause a coleta e extraia alegações antes de reunir mais fontes. - Loop de revisão: limite os ciclos completos de revisão-revisão a dois por seção, a menos que o usuário solicite mais; registre problemas não resolvidos como limitações ou tarefas de acompanhamento.
- Verificação de profundidade: antes da revisão do leitor, compare o rascunho com o orçamento de profundidade e expanda unidades finas antes de otimizar a prosa.
- Expansão de escopo: se novo trabalho ficar fora de
task_spec.md, registre-o como uma extensão proposta e pergunte antes de expandir o projeto. - Revisão do subagente: os prompts devem pedir ao revisor para procurar ativamente por problemas; se nenhum problema for encontrado, o revisor deve declarar quais evidências apoiam APROVADO.
14. Armadilhas
Fique atento a estes padrões de falha recorrentes:
- Teatro de registros: os registros de fontes e alegações parecem completos, mas a prosa final não sintetiza mecanismos ou trade-offs.
- Prosa de listagem de fontes: parágrafos repetem "fonte X diz Y" em vez de transformar evidências em julgamento voltado para o leitor.
- Polimento prematuro para o leitor: a limpeza da prosa começa antes que as verificações de cobertura, evidência, estrutura e profundidade estejam estáveis.
- Exagero de lente: uma lente opcional se torna o relatório inteiro, mesmo quando a pergunta do usuário precisa de uma estrutura mais simples.
- Expansão de subagentes: revisores ou coletores são solicitados a possuir a tese, reescrever o relatório inteiro ou expandir o escopo.
- Substituição de profundidade: contagens de links, tamanho de arquivo ou cobertura de lista de verificação são tratados como prova de que o relatório é profundo o suficiente.
Leia references/gotchas.md ao diagnosticar desvios repetidos, melhorar avaliações ou adaptar o framework a um novo agente.
15. Paradas Forçadas
Pare o caminho atual e repare o estado antes de continuar quando qualquer um destes ocorrer:
- Parada de briefing: uma tarefa de pesquisa substancial não possui leitor, escopo, forma de saída, padrão de evidência ou orçamento de profundidade após o portão de esclarecimento.
- Parada de evidência: três buscas ou passagens de fonte consecutivas não adicionam novas evidências relevantes, casos, contraexemplos ou julgamentos.
- Parada de alegação:
source_registry.csvcresce enquantoclaims_registry.csvpermanece vazio, genérico ou desvinculado do rascunho. - Parada de rascunho: a prosa final ainda contém linguagem de processo, IDs de fonte internas, rótulos de auditoria, caminhos de arquivo