Como usar estes checklists: passe item por item — não pule. Se um item for "não", corrija antes de entregar ou documente por que não se aplica. Se ficou em dúvida em algum item, o artefato não está pronto.
Checklist 01 — User Story
Estrutura e completude
- Tem ID único no formato correto (US-XXXX)?
- Título no formato Verbo + Objeto, máximo 60 caracteres?
- Cabeçalho com versão, status, autor e data?
- Narrativa com as 3 partes: Como / Quero / Para que?
Persona e valor
- Persona específica — não é 'usuário' ou 'o sistema'?
- Persona está no vocabulário padronizado do sistema?
- 'Para que' descreve valor de negócio concreto — não é 'para facilitar'?
Regras de negócio
- Mínimo 5 regras de negócio?
- As regras têm números, não adjetivos como 'rápido' ou 'curto'?
- Regras numeradas e independentes entre si?
- Nenhuma regra está duplicada nos critérios de aceite?
Critérios de aceite
- Mínimo 1 cenário do caminho feliz?
- Mínimo 2 cenários alternativos?
- Mínimo 2 cenários de exceção / erro?
- Cada cenário tem nome descritivo?
- Todos os 'Então' são verificáveis — sem 'funciona corretamente'?
- Cenários cobrem: dado inválido, recurso indisponível, permissão negada?
Escopo e validação
- Seção 'Fora do escopo' preenchida?
- Dependências de outras USs listadas?
- APIs ou serviços externos identificados?
- US pode ser entregue em 1 sprint?
- Foi revisada por pelo menos uma pessoa além do autor?
- Aprovada pelo PO ou responsável pelo produto?
Checklist 02 — Caso de Uso
- ID, versão, data, autor e status preenchidos?
- Nome no formato Verbo + Objeto?
- Ator principal e atores secundários identificados?
- Pré-condições descrevem o estado completo necessário?
- Pós-condições de sucesso E de falha documentadas?
- Fluxo principal tem mínimo 6 passos?
- Passos alternam corretamente entre ator e sistema?
- Fluxo principal NÃO contém condicionais?
- Cada fluxo alternativo indica em qual passo do principal ocorre o desvio?
- Fluxos de exceção cobrem: dado inválido + recurso indisponível + permissão negada?
- Regras de negócio numeradas e referenciadas?
- Casos de uso relacionados referenciados?
Checklist 03 — Fluxo de Negócio
- Tem título e versão?
- Usa swimlanes se há mais de um ator?
- Terminadores de início e fim identificados?
- Formas usadas corretamente (oval, retângulo, losango)?
- Todos os losangos têm duas saídas com rótulos claros?
- Caminho feliz percorrível de início ao fim?
- Caminhos de exceção documentados?
- Fluxo validado com quem executa o processo hoje?
Checklist 04 — Diagrama de Sequência
- Todos os participantes identificados?
- Usa 'actor' para humanos e 'participant' para sistemas?
- Setas sólidas para chamadas, tracejadas para respostas?
- Cada seta tem rótulo com a ação ou dado trafegado?
- Blocos alt/else cobrem os condicionais?
- Fluxos de erro documentados (timeout, dado inválido)?
- Revisado por alguém técnico se envolve integrações?
Checklist 05 — Handoff para o DEV
- Todas as USs passaram no Checklist 01?
- Casos de uso críticos documentados?
- Fluxos principais documentados?
- Schema / campos de banco identificados?
- Integrações com sistemas externos documentadas?
- Nenhum [A DEFINIR] sem justificativa ou escalação?
- Mensagens de erro definidas com texto exato?
- Critérios de aceite claros o suficiente para o QA?
- O que está fora do escopo desta entrega está explícito?
- PO aprovou o escopo?
- Definido quem vai validar em homologação e quando?
Revisão automática com IA — cole antes de qualquer entrega
Quando usar: Antes de qualquer entrega ao DEV — cole o artefato e receba um diagnóstico de qualidade.
Você é analista de negócio sênior fazendo revisão de qualidade (QA de documentação).
Analise o artefato abaixo e verifique:
PARA USER STORY:
□ Persona específica (não genérica)?
□ Valor de negócio claro no "para que"?
□ Mínimo 5 regras de negócio mensuráveis?
□ Critérios: cenário feliz + alternativos + exceções?
□ Todos os "Então" testáveis sem ambiguidade?
□ Fora do escopo + dependências preenchidos?
PARA CASO DE USO:
□ Fluxo principal sem condicionais?
□ Cada FA com ponto de extensão identificado?
□ FEs para: dado inválido + indisponível + permissão negada?
□ Pós-condições de sucesso E falha documentadas?
PARA TODO ARTEFATO:
□ Há informações vagas ou termos indefinidos?
□ Há contradições internas?
□ Há dependências não mapeadas?
□ Há casos de exceção óbvios não cobertos?
[COLE O ARTEFATO AQUI]
Para cada problema: cite o trecho, explique e sugira a correção.
Nota final: Pronto / Ajustes menores / Revisão necessária.
Tempo estimado por artefato
| Artefato | Iniciante | Experiente | Com IA (ambos) |
|---|---|---|---|
| User Story simples | 2-3h | 45min | 30-45min |
| User Story complexa | 4-6h | 1,5-2h | 1-1,5h |
| Caso de Uso (a partir de US) | 3-4h | 1-1,5h | 45min-1h |
| Fluxo de negócio | 2-3h | 1h | 30-45min |
| Diagrama de sequência | 3-5h | 1,5-2h | 1-1,5h |
| Pacote completo (5 USs) | 2-3 dias | 1 dia | 4-6h |
Os tempos com IA incluem escrever o prompt, revisar a saída, ajustar e fazer a validação final. A IA reduz o tempo mas não elimina a revisão humana.