Conteúdo da documentação12 / 16

Uso diário12 / 16

Organizar documentos de intenção em crescimento

Nesta página

Quando os documentos ficarem repetitivos, assuntos relacionados se dispersarem ou for preciso combinar conteúdo, use Organizar Fonte. O Agente propõe um plano de organização para todos os documentos de intenção, e você decide se deve aplicá-lo depois de revisar o resultado.

Salve primeiro suas edições atuais. Os documentos de intenção permanecem inalterados até você aceitar o plano.

Comece a organizar

Passe o ponteiro sobre o título de intenções na barra lateral, clique no botão de organizar e confirme. O Noea abre uma conversa de organização com progresso e registro de execução.

Você pode escolher primeiro um Agente, modelo e esforço de raciocínio para Organizar Fonte em Ajustes → Projeto atual → Operações.

Durante a execução, Organização pendente aparece na barra lateral com uma árvore de documentos e marcadores de alterações. Abra um documento para pré-visualizar o rascunho enquanto ele é gerado. A pré-visualização acompanha o progresso e não pode ser editada.

Revise as alterações gerais

Quando a execução termina, o cartão de organização mostra um resumo, estatísticas de alterações, uma comparação de contagem de caracteres e recomendações. Veja quais arquivos foram afetados e o que foi combinado ou movido antes de ler o texto.

A seção Organização pendente mostra a hierarquia proposta, marcando adições, remoções, renomeações e movimentações. Clique em uma entrada para revisá-la.

O rascunho organizado e os documentos atuais são visualizações separadas, portanto você pode compará-los lado a lado.

Confira as exclusões propostas

A revisão de organização mostra o documento proposto completo como texto somente leitura. O conteúdo marcado para exclusão permanece no lugar, com fundo vermelho-claro, tachado e uma explicação.

As exclusões propostas são removidas por padrão quando você aceita. Se um requisito ainda importa, escolha Manter. Para a remoção de um arquivo inteiro, você pode escolher Manter o Arquivo Inteiro. Essas escolhas são salvas e preservadas ao reiniciar o aplicativo.

A navegação inferior percorre exclusões propostas entre arquivos. Itens de listas e linhas de tabelas permanecem na estrutura original para você avaliá-los em contexto.

Compare com os documentos atuais

Escolha Comparar com o Original para abrir o documento atual do outro lado. Se um rascunho combinar vários arquivos, selecione a origem que deseja comparar.

Confira especialmente estes pontos:

  • A combinação ou reescrita perdeu alguma condição, como conceder uma recompensa apenas uma vez por sequência?
  • Regras de situações diferentes foram misturadas, deixando o escopo pouco claro?
  • Requisitos válidos foram removidos? Uma funcionalidade pronta não é motivo para apagar sua intenção.
  • A redação é compreensível e evita transformar instruções pontuais de tarefas em requisitos duradouros?

A organização deve melhorar a expressão, não alterar requisitos silenciosamente. Para distinguir entre remover uma restrição e remover uma funcionalidade, consulte Escrever intenções que importam.

Aceite ou rejeite o plano inteiro

Depois de revisar, clique em Aceitar. Se você escolheu itens para manter, o botão mostra a quantidade. A aceitação se aplica ao plano inteiro, incluindo alterações de texto e estrutura.

Rejeitar deixa o plano sem aplicação. Você pode continuar editando os documentos atuais e organizar novamente depois.

Aceitar um plano que altera o texto dos documentos atualiza automaticamente as explicações da implementação. Alterações limitadas a nomes de arquivos ou estrutura de pastas não acionam Explicar. Essa atualização automática independe da configuração “Explicar automaticamente após implementar”. Consulte Agentes, modelos e uso para saber como configurar.

Lide com um plano desatualizado

Se a intenção atual mudar depois de um plano ser gerado, o plano fica desatualizado. A aceitação é desativada e Reorganizar é oferecido. Salvar um documento atual durante a revisão também avisa que isso pode invalidar o plano.

Para reescrever mais o rascunho, rejeite o plano, edite os documentos atuais e organize novamente. Diferentemente do texto novo em uma proposta comum, o texto da revisão de organização não pode ser editado diretamente.

Somente um plano de organização pode aguardar revisão por vez. Ao iniciar outro, você recebe um aviso de que o plano antigo será descartado.

A seguir, confira se suas explicações precisam de atualização.