Entender o trabalho05 / 20
Conferir as evidências
Nesta página
Um Agent dizer “implementado” não basta. Cada explicação vem com as suas evidências: o código que leu, os testes que rodou, os registros de execução e as capturas de tela, a um clique de distância para conferir. Quando alguém perguntar, você pode apontar o lugar exato.
O que as evidências contêm
Abra “Evidências” na nota. Os tipos de material mais comuns são:
| Material | Aparece como | Ao clicar |
|---|---|---|
| Um local de código | Um nome de função, ou um chip “arquivo:linha” | O painel de código abre à direita nessas linhas |
| Saída de comando, como uma execução de testes | Um chip | A saída completa abre na barra auxiliar à direita |
| Um diff de código | Um chip | Abre na barra auxiliar à direita |
| Capturas de tela e outras imagens | Uma miniatura | Abre ampliada |
As saídas de comando, os diffs e as capturas de tela vêm dos registros que o Agent deixou ao implementar. O Noea guarda, em cada turno, quais comandos foram executados e quais capturas de tela foram feitas, para que uma explicação possa citá-los diretamente.
Olhe um local de código
Um local de código no meio de uma frase costuma aparecer como o nome de uma função ou variável, como openGrace; caso contrário, aparece como um chip “arquivo:linha”, como grace.ts:6-18. Se uma explicação cita dois arquivos com o mesmo nome, o chip acrescenta a pasta superior.
Deixe o ponteiro sobre um nome ou chip para ver o caminho completo, o intervalo de linhas e o símbolo. Clique, e o painel de código abre à direita nesse arquivo, nas linhas citadas. Se o arquivo continua como um turno de implementação o deixou, as alterações desse turno ficam sobrepostas ao arquivo inteiro, e você vê qual turno as escreveu. O menu do botão direito pode abrir o arquivo no aplicativo padrão, mostrá-lo no Finder ou copiar o caminho.
Se o código mudou de lugar desde então, os números de linha do chip e o destino dele acompanham a posição atual. Se o código citado mudou e só o nome foi encontrado, o chip fica esmaecido; se o arquivo sumiu ou o código não é mais encontrado, o chip fica esmaecido e riscado, e passar o cursor diz o motivo. Nos dois casos, o mais provável é que a explicação precise ser investigada de novo.
Até onde vão as evidências
Ao olhar um material, primeiro identifique de que tipo ele é:
| Material | O que pode confirmar | O que ter em mente |
|---|---|---|
| Código de implementação ou de teste | Que lógica o código usa e quais casos os testes definem | Existir código de teste não significa que os testes rodaram ou passaram |
| Resultados de execuções anteriores | O que rodou na época e qual foi o resultado na época | Se o código mudou desde então, o resultado pode não valer mais |
| Verificação feita durante esta explicação | O resultado no ambiente e no escopo desta execução | Casos que passam não dizem nada sobre os casos não cobertos |
O Explain e a Investigação se apoiam principalmente na leitura do código e de material existente; não reexecutam testes, builds nem o app a cada vez. O Agent só verifica algo quando ler o código não resolve um fato do qual a conclusão depende. Uma boa evidência diz o que não foi verificado, como “Não foi executado contra o provedor de pagamento real; os resultados das cobranças vêm de um dublê de teste.” Quando as evidências são fracas, nenhuma implementação foi encontrada ou a intenção é ambígua, as evidências e a atenção devem dizer isso com clareza, em vez de oferecer uma conclusão que só parece certa.
Lembre-se também de que uma explicação é um registro de investigação com evidências, não um certificado. Pedir a um Agent que confira a implementação de outro Agent não torna o resultado mais certo por si só. O valor das evidências é que você pode abri-las e conferir, não que a explicação diga “confirmado”.
Capturas de tela e a interface
Alguns comportamentos não se resolvem só pelo código, como saber se um aviso realmente aparece na interface. Se o Agent tirou uma captura de tela ao implementar, a explicação pode listá-la como evidência, por exemplo “Durante o período de carência, um aviso aparece no topo da página de configurações da equipe.”
Clique na miniatura para ampliá-la. Observe qual página ela mostra, em que estado e qual execução a deixou: uma captura de tela prova como a interface era na época; se o código mudou desde então, a interface pode ter mudado também.
Confira item por item
Ao conferir as evidências, pergunte sobre cada item:
- Esta referência aponta para aquilo de que esta parte da intenção trata?
- Que casos os testes cobrem, e os casos extremos estão entre eles?
- O resultado realmente sustenta a conclusão da explicação?
- As evidências dizem o que não foi verificado?
Por exemplo, as evidências do período de carência dizem “executei os testes do período de carência: os 6 passam”, enquanto a atenção observa que “nenhum teste cobre o caso em que a terceira tentativa dá certo.” Agora você sabe que esse caminho se apoia só na leitura do código, sem nenhuma execução que o comprove.
Quando as evidências não bastam
Se falta um caso importante, passe o cursor sobre o parágrafo, clique em “Perguntar sobre isto” à esquerda dele e peça ao Agent que o verifique:
Adicione um teste: a terceira tentativa dá certo no dia 6 do período de carência, então a assinatura volta ao normal e não é rebaixada. Diga-me o resultado depois de executar.
Quando o Agent terminar, o Noea explica o turno por conta própria; se você desativou isso, clique em “Investigação” à esquerda do parágrafo. A nova explicação lista esta execução como evidência.
Se a conclusão da explicação não combina com as evidências, ou se você acha que o Agent leu mal a sua intenção, pergunte isso aqui também, e não mude a sua intenção para se ajustar ao código. Veja Anotar o que você decidiu na intenção.