Mapa de Evidências para Construção

Transforme uma questão controversa em um artefato de decisão portátil que mostra o que apoia a posição atual, o que a contraria e o que permanece desconhecido. Não use um gráfico para decorar uma resposta que não foi fundamentada.

Para uma afirmação factual simples ou uma solicitação geral de verificação de fatos, use um fluxo de trabalho de verificação como doublecheck em vez disso. Use esta habilidade quando as relações entre evidências, alegações intermediárias, compensações e fatos ausentes forem importantes.

Fluxo de Trabalho

1. Formule uma decisão. Escreva uma pergunta falseável e uma posição provisória. Refine a pergunta até que um leitor possa identificar qual ação ou crença o mapa está testando.

2. Colete regiões de origem delimitadas. Prefira observações diretas e fontes primárias. Registre a URL ou o caminho absoluto local, editor, data de publicação, data de recuperação, localizador de seção/página/linha/timestamp e um pequeno trecho verificável. Leia references/evidence-ladder.md quando a qualidade da fonte for disputada.

3. Atomize o raciocínio. Crie apenas quatro tipos de nós:

   • position: o veredito atual único;
   • claim: uma proposição intermediária;
   • evidence: uma declaração fiel de uma região de origem;
   • unknown: um fato específico ausente que poderia mudar o veredito.

4. Type cada aresta. Use supports, contradicts, qualifies ou missing. Adicione uma nota em linguagem clara explicando por que o nó de origem se relaciona com o nó de destino. Similaridade temática não é suporte. Diferentes escopos, datas ou populações não são automaticamente uma contradição.

5. Preserve contraevidências. Não exclua evidências contrárias porque o veredito provisório as sobrevive. Represente diferenças de escopo com arestas qualifies.

6. Expresse incerteza estruturalmente. Não invente porcentagens de confiança. Adicione um unknown, refine a posição ou qualifique uma alegação.

7. Escreva JSON UTF-8 com o sufixo .doubt.json. Siga references/map-schema.md. Mantenha os IDs curtos, estáveis e semânticos.

8. Valide fail-closed. Resolva scripts/validate.mjs em relação a este SKILL.md, então execute-o com Node.js 18 ou mais recente:

   node <skill-directory>/scripts/validate.mjs decision.doubt.json
   

   O validador empacotado usa apenas recursos nativos do Node.js e não requer npm ou acesso à rede. Corrija todas as descobertas antes de relatar sucesso. Diga que o mapa é válido apenas quando o comando sair 0 e imprimir VALID seguido por um recibo de 64 caracteres. Um hash de arquivo, contagem de nós, análise JSON ou revisão manual de esquema não é um recibo de Dúvida. Se a validação determinística não puder ser executada, relate esse bloqueio em vez de inventar sucesso.

   Renderize o mapa validado apenas quando o usuário já tiver instalado doubt-ai@0.8.0; não instale ou execute um pacote remoto implicitamente:

   doubt map decision.doubt.json --out decision.html
   

9. Verifique snapshots de origem apenas com permissão explícita de rede. O comando a seguir recupera cada origem HTTP(S) registrada e falha fechado se um trecho não puder ser correspondido:

   doubt verify decision.doubt.json \
    --out decision.verified.doubt.json
   

   Nunca execute este comando implicitamente. A verificação de arquivo local não usa a rede. Não escreva um objeto verification manualmente nem oculte uma incompatibilidade.

10. Inspecione o entregável. Confirme que a pergunta, o veredito, as contraevidências, os desconhecidos, as notas das arestas e as regiões exatas das fontes permanecem legíveis. Trate o JSON como o artefato editável canônico; o HTML é uma visualização compartilhável.

Portões de Qualidade

Um mapa finalizado deve satisfazer todos estes:

• exatamente um position tem raciocínio de entrada;
• cada nó de evidência nomeia uma fonte e participa de uma aresta;
• cada fonte é usada e tem datas, um localizador delimitado e um trecho substantivo;
• cada nó não-posição tem um caminho direcionado para a posição;
• o grafo de raciocínio não tem arestas duplicadas ou ciclos direcionados;
• evidências contrárias ou qualificadoras estão presentes quando o conjunto de fontes as contém;
• cada lacuna que muda a decisão é um nó unknown explícito;
• cada nota de aresta explica suporte, contradição, qualificação ou ausência;
• o veredito não é mais amplo do que a evidência.

Entregue o Resultado

Relate:

• a posição atual em uma frase;
• a contraevidência ou qualificação mais forte;
• o desconhecido mais importante não resolvido;
• caminhos para o JSON canônico e qualquer HTML renderizado;

…