Escreva critérios de aceitação claros com ditado por voz

“Permitir salvar um rascunho” parece simples, até alguém perguntar o que acontece se o título estiver vazio ou se salvar também publica o artigo. Talvez você consiga explicar o comportamento em voz alta, mas a descrição da tarefa continua em branco.

O ditado por voz permite começar por essa explicação. Descreva um cenário e organize o texto em critérios de aceitação: os resultados observáveis necessários para aceitar o trabalho. O conceito está na introdução da Atlassian aos critérios de aceitação, em inglês. A seguir, veja uma rotina prática para transformar sua explicação em um texto que a equipe possa revisar.

1. Abra a tarefa antes de começar a falar

No Mac, deixe a descrição da tarefa ao lado do design ou das anotações já acordadas. Escolha um comportamento pequeno, não a funcionalidade inteira. Se o assunto é salvar um rascunho manualmente, trate agendamento, publicação e salvamento automático em outras discussões, a menos que já façam parte do escopo.

Primeiro, escreva o objetivo em uma frase: “Uma pessoa da equipe editorial pode salvar um trabalho inacabado e retomá-lo depois”. Isso ajuda a manter a explicação focada em quem usa o recurso.

2. Dite o fluxo com cinco perguntas

Imagine que está mostrando o funcionamento a um colega. Faça uma pequena pausa entre os pontos.

• Quem: qual pessoa ou perfil usa o recurso?
• Situação inicial: quais condições já existem antes da ação?
• Ação: o que a pessoa faz?
• Resultado: o que ela deve conseguir observar depois?
• Exceção: o que deve acontecer em um caso de falha relevante?

Antes de um ponto que a equipe ainda não decidiu, diga “questão em aberto”. Na revisão, você pode mover esses trechos para uma seção separada, sem transformar uma possibilidade em requisito por engano.

3. Transforme o ditado em afirmações verificáveis

O exemplo abaixo é fictício e não descreve uma funcionalidade do TypeFree:

A pessoa que está editando abriu um artigo ainda não publicado, com título e texto. Ela salva o rascunho e vê uma confirmação. Ao abrir de novo, o título e o texto continuam lá. O artigo não deve ficar público. Se o título estiver vazio, é preciso pedir que ela preencha e não salvar. O salvamento automático ainda não foi decidido.

Depois de ditar, organize o conteúdo como uma proposta para revisão:

1. Ao salvar com sucesso um artigo não publicado e com o título preenchido, a pessoa que está editando vê uma confirmação.
2. Ao reabrir o rascunho salvo, o título e o corpo do texto daquele salvamento são restaurados.
3. Salvar o rascunho não torna o artigo visível ao público.
4. Uma tentativa de salvar com o título vazio exibe uma mensagem solicitando um título e não salva as alterações.

Mantenha “O salvamento automático deve entrar no escopo?” em Questões em aberto, fora dos critérios acordados. Essas regras são propostas para um recurso imaginário; sua equipe deve escolher o comportamento do próprio produto.

4. Confira o significado antes de melhorar o estilo

Preste atenção em palavras como “não”, “apenas”, “vazio” e “não publicado”. Uma negação ausente pode inverter o requisito. Copie os nomes exatos dos botões do design, em vez de depender apenas da transcrição.

Em seguida, leia cada item como quem vai verificá-lo: o que preciso fazer e qual resultado indica que o critério foi atendido? Se você escreveu “salva rápido”, confirme o tempo e as condições de medição de que a equipe realmente precisa. Não invente um limite só para deixar a frase com aparência de precisão.

Separe resultados visíveis de ideias de implementação. Se a explicação foi para detalhes de armazenamento ou nomes internos, transfira esses trechos para anotações técnicas a discutir.

5. Resolva as dúvidas com a equipe

Compartilhe os critérios como rascunho, deixando as decisões pendentes visíveis. Antes de tratar a lista como escopo acordado, peça às pessoas responsáveis por desenvolver e revisar o recurso que confiram os cenários. O ditado registra sua explicação; ele não estabelece um acordo nem comprova que a funcionalidade funciona.

Para outras tarefas de escrita, veja como criar briefings de projeto por voz e escrever relatos de bugs mais claros.

TypeFree é uma forma simples de transformar a fala em texto editável e escrever mais rápido. Escolha um cenário, explique o comportamento esperado e revise o texto antes de adicioná-lo à tarefa.