Estórias de usuário: porque uma boa escrita é importante no desenvolvimento de produtos?

Pedro Godoy
ioasys-voices
6 min readOct 4, 2022

--

Estórias de usuário tem como objetivo descrever uma necessidade (do usuário) de forma simples e prática.

Essa técnica é amplamente utilizada dentro da metodologia ágil, e consiste em criar uma narrativa que explique sobre o que, para quem e porque entregar determinada funcionalidade. Ou seja, ela é o parâmetro para a entrega final e deve estar alinhada com a estratégia do produto.

Como estamos trabalhando com Agilidade, caso tenha algo que precise ser ajustado, isso pode ser realizado durante o desenvolvimento, porém grandes mudanças podem impactar o prazo e qualidade da entrega. Por isso, é importante que a estória esteja bem escrita, alinhada com a estratégia do produto e numa linguagem que todos os integrantes do time entendam.

Como criar estórias de usuário?

A escrita das estórias de usuário é de responsabilidade do Product Owner. Ela é composta, basicamente, por:

  • Título: deve ser breve, direto e de fácil entendimento.
  • Descrição: deve informar o valor que a estória está entregando para o usuário/negócio respondendo às seguintes perguntas:
  • Para quem?
  • O que?
  • Porque?
  • Critérios de aceite: as regras envolvidas na entrega e como o sistema deve se comportar.

Para escrever a descrição de uma estória de usuário podemos encontrar alguns templates, o mais comum é:

  • Como (ator).
  • Gostaria (o que será entregue? O que precisa ser feito).
  • Para que (valor que a estória entregará).

Os critérios podem ser escritos em tópicos que descrevem as regras, ou com templates pré-definidos. Como a linguagem Gherkin, muito conhecida na metodologia BDD (Behavior Driven Development).

Abaixo temos um template para escrever critérios de aceite utilizando o BDD:

Na prática, a mesma estória de usuário pode estar em diferentes formatos e especificações dependendo do quão detalhada ela está. Quando elas são criadas, normalmente a riqueza de detalhes é menor e os critérios de aceitação não estão totalmente definidos. Para que seja mais fácil identificarmos em qual etapa a estória se encontra, utilizamos o board Kanban do produto.

Abaixo, separamos um exemplo prático da evolução de uma estória de usuário.

Evolução de uma estória de usuário

Cenário: Início de um projeto.

Projeto: criação de uma plataforma de acompanhamento do mercado financeiro, conteúdos e notícias com possibilidade de adquirir um plano com benefícios exclusivos para assinantes.

FASE 01 — Criação da estória (pouca especificação)

Título: Realizar cadastro do usuário na plataforma.

Descrição estória:

  • Como possível cliente
  • Gostaria de realizar o cadastro na plataforma
  • Para que consiga acompanhar o mercado financeiro e ter acesso aos conteúdos gratuitos.

Critérios de aceite:

  • Realizar o cadastro na tela de Login.
  • Cadastro simples para criar lead.

FASE 02 — Detalhamento da estória e dúvidas geradas

Título: Realizar cadastro do usuário na plataforma.

Descrição estória:

  • Como possível cliente
  • Gostaria de realizar o cadastro na plataforma
  • Para que consiga acompanhar o mercado financeiro e ter acesso aos conteúdos gratuitos.

Critérios de aceite:

  • Realizar cadastro na tela de Login da plataforma.
  • Cadastro simples para gerar lead.

Dúvidas:

  • Quais informações são obrigatórias para cadastro?
  • Teremos alguma informação opcional?
  • Quais os critérios para a criação de senha para acesso a plataforma?
  • Os dados serão utilizados para encaminhar alguma comunicação para o cliente?
  • Se sim, precisamos solicitar o aceite do usuário.

FASE 03 — Estória finalizada e escrita em BDD

Título: Realizar cadastro do usuário na plataforma

Descrição estória:

  • Como possível cliente e usuário
  • Gostaria de realizar o cadastro na plataforma
  • Para que consiga acompanhar o mercado financeiro e ter acesso aos conteúdos gratuitos.

Critérios de aceite:

Dado que o usuário está acessando a tela de Login

Quando visualizá-la

Então o usuário deve ter a opção de realizar o cadastro na plataforma.

Dado que o usuário acessou a tela de login quando selecionar a opção de realizar cadastro na plataforma

Então deve ser direcionado para a tela de cadastro.

Dado que o usuário está acessado a tela de cadastro

