Manter as explicações atualizadas — Documentação do Noea Code

Depois de alterar a intenção ou o código, confira se as explicações ainda se aplicam. Use Explicar na barra lateral para tratar as explicações que precisam de atenção em todo o projeto ou a ação Investigação de um parágrafo para verificar um conteúdo específico.

Identifique o que mudou

Status	Significado	Próximo passo
Conteúdo a investigar	A redação nova ou editada não tem explicação própria.	Salve e investigue. Implemente primeiro se o requisito ainda não for atendido.
Explicação do texto anterior	O parágrafo mudou, mas a nota ainda explica a redação anterior.	Examine as diferenças de texto e investigue novamente.
Pode estar desatualizado	Arquivos lidos ou citados pela explicação mudaram.	Revise os arquivos alterados e confira a explicação novamente.
Nenhuma alteração encontrada	Não há conteúdo aguardando investigação nem marcado como possivelmente desatualizado.	Continue lendo ou verificando dúvidas específicas conforme necessário.

“Pode estar desatualizado” não significa necessariamente que uma conclusão está errada; a alteração do arquivo pode não ter relação com ela. “Nenhuma alteração encontrada” não comprova que os testes passaram ou que todas as funcionalidades estão prontas.

Investigue um parágrafo

Salve o documento, passe o ponteiro sobre o parágrafo e escolha Investigação à esquerda. Uma nota à margem existente também pode oferecer Investigar Novamente.

Isso atualiza apenas a explicação do conteúdo selecionado. A Investigação fica indisponível enquanto esse conteúdo tiver alterações não salvas, e o Noea pede para salvar primeiro.

Por exemplo, depois de alterar o código que impede recompensas duplicadas, investigue a regra correspondente para conferir se a explicação descreve a implementação atual.

Atualize as explicações do projeto inteiro

Clique em Explicar na barra lateral para verificar conteúdo aguardando investigação e explicações cujos arquivos de apoio mudaram. Essa ação fica indisponível se não houver projeto aberto, se o projeto for somente leitura ou se nenhuma pasta de implementação estiver vinculada.

Uma tarefa de Explicar iniciada manualmente abre uma conversa com etapas, progresso e resultados individuais. Você não pode enviar mensagens comuns nessa conversa durante a execução, mas pode usar outras conversas do projeto.

Quando terminar, expanda os resultados para ver quais explicações mudaram, quais continuam corretas e quais verificações falharam ou ficaram incompletas. Uma tarefa encerrada não significa que todas as verificações foram bem-sucedidas.

Entenda o que Explicar verificou

Explicar compara intenção e código e verifica tanto explicações de parágrafo quanto locais. Mantém o conteúdo correto e atualiza o que precisa de correção; não necessariamente reescreve todas as explicações.

Uma explicação atualizada não significa que os testes foram executados novamente. Para verificar um comportamento, solicite as verificações em uma conversa comum e depois investigue o conteúdo correspondente. Consulte Ler explicações e evidências para interpretar o escopo da verificação.

Saiba quando Explicar é executado automaticamente

Ajustes → Projeto atual → Automação → Explicar automaticamente após implementar fica ativado por padrão. Os principais acionamentos são:

Ação	Explicar automático
Aceitar uma proposta que altera a intenção e ainda precisa de implementação.	Depois que a tarefa de implementação terminar normalmente.
Aceitar uma proposta que altera a intenção e já é atendida pela implementação.	Depois da aceitação.
Iniciar o trabalho com Implementar na barra lateral.	Depois que o primeiro turno terminar normalmente.
Aceitar um plano de organização que altera o texto da intenção.	Depois da aceitação, independentemente da configuração acima.
Reorganizar apenas nomes de arquivos ou a estrutura de pastas.	Não é acionado.
Alterar apenas código em uma conversa comum, escolher Implementar Diretamente ou ter a implementação interrompida ou com falha.	Não é acionado; execute Explicar manualmente.

Explicar automático é executado em segundo plano sem criar uma conversa comum. Continue na conversa original e acompanhe o progresso em Execuções.

Revise registros e execute novamente

A seção Execuções da barra lateral mantém as tarefas de explicação. Expanda uma tarefa para ver registros somente leitura de suas execuções. Os registros permanecem disponíveis depois de trocar de conversa ou reiniciar o aplicativo.

Após falha ou interrupção, escolha Executar Novamente. As explicações existentes são preservadas. Quando a nova execução terminar, confira se os itens antes incompletos ou com falha foram tratados.

Escolha um Agente para cada operação

O Agente usado por Explicar depende de como a tarefa começa. Consulte Agentes, modelos e uso para conhecer as configurações das operações do projeto e seu alcance.

Se as explicações não forem atualizadas, consulte Solução de problemas e perguntas frequentes.