Discutir e revisar alterações de intenção — Documentação do Noea Code

Quando uma discussão levar a uma nova decisão de produto, peça ao Agente que a transforme em uma proposta de intenção. Revise a redação, ajuste se necessário e decida se deve escrevê-la nos documentos.

Comece com um contexto específico

Passe o ponteiro sobre um parágrafo relevante e escolha Perguntar sobre isto à esquerda. O Noea insere uma referência no campo de entrada e mostra o documento ao lado da conversa. Ele não envia uma mensagem automaticamente.

Você também pode digitar @ no campo de entrada para buscar documentos, parágrafos ou explicações. O conteúdo selecionado aparece como um marcador de referência e é fornecido ao Agente com sua mensagem.

Por exemplo:

Esta regra de recompensa não diz o que acontece após um check-in perdido. Explique o comportamento atual com base na implementação e depois vamos discutir se devemos permitir a reposição de check-ins.

Quando decidir, peça uma proposta:

Acrescente “Permitir uma reposição de check-in por mês” a esta regra. Proponha a alteração de intenção para eu revisar.

Decida entre corrigir o código e mudar o requisito

Quando intenção e implementação divergirem, pergunte primeiro se o requisito original continua valendo. Imagine que o documento exige uma recompensa após 7 dias consecutivos, mas o código a concede no dia 6:

Sua decisão	Próximo passo
O requisito continua sendo 7 dias.	Mantenha a intenção. Peça ao Agente que corrija a implementação e verifique o limite.
Depois da discussão, você decide por 6 dias.	Altere a intenção, revise a nova condição de acionamento e confira a implementação.

Não reescreva a intenção apenas para acomodar o código existente. Primeiro confira se o Agente entendeu o requisito e depois se o código o atende. Esclareça mal-entendidos, corrija erros de implementação e mude a intenção somente quando decidir mudar a regra.

Para uma correção, seja explícito:

Mantenha o requisito de 7 dias. Corrija a recompensa antecipada, verifique que no dia 6 não haja recompensa e no dia 7 haja, e não altere a intenção para se ajustar ao código atual.

Diferencie sugestões de propostas

Um cartão de sugestão registra algo que o Agente considera que vale a pena acrescentar à intenção. Adotar inicia um trabalho na conversa atual para transformá-lo em uma proposta que a implementação existente já atende; não escreve diretamente na intenção. Descartar registra que você não vai adotar a sugestão.

Uma proposta contém alterações específicas em documentos para você revisar. Depois de enviada pelo Agente, seu cartão aparece quando o turno atual termina, é interrompido ou falha. Escolha Ver Alterações para examiná-la.

Revise as alterações no documento

A visualização de revisão mantém a disposição do documento. Inserções têm fundo verde-claro; exclusões têm fundo vermelho-claro e texto tachado. Substituições mostram o texto antigo e o novo, destacando alterações por palavra quando adequado.

Use a barra inferior de revisão para navegar pelas alterações ou selecione um nome de arquivo para trocar de documento. A decisão se aplica à proposta inteira, incluindo todos os arquivos. Não é possível aceitar parágrafos ou arquivos individualmente.

Você pode editar o texto inserido e o lado novo de uma substituição. O texto original, as exclusões e os parágrafos não afetados não podem ser editados nesse estado de revisão. Depois de editar, a ação principal muda para Aceitar Minhas Edições.

Antes de decidir, confira não só quais palavras mudaram, mas o que elas exigem:

Você consegue explicar as condições e os termos acrescentados com suas próprias palavras?
Uma instrução pontual foi confundida com um requisito duradouro?
O Agente enfraqueceu uma restrição silenciosamente para corresponder ao código existente?
Você conseguirá encontrar a frase certa na próxima vez que quiser mudar esse comportamento?

Se algo não estiver claro, volte à conversa e peça ao Agente que explique ou revise a proposta.

Escolha uma ação

Ação	Documento de intenção	Implementação
Aceitar	Grava a proposta inteira.	Continua se houver trabalho necessário; não inicia outra execução se já estiver atendida.
Aceitar Minhas Edições	Grava a proposta inteira com suas edições.	Continua de acordo com a proposta editada.
Implementar Diretamente	Não grava a proposta.	Implementa a proposta; disponível apenas quando ela ainda precisa de implementação.
Descartar	Não aplica a proposta.	Não inicia sua implementação.

Aceite uma decisão revisada quando quiser que ela oriente o desenvolvimento futuro. Implementar Diretamente não registra esse pedido como intenção.

Descartar uma proposta não desfaz alterações de código já realizadas. Por exemplo, o Agente pode ter concluído o trabalho antes de propor que você registre o comportamento existente.

Lide com propostas revisadas e documentos alterados

O Agente pode revisar uma proposta na mesma conversa. A nova versão substitui a revisão pendente, enquanto o cartão antigo mantém um aviso de versão. Edições que você fez, mas não aceitou na revisão antiga, não são transferidas automaticamente.

Se o documento atual não corresponder mais ao texto inicial da proposta, a aceitação fica desativada. Use Pedir ao Agente Nova Proposta na Versão Atual para que ele releia o documento e crie alterações que possam ser aplicadas.

Depois da aceitação

Uma proposta que precisa de implementação continua na conversa atual. Se não terminar, use Continuar Implementando no cartão. Volte depois ao documento e confira a explicação; execute Explicar manualmente se ela não tiver sido atualizada.

Para impedir que revisões abram automaticamente, desative Ajustes → Projeto atual → Automação → Abrir a revisão automaticamente e entre na revisão pelo cartão da proposta. Essa configuração controla a abertura da revisão, não a aceitação da proposta.

Continue com Manter as explicações atualizadas.