Como escrever história de usuário: modelo e exemplos

Como escrever história de usuário com o modelo Como, quero, para que, critérios de aceite, o checklist INVEST e exemplos para quem contrata sistema sob medida.

Eric Grassi6 min de leitura
Como escrever história de usuário: modelo e exemplos

Para escrever uma história de usuário, descreva em uma frase quem precisa de algo, o que precisa e por quê, no formato "Como [tipo de usuário], quero [ação], para que [benefício]", e complete com critérios de aceite que digam quando a história está pronta. A frase não é a especificação inteira. Ela é o lembrete de uma conversa entre quem pede e quem constrói.

Para o dono de uma empresa que vai contratar um sistema sob medida, um portal ou uma automação, saber escrever histórias de usuário muda a qualidade da entrega. É a diferença entre pedir "um módulo de pedidos" e explicar o que o vendedor precisa conseguir fazer, e por quê.

O que é história de usuário?

História de usuário é uma descrição curta de uma funcionalidade desejada, escrita do ponto de vista de quem vai usá-la. Mike Cohn, autor de referência no tema, reforça que ela deve apontar para um resultado com significado, e não para uma tarefa interna da equipe de desenvolvimento.

A ideia vem dos métodos ágeis. A Agile Alliance registra o modelo dos 3 Cs, proposto por Ron Jeffries em 2001:

CO que éNa prática
CartãoA frase curta, registrada em algum lugarUma linha no quadro ou no Jira
ConversaA discussão entre quem pede e quem constróiOnde os detalhes aparecem de verdade
ConfirmaçãoOs critérios que dizem que está prontoTestes de aceite

Quem só escreve o cartão e pula a conversa volta ao problema que a história deveria resolver: requisito mal entendido.

O modelo, parte por parte

"Como [tipo de usuário]" define quem se beneficia. Seja específico: "como vendedor externo" é melhor que "como usuário".

"quero [ação]" descreve o que a pessoa precisa conseguir fazer, sem dizer como a tela deve ser.

"para que [benefício]" explica o porquê. É a parte mais esquecida e a mais valiosa, porque permite que quem constrói proponha uma solução melhor do que a pedida.

Mike Cohn lembra que o modelo é uma ferramenta de pensamento, não uma obrigação. Se outro formato deixa a necessidade mais clara, vale usá-lo.

Exemplos de história de usuário em uma PME

Fraca: "Criar tela de pedidos."

Melhor: "Como vendedor externo, quero registrar o pedido do cliente pelo celular durante a visita, para que o pedido chegue ao faturamento no mesmo dia, sem eu precisar digitar de novo no escritório."

Critérios de aceite:

  • O vendedor vê apenas os clientes da carteira dele.
  • O preço exibido é o da tabela do cliente.
  • Funciona sem internet e sincroniza quando a conexão volta.
  • O pedido aparece no ERP com status "aguardando faturamento".

Outro exemplo, em uma clínica:

"Como recepcionista, quero ver na agenda quais pacientes ainda não confirmaram a consulta de amanhã, para que eu possa ligar só para eles antes do fim do expediente."

O checklist INVEST

A Agile Alliance atribui a Bill Wake, em 2003, o checklist INVEST para avaliar se uma história está bem escrita:

  • Independente: pode ser entregue sem depender de outra.
  • Negociável: não é contrato fechado, abre espaço para conversa.
  • Valiosa: entrega algo útil a alguém.
  • Estimável: a equipe consegue dimensionar o esforço.
  • Small (pequena): cabe em um ciclo curto de trabalho.
  • Testável: dá para verificar se está pronta.

Se a história falha em "pequena" ou "estimável", provavelmente é grande demais e precisa ser quebrada.

Épicos, histórias e tarefas

  • Épico: uma história grande, como "venda pelo portal B2B". Serve para lembrar uma capacidade importante antes de conhecer os detalhes.
  • História: um pedaço do épico que entrega valor sozinho, como "cliente repete um pedido anterior com um clique".
  • Tarefa: o trabalho técnico para entregar a história. Tarefa é da equipe, história é do usuário.

Cohn recomenda quebrar histórias por fatia de valor, e não por camada técnica. "Criar o banco de dados" não é história.

Os erros mais comuns

Uma boa história de usuário não descreve a solução. Descreve o problema bem o bastante para que a solução certa apareça na conversa.

  • Escrever a solução no lugar da necessidade. "Quero um botão azul no canto" esconde o porquê.
  • Usuário genérico. "Como usuário" apaga a diferença entre quem opera e quem gerencia.
  • Esquecer o "para que". Sem ele, ninguém consegue avaliar se há um caminho mais simples.
  • Detalhar tudo no começo. Histórias distantes podem ser vagas. O detalhe entra quando a história se aproxima do desenvolvimento.
  • Pular a conversa. Mandar uma lista de histórias por e-mail e esperar a entrega é voltar ao documento de requisitos, com outro formato.

Esses cuidados importam ainda mais quando ferramentas de IA aceleram a construção. Como discutimos em construir rápido a coisa errada, velocidade sem clareza só antecipa o retrabalho.

Perguntas frequentes

Quem deve escrever as histórias de usuário?

Quem conhece a necessidade, com participação de quem vai construir. Na empresa, normalmente o gestor da área com o fornecedor ou o time técnico. Cohn recomenda incluir os desenvolvedores desde a escrita.

Qual a diferença entre história de usuário e requisito?

O requisito tradicional descreve o que o sistema deve fazer. A história descreve o que uma pessoa precisa conseguir e por quê, e deixa os detalhes para a conversa e os critérios de aceite.

Preciso de Jira para usar histórias de usuário?

Não. Uma planilha ou um quadro simples funcionam. Ferramentas de gestão ajudam quando o volume cresce e várias pessoas trabalham ao mesmo tempo.

IA pode escrever histórias de usuário?

Pode ajudar a reescrever, padronizar e sugerir critérios de aceite a partir de anotações reais. Não substitui saber quem é o usuário e qual o benefício esperado.

Antes de contratar o próximo sistema

Escrever histórias de usuário é um jeito disciplinado de pensar no usuário antes de pensar na tela. Se quiser ver o processo completo, inclusive como organizar as histórias no Jira e usar IA para refiná-las, o tutorial do canal mostra o passo a passo.

👉 Assista ao tutorial completo sobre histórias de usuário no canal do Eric

Fontes

<!-- link interno sugerido: metodo-moscow-como-priorizar --> <!-- link interno sugerido: mvp-como-validar-uma-ideia-de-negocio -->

Quem escreve

Eric Grassi

Eric Grassi

Consultor de inovação e fundador da Digital Inova Lab

Mais de uma década entre estratégia, design e tecnologia aplicada: startup própria, mercado corporativo, grandes empresas, aceleração estruturada e um programa de inovação corporativa. Hoje ajuda donos de empresas em transformação a ganhar clareza e aplicar IA e automação com método.

Aplicar

Quer aplicar isso no seu negócio?

Uma conversa gratuita pra entender o seu contexto e decidir, juntos, se faz sentido seguir.