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.

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:
| C | O que é | Na prática |
|---|---|---|
| Cartão | A frase curta, registrada em algum lugar | Uma linha no quadro ou no Jira |
| Conversa | A discussão entre quem pede e quem constrói | Onde os detalhes aparecem de verdade |
| Confirmação | Os critérios que dizem que está pronto | Testes 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
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.
Continuar lendo · Design & Produto

Design & Produto
Como fazer a jornada do cliente: passo a passo
Como fazer a jornada do cliente do primeiro contato ao pós-venda: os cinco elementos do mapa, o passo a passo com pesquisa real e o que fazer com o resultado.

Design & Produto
Lovable: como usar para criar um app com IA
Lovable: como usar a ferramenta para criar um app com IA a partir de uma descrição, como funcionam os créditos e quais cuidados tomar antes de colocar no ar.

Design & Produto
Como fazer mapa de empatia: guia prático para PMEs
Como fazer mapa de empatia com base em evidência: os quatro quadrantes, o passo a passo em oficina e os erros que transformam a ferramenta em suposição.