Relatar o resultado de uma tarefa de agente: concluída, parcial ou bloqueada, com evidências

Objetivo

Entregar um relatório final cujo estado o leitor possa aceitar tal como está e usar para agir, e que torne um resultado parcial tão útil quanto um completo.

Pré-requisitos

Uma tarefa com objetivo declarado e, idealmente, uma verificação de aceitação combinada no início. Se nenhuma foi combinada, o relatório indica a verificação que o agente aplicou.

Passos

1. Escolha exatamente um estado. Concluída: a verificação de aceitação passou e há evidências. Parcial: parte do escopo está feita, com evidências, e o restante está listado. Bloqueada: não é possível avançar sem uma informação, uma permissão ou uma decisão, e essa necessidade é nomeada. Não promova um resultado parcial a concluído só porque o que falta parece pouco.
2. Comece pelo estado e por um resultado em uma frase; depois apresente as evidências: quais verificações foram executadas, com o comando e o resultado (contagem de testes, um código de status, um resumo do diff). Evidência que o leitor pode repetir vale mais do que uma descrição.
3. Liste o que mudou, por identificador: arquivos, registros, chaves de configuração, objetos externos. Separe as alterações reversíveis daquelas que já tiveram efeito externo.
4. Declare cada premissa em que o trabalho se apoia, no ponto em que ela importa, junto com o que mudaria se a premissa estiver errada.
5. Para os estados parcial e bloqueada: liste o escopo restante como passos concretos e, para cada bloqueio, a informação exata que o desbloquearia (uma decisão entre opções nomeadas, uma credencial, a resposta a uma pergunta escrita).
6. Relate as falhas de forma direta, com a saída correspondente. Um teste que falha é relatado como falho, não como "quase todos passando"; uma etapa que foi ignorada é relatada como ignorada, com o motivo.
7. Não inclua no relatório narrativa sobre o processo, a menos que o processo tenha produzido uma descoberta de que o leitor precisa (uma restrição inesperada, uma premissa errada no briefing). Becos sem saída vão para o log de execução, não para o relatório.

Resultado esperado

Um leitor que veja apenas o relatório consegue decidir se aceita, continua ou redireciona o trabalho, e consegue verificar a afirmação de "concluída" só pelas linhas de evidência. Resultados parciais são repassados sem perdas, porque o escopo restante já está escrito.

Limites e base de verificação

É um formato proposto, não medido. Seu valor depende de a verificação de aceitação ser declarada logo no início; um relatório só consegue ser honesto sobre um objetivo vago dizendo que o objetivo era vago.