Hierarquia do backlog
TEMA
└── ÉPICO
└── FEATURE
└── USER STORY
└── TAREFA (nível do DEV)| Nível | O que é | Exemplo | Quem escreve |
|---|---|---|---|
| Tema | Área estratégica do produto | Gestão de Vendas | PO / Gerência |
| Épico | Conjunto de funcionalidades que entregam valor maior | Registro e aprovação de pedidos | Analista + PO |
| Feature | Funcionalidade específica dentro do épico | Registrar pedido manual | Analista |
| User Story | Comportamento do ponto de vista do usuário | Validar desconto ao registrar pedido | Analista |
| Tarefa | Trabalho técnico para implementar a US | Criar endpoint POST /pedidos | DEV |
Convenções de nomenclatura
| Artefato | Formato | Exemplo |
|---|---|---|
| Épico | EP-[3 dígitos] | EP-012 |
| User Story | US-[4 dígitos] | US-0047 |
| Caso de Uso | UC-[3 dígitos] | UC-023 |
| Regra de Negócio | RN-[3 dígitos] | RN-008 |
| Bug Report | BUG-[ano]-[4 dígitos] | BUG-2025-0134 |
| Req. Não Funcional | RNF-[3 dígitos] | RNF-005 |
Títulos de User Story
Registrar pedido de venda manual
Validar desconto aplicado por vendedor
Notificar gestor sobre pedido aguardando aprovação
"Pedido" — sem verbo, sem contexto
"O sistema deve permitir que o vendedor faça pedidos" — longo demais
"Tela de pedidos" — nome de tela, não comportamento
Vocabulário padrão
| Usar | Não usar | Por quê |
|---|---|---|
| Critério de aceite | Requisito de aceite, regra de validação | Termo padrão em agilidade |
| Fluxo principal | Caminho feliz, fluxo ideal | Mais formal e preciso |
| Fluxo de exceção | Caso de erro, cenário de falha | Reservado para falhas técnicas |
| Persona | Tipo de usuário, perfil | Termo padrão em UX e agilidade |
| Épico | Grande história, feature grande | Termo padrão Scrum/SAFe |
| Definition of Done | Critério de conclusão | Termo padrão Scrum |
Antipadrões — o que NÃO fazer
Como usuário, quero fazer login.
"Usuário" não diz nada — cada DEV vai interpretar diferente.
Então o sistema funciona corretamente.
O QA não sabe o que testar.
Como vendedor, quero registrar pedidos, consultar histórico, emitir relatórios e cancelar pedidos.
Impossível implementar e testar de forma incremental.
O fluxo principal é o caminho feliz, sem desvios. Condicionais vão nos fluxos alternativos.
Regras de ouro do Gherkin
- "Dado" descreve estado, não ação: ✅ "Dado que o usuário está autenticado" ❌ "Dado que o usuário fez login"
- "Quando" é UMA única ação do ator — se há duas ações, são dois "Quando" ou dois cenários
- "Então" deve ser verificável sem ambiguidade: ✅ 'Então o sistema exibe "Pedido registrado — PED-2025-000123"' ❌ "Então o pedido é salvo corretamente"
- Um cenário = um comportamento — não coloque dois comportamentos independentes no mesmo cenário
- Nomeie os cenários de forma isolada: ✅ "Pedido aprovado automaticamente quando valor inferior a R$ 10.000" ❌ "Teste 1"
Guia de escrita — clareza e precisão
O sistema deve responder rapidamente
O campo aceita textos longos
Enviar notificação em breve após a ação
O sistema deve responder em até 2 segundos (95% das requisições)
O campo aceita até 500 caracteres
Enviar notificação em até 5 minutos após a confirmação
Padrão de versionamento
--- ID: US-0047 Título: Registrar pedido de venda manual Versão: 1.2 Status: Aprovado ← [Rascunho | Em revisão | Aprovado | Obsoleto] Autor: [Nome] Revisado por: [Nome] Data de criação: 15/01/2025 Última atualização: 22/01/2025 Módulo: Gestão de Vendas Épico: EP-003 — Registro e aprovação de pedidos --- ## Histórico de alterações | Versão | Data | Autor | O que mudou | |---|---|---|---| | 1.0 | 15/01/2025 | Ana | Criação inicial | | 1.1 | 18/01/2025 | Ana | Adicionado cenário de estoque insuficiente | | 1.2 | 22/01/2025 | Ana | Regra RN-05 ajustada após reunião com comercial |
Pacote mínimo por tipo de demanda
| Tipo | Obrigatório | Recomendado |
|---|---|---|
| Correção de bug | Bug Report | Print / log de evidência |
| Feature pequena | User Story completa | Wireframe (se houver tela) |
| Feature média/grande | US + Caso de Uso + Fluxo | Diagrama de sequência se integração |
| Novo módulo | Épicos + todas USs + UCs principais + Fluxos | Schema de banco |