Seu primeiro fluxo de trabalho

Este tutorial usa uma recompensa por check-ins para mostrar como escrever sua primeira intenção, verificá-la ou implementá-la e registrar uma nova decisão. Você aprenderá a avaliar se um requisito foi atendido usando o código real do projeto e os resultados de verificação.

Você precisa do Noea com um Agente marcado como Pronto e de um projeto local no qual queira trabalhar. Se seu projeto não tiver check-ins, substitua o exemplo por outra regra igualmente específica.

Abra o projeto de código

Escolha Abrir Pasta… na área de trabalho ou Arquivo → Abrir Pasta de Implementação… e selecione a pasta que contém seu código.

Na primeira vez que você abre essa pasta, o Noea cria um projeto vinculado. Ele abre diretamente um projeto existente ou pede que você escolha se houver vários vinculados. Consulte Abrir e gerenciar projetos para outras formas de abrir um projeto.

Escreva sua primeira intenção

Clique em Nova Intenção na barra lateral e dê o nome “Check-ins diários”. O Noea adiciona a extensão .noea.md e abre o documento. Escreva:

# Check-ins diários

Os usuários podem fazer check-in uma vez por dia. Conceder uma recompensa ao usuário após 7 dias consecutivos de check-ins.

Salve com ⌘S no macOS ou Ctrl+S no Windows / Linux. Comece pelo que já decidiu; ainda não é preciso enumerar todos os casos de borda.

Escolha entre investigar e implementar

Explicar verifica o conteúdo de todo o projeto cujas explicações precisam de atenção. A ação Investigação de um parágrafo verifica apenas aquele conteúdo. Ambas examinam a implementação e geram ou atualizam explicações; não alteram o código.

Se os check-ins já existem, clique em Explicar na barra lateral. Para verificar apenas esse parágrafo, passe o ponteiro sobre ele e escolha Investigação à esquerda.

Se a regra ainda precisa ser implementada, inicie uma nova conversa, digite @ no campo de entrada para selecionar o documento de intenção e envie:

Implemente a recompensa por check-ins neste projeto conforme a intenção referenciada. Examine primeiro o código existente, siga a estrutura do projeto e verifique tanto uma sequência de 7 dias quanto um check-in perdido.

Você também pode usar o botão Implementar da barra lateral quando disponível; consulte Trabalhar com um Agente na implementação. A conversa mostra respostas, chamadas de ferramentas e alterações de arquivos enquanto o Agente trabalha.

Depois de implementar, clique em Explicar se ele não tiver iniciado automaticamente. Nem toda alteração de código em uma conversa comum aciona uma atualização das explicações.

Leia uma explicação da implementação

Volte ao documento de intenção e clique no espaço em branco dentro do parágrafo, fora do texto, para abrir a nota à margem. Leia estas seções:

• Implementação: como o código conta dias consecutivos e concede recompensas.
• Evidências: o código, a saída de comandos ou o material de testes citado pela explicação.
• Atenção: lacunas, decisões de implementação, riscos ou sugestões que precisam da sua avaliação.

Por exemplo, você pode descobrir que a implementação define os dias do calendário usando o fuso horário do dispositivo. Confira o que o projeto realmente faz e se isso corresponde aos seus requisitos. Abra as referências para ver até onde as evidências sustentam a explicação.

Uma explicação concluída não significa que os testes foram executados novamente. Diferencie código de testes, resultados históricos e verificações feitas nesta execução; consulte Ler explicações e evidências. Se a implementação não atender ao requisito original, corrija-a em vez de reescrever a regra para se ajustar ao código.

Faça uma pergunta e registre uma decisão

Passe o ponteiro sobre o parágrafo e escolha Perguntar sobre isto à esquerda. O Noea insere uma referência no campo de entrada da conversa. Acrescente sua pergunta e envie:

Como a implementação atual lida com viagens entre fusos horários? Fazer check-in em dois locais pode afetar a sequência? Explique com base no código.

Quando entender o comportamento, decida se quer estabelecer uma restrição para o cálculo. Nesse caso, envie:

Acrescente “Um dia segue a data do calendário no local atual do usuário” a esta intenção. Primeiro proponha a alteração de intenção para eu revisar.

Quando o Agente enviar uma proposta, clique em Ver Alterações e leia o texto inserido e substituído. Edite a nova redação se necessário e escolha Aceitar Minhas Edições, ou Aceitar se nenhuma edição for necessária.

Se a proposta precisar de implementação, aceitá-la dá continuidade ao trabalho na mesma conversa. Se a implementação existente já a atender, não será necessária uma nova execução de implementação. Confira depois os resultados da tarefa de explicação ou investigue manualmente quando necessário.

Confira o que aprendeu

Antes de terminar, salve o documento e confirme que sua explicação cobre a redação atual. Tente responder a quatro perguntas com suas próprias palavras:

1. Como este requisito é implementado e quais evidências sustentam essa conclusão?
2. Qual decisão importante o Agente tomou que não estava especificada na intenção?
3. Eu entendo e aceito essa decisão? Ela deveria se tornar uma restrição duradoura?
4. Qual frase eu mudaria da próxima vez que quisesse alterar esse comportamento?

Por exemplo, você deve conseguir explicar como um dia é definido, encontrar as evidências correspondentes e apontar “7 dias consecutivos” como a condição da recompensa. Se uma resposta não estiver clara, pergunte sobre o parágrafo pertinente.

Você não precisa registrar todas as regras na primeira visita. Acrescente a próxima decisão que mereça ser mantida quando ela surgir.

A seguir, leia Escrever intenções que importam e Ler explicações e evidências.