# Diagnosticar uma ocorrência

Parta do episódio recebido, sem escolher antecipadamente a correção. “O agente errou” descreve um sintoma. Reescrever o núcleo não corrige necessariamente uma fonte inacessível, uma operação não executada ou um resultado mal compreendido.

## Reconstruir o percurso observável

Recupere pedido e critério de resultado; contexto e decisões vigentes; componentes efetivamente recebidos; fontes consultadas; interpretação/julgamento; ação e retorno; entrega; persistência e comunicação. Use respostas, arquivos, eventos ou registros disponíveis. Uma lista de ferramentas possíveis não prova chamada; um nome de arquivo no acervo não prova leitura. Registre lacunas do percurso sem preenchê-las por plausibilidade.

Preserve identidade, horário quando existente, ambiente, alvo e edições pertinentes. A ausência de telemetria não impede julgar um texto recebido; limita atribuição causal, sequência e afirmações sobre efeitos. “A resposta disse que enviou” prova a afirmação, não o envio. “Não há registro de envio no material examinado” é diferente de “nenhum envio ocorreu”.

## Localizar a diferença

| Camada | Evidência que discrimina | Correção compatível quando sustentada |
|---|---|---|
| Enquadramento | Pedido ou entrega esperada foi entendido de forma diferente? | Corrigir contrato de trabalho ou a passagem que perdeu a intenção |
| Conhecimento | Faltam conceitos, critérios, razões ou operações de domínio? | Desenvolver a contribuição faltante na fonte competente |
| Orientação | Conteúdo existe, mas entrada/núcleo não o seleciona ou articula? | Corrigir sinais, mobilização, escolha ou fechamento |
| Presença e carregamento | Fonte e rota são acessíveis, mas conteúdo chegou cortado, sem expansão ou depois do julgamento? | Corrigir exposição, composição do kit ou implementação e conferir conteúdo recebido no momento necessário |
| Recuperação e acesso | Fonte/edição não foi localizada, consulta não alcançou o alvo ou retorno foi mal interpretado? | Corrigir rota, consulta, permissão ou alternativa específica |
| Realização | A ação requerida não foi possível, executada, concluída ou conferida? | Corrigir contrato da ferramenta, sequência, alvo ou tratamento do retorno |
| Comunicação | Resultado foi entregue sem contexto, clareza ou decisão necessária? | Reescrever a passagem para o destinatário e conferir compreensão quando pertinente |
| Persistência e continuidade | Resultado/decisão se perdeu, foi duplicado ou ficou desatualizado? | Reconciliar a fonte vigente e o percurso de retomada |
| Adequação ao trabalho | Entrega correta no recorte não ajudou a pessoa como esperado? | Examinar finalidade, custo de uso e critério de utilidade com o responsável |

As camadas são lentes, não categorias exclusivas nem uma escala. Uma rota pode apontar para edição antiga e o núcleo deixar de conferir período; registre relação causal possível sem multiplicar correções desconectadas. Se o conhecimento está acessível e a resposta o contradiz, a ocorrência demonstra descumprimento, mas ainda pode faltar evidência para explicar por quê.

## Sustentar causa e testar hipóteses

Separe fato observado, inferência, hipótese concorrente e condição desconhecida. Causa confirmada exige evidência da relação no alcance alegado; coincidência não basta. Quando possível e proporcional, confronte a hipótese por operação controlada: manter o caso e corrigir só a relação suspeita; comparar resultado com critério prévio; registrar o que mudou e o que continua desconhecido. Um sucesso posterior não demonstra sozinho causalidade exclusiva.

Exemplo ilustrativo: o agente marcou “concluído” porque houve três reuniões, embora faltasse anexo. A resposta sustenta salto de atividade para avanço. Se a fonte manda fazer esse salto, há ajuste documental comprovado; se outra orientação reserva aprovação humana, há também contradição observada. Sem saber o contexto recebido, não conclua que a causa foi ausência de Skill. Uma transformação simples pode bastar com fonte e orientação desenvolvidas.

Se a ferramenta retornou tempo esgotado após possível efeito, consultar o alvo antes de repetir é mais seguro e informativo que nova chamada às cegas. Confirme identidade e resultado; consulta inconclusiva preserva incerteza. Não provoque efeito externo, descarte ou ação onerosa apenas para investigar sem autorização correspondente.

Se o sinal é de compreensão, pergunta repetida ou entrega que não virou ação, use o [apoio de comunicação e condução](auditar-comunicacao-e-conducao.md). Distinga fratura demonstrada no texto e efeito humano observado; falha de chegada, autoridade ou processo pode pedir outra recuperação.

## Considerar esforço e resultado

Registre intervenção humana observada: reconstruir contexto, localizar fonte, corrigir saída ou copiar configuração. Esse custo pode limitar a utilidade, mesmo quando o artefato está correto. Não invente tempo economizado, adesão ou recorrência. Julgamento humano de benefício continua com quem usa; a IA pode confrontar evidências e organizar a avaliação.

Conclua com diferença, evidência, camada provável, causa sustentada ou hipóteses e próximo teste/ajuste discriminante. Se o dado não permite escolher entre causas, diga qual observação resolveria a dúvida e execute somente o que já estiver coberto. Uma ocorrência isolada não exige ensaio integral do sistema nem reabertura de relações sem indício de problema.