Quando for preencher as informações

Então as seguintes informações devem ser preenchidas de forma obrigatória:

  • Nome completo
  • Validar se foram preenchidos no mínimo dois nomes.
  • E-mail (login)
  • Validar se os caracteres “.” e “@” estão presentes no que foi preenchido.

Dado que o usuário está acessando a tela de cadastro

Quando for preencher as informações

Então as seguintes informações devem ser preenchidas de forma opcional:

  • Telefone
  • Profissão

Dado que o usuário está preenchendo as informações de cadastro

Então a opção de selecionar (checkbox) os Termos de Aceite deve ser obrigatória.

Dado que o usuário está preenchendo as informações de cadastro

Então a opção de selecionar (checkbox) o aceite para receber comunicações da plataforma deve ser opcional.

Dado que o usuário preencheu todas as informações e clicou em [FINALIZAR CADASTRO]

Quando as informações de Nome não estiverem de acordo com as validações

Então deve ser apresentada uma mensagem de “erro” (Mensagem 01) e ele deve ser impedido de prosseguir com cadastro.

Dado que o usuário preencheu todas as informações e clicou em [FINALIZAR CADASTRO]

Quando as informação de E-mail não estiverem de acordo com as validações

Então deve ser apresentada uma mensagem de “erro” (Mensagem 02) e ele deve ser impedido de prosseguir com cadastro.

Dado que o usuário preencheu todas as informações e clicou em [FINALIZAR CADASTRO]

Quando o usuário não der o ‘check’ nos Termos de aceite

Então deve ser apresentada uma mensagem de “erro” (Mensagem 03) e ele deve ser impedido de prosseguir com cadastro.

Dado que todas as validações foram feitas

Quando estiverem de acordo com o especificado

Então o usuário deve criar sua senha e confirmá-la.

Dado que o usuário está criando uma senha

Então ele deve visualizar as instruções para criá-la (Instruções 01).

Dado que o usuário informou a senha e clicou em [CONCLUIR]

Quando as duas senhas (Senha e Confirmar senha) forem iguais e cumprirem os critérios

Então deve ser apresentada uma mensagem de sucesso (Mensagem 04) e ele deve ser direcionado para a home da plataforma.

Dado que o usuário informou a senha e clicou em [CONCLUIR]

Quando as duas senhas (Senha e Confirmar senha) não forem iguais e/ou não cumprirem os critérios

Então deve ser apresentada uma mensagem de erro abaixo dos campos (Mensagem 05) e ele deve ser impedido de concluir o cadastro.

Anexo — critérios de aceite:
Mensagem 01:
Incluir nome completo.

Mensagem 02:
E-mail inválido.

Mensagem 03:
É preciso aceitar os Termos para prosseguir.

Mensagem 04:
Usuário cadastrado com sucesso.

Mensagem 05:
Senha inválida.

Instruções 01:

  • A senha deve conter no mínimo 6 caracteres.
  • A senha deve conter no mínimo um caractere especial, uma letra maiúscula e um número.

Acima, foi contemplado o processo evolutivo de uma estória de usuário de forma simples e detalhada, desde sua concepção até ser finalizada e entregue para o time de desenvolvimento.

Princípios básicos

Para criar uma estória de usuário, é importante seguir alguns princípios básicos:

  • Ter o usuário/ator como centro do que se planeja entregar.
  • Entregar valor para o negócio e para o usuário.

A segunda é provavelmente a pergunta mais importante a ser respondida, e deve fazer parte do dia a dia do Product Owner. Qual valor estou entregando ao finalizar essa estória de usuário?

Para nos auxiliar na escrita, devemos também considerar o modelo INVEST:

É importante ressaltar que essa é apenas uma das maneiras de se escrever estórias de usuário. A linguagem, estrutura e organização devem ser elaboradas pensando na melhor forma de atender o time no qual você está inserido.

“Nós somos o que fazemos repetidamente. Excelência, portanto, não é um ato, mas um hábito.” (Aristóteles)

Obrigado por ler até aqui! Espero que o conteúdo possa ser útil no seu fluxo de trabalho.

Na ioasys, usamos a diversidade como catalisador criativo para transformar problemas complexos em soluções simples, por meio de processos de inovação estruturados.

Assim, facilitamos a transformação digital de empresas ousadas e cocriamos experiências únicas de pessoas para pessoas. Se interessou pelo assunto? Venha nos conhecer!

--

--