Entender o trabalho06 / 20
Ler as alterações por intenção
Nesta página
Quando um Agent altera dezenas de arquivos num turno, percorrer os diffs arquivo por arquivo dificulta responder “para que serviram essas alterações?”. No Noea, as alterações de um turno podem ser agrupadas pela intenção a que respondem, e você vê a qual frase sua cada uma serve. As alterações que não respondem a nenhuma intenção ficam listadas à parte, no fim, sem se misturar.
Comece pelo cartão de alterações
Quando um turno deixa alterações em arquivos, a resposta termina com um cartão de alterações. Se um arquivo mudou, o título é algo como “grace.ts editado”; se vários mudaram, algo como “9 arquivos alterados”, com as linhas adicionadas e removidas ao lado. Arquivos que o Agent alterou pela linha de comando também contam.
Depois que o Explain trata o turno, a segunda linha do cartão fica como “2 intenções · 1 sem correspondência”: quantas partes da sua intenção as alterações respondem e quantas alterações não respondem a nenhuma. Até lá, a segunda linha oferece “Executar Explicar para agrupá-las”.
Clique em qualquer ponto do cartão e o painel de código abre na barra auxiliar, no extremo direito da área principal, mostrando todas as alterações do turno. A própria conversa não repete o diff do turno.
O painel de código
O topo do painel mostra o título da conversa e o número do turno, como “E-mail do período de carência · Turno 2”, e permite passar para outros turnos com alterações na mesma conversa. O botão no canto superior direito mostra ou oculta a lista de arquivos, que pode ser plana ou agrupada por pasta; cada arquivo mostra as linhas adicionadas e removidas, e clicar em um leva até ele. O cabeçalho de cada arquivo tem “Abrir com o aplicativo padrão”.
O diff tem uma única coluna de números de linha: as linhas adicionadas e as inalteradas mostram os números novos, e as removidas mostram os números antigos, esmaecidos. As linhas inalteradas entre as alterações ficam recolhidas numa só linha que você pode abrir, até mostrar o arquivo inteiro. Se um arquivo mudou de novo depois do turno, o painel mostra só as alterações deste turno e oferece “Mostrar o arquivo atual”.
Arraste a borda esquerda da barra auxiliar para alargar o painel. Fechá-lo só recolhe a barra auxiliar; o documento e a conversa à esquerda continuam como estão.
Agrupado por intenção
O painel tem dois arranjos, “Por arquivo” e “Por intenção”. Por intenção:
- Cada grupo é uma parte da sua intenção. O cabeçalho é o texto daquele parágrafo, com o documento e a seção em que ele está, em letra pequena acima. Os grupos seguem a ordem dos parágrafos nos seus Documentos de Intenção.
- Dentro de um grupo, as alterações se organizam por ponto-chave e depois por arquivo. Cada ponto-chave é um subtítulo com o nome dele, seguido, em letra pequena, pela primeira frase da implementação.
- Cada alteração aparece uma só vez. Se ela responde a vários pontos-chave, fica sob o principal, e os outros se penduram nela como chips.
- O último grupo é sempre “Outras mudanças”, para as alterações que não respondem a nenhuma intenção.
O arranjo com que o painel abre depende de até onde o Explain chegou com o turno:
| Explain | Abre em |
|---|---|
| Ainda não tratou o turno | Por arquivo |
| Em andamento, com explicações já ligadas a este turno | Passa para Por intenção quando a primeira explicação é publicada; os parágrafos ainda em investigação ocupam um lugar no grupo deles |
| Terminou normalmente | Por intenção |
| Não encontrou nenhum parágrafo para investigar | Por arquivo, com a observação “Este turno não tocou nenhuma intenção explicada.” |
Você pode voltar para Por arquivo a qualquer momento.
A que cada alteração responde
Em cada alteração, a sua intenção aparece em três camadas, da mais leve à mais detalhada:
- Marcas ao lado das linhas: as linhas que uma explicação cita explicitamente têm uma marca neutra e fina à esquerda. Aponte para ela para destacar as outras linhas que a mesma explicação cita e ver o nome da intenção.
- Chips de intenção: os pontos-chave a que uma alteração responde ficam pendurados no cabeçalho dela, no máximo dois, com o restante recolhido em “+N intenções”. Aponte para um chip para ver uma prévia do parágrafo e da primeira frase da explicação; clique para abrir o documento no painel ao lado, com essa explicação aberta.
- Bloco de intenção: abaixo de cada alteração há uma linha de resumo recolhida, como “2 intenções · 1 lacuna”. Abra para ver o texto de cada parágrafo a que a alteração responde, com os itens de atenção da explicação mais recente.
Uma alteração se liga à sua intenção de três maneiras: “Citado pelo Explicar” significa que uma explicação cita explicitamente essas linhas; “Correspondido por linhas” significa que a alteração cai dentro das linhas que uma explicação cita; “Julgado sem efeito” significa que o Explain examinou a alteração e concluiu que ela não afeta aquele parágrafo. Uma alteração que cobre a maior parte de um arquivo, ou cujo conteúdo anterior foi relatado pelo Agent em vez de lido pelo Noea, não é correspondida por linhas; o painel a marca como “Não classificado por linhas”.
Filtre por uma parte da sua intenção
“Filtrar por intenção”, no topo da lista de arquivos, mostra só as alterações de um parágrafo ou de um ponto-chave. Escolha “Sem intenção correspondente” para ver só as alterações que não respondem a nenhuma.
Você também pode ir no sentido contrário, da intenção para as alterações. Abra a explicação de um parágrafo num Documento de Intenção: “Implementação recente”, no fim da nota, lista os turnos que o alteraram há pouco. Abra um, e o painel de código abre nesse turno, já filtrado para este parágrafo.
Depois de ler
“Outras mudanças” não são necessariamente um problema; muitas vezes são auxiliares de teste, formatação ou atualizações de dependências. Mas se uma alteração na lógica de negócio não responde a nenhuma intenção, vale perguntar por que ela mudou e se pertence à sua intenção.
Pergunte ao Agent na conversa, ou clique em “Perguntar sobre isto” à esquerda do parágrafo. Para as decisões que você quer guardar, veja Anotar o que você decidiu na intenção.
O agrupamento depende dos resultados do Explain. Se o cartão continua mostrando “Executar Explicar para agrupá-las”, confira “Explicar automaticamente após implementar” e “Explicar turnos só de código” em Ajustes → Automação, ou simplesmente clique nele; veja Quando o código muda.