16 min leitura • Guide 784 of 877
Lista de Verificação de Definição de Pronto
"Pronto" significa mais do que "código completo." O GitScrum ajuda as equipes a definir e rastrear critérios de conclusão para que o trabalho esteja verdadeiramente finalizado.
Definição de Pronto
Lista de Verificação Padrão
DEFINIÇÃO DE PRONTO DA EQUIPE:
┌─────────────────────────────────────────────────────────────┐
│ │
│ UMA HISTÓRIA ESTÁ PRONTA QUANDO: │
│ │
│ CÓDIGO: │
│ ☐ Código escrito e auto-revisado │
│ ☐ Código segue guia de estilo da equipe │
│ ☐ Nenhuma dívida técnica conhecida introduzida │
│ ☐ Nenhum valor hard-coded ou segredos │
│ │
│ TESTES: │
│ ☐ Testes unitários escritos e passando │
│ ☐ Testes de integração passando │
│ ☐ Testes manuais concluídos │
│ ☐ Casos extremos cobertos │
│ ☐ Nenhuma regressão em recursos existentes │
│ │
│ REVISÃO: │
│ ☐ Revisão de código concluída (pelo menos 1 revisor) │
│ ☐ Comentários da revisão endereçados │
│ ☐ Revisor aprovou │
│ │
│ DOCUMENTAÇÃO: │
│ ☐ Comentários no código onde necessários │
│ ☐ Documentação da API atualizada (se aplicável) │
│ ☐ Documentação do usuário atualizada (se voltada ao usuário) │
│ ☐ README atualizado (se mudanças de configuração) │
│ │
│ IMPLANTAÇÃO: │
│ ☐ Mesclado na branch principal │
│ ☐ Pipeline CI/CD passando │
│ ☐ Implantado em staging │
│ ☐ Verificado funcionando em staging │
│ │
│ ACEITAÇÃO: │
│ ☐ Critérios de aceitação atendidos │
│ ☐ PO revisou e aprovou │
│ │
│ TODOS OS ITENS DEVEM SER MARCADOS PARA "PRONTO" │
└─────────────────────────────────────────────────────────────┘
Níveis de Pronto
PRONTO EM DIFERENTES NÍVEIS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ TAREFA PRONTA: │
│ ──────────── │
│ Tarefa individual concluída dentro de uma história │
│ ☐ Trabalho da tarefa concluído │
│ ☐ Commitado na branch do recurso │
│ │
│ HISTÓRIA PRONTA: │
│ ───────────── │
│ História do usuário totalmente implementada │
│ ☐ Todas as tarefas concluídas │
│ ☐ Lista completa de DoD atendida │
│ ☐ Critérios de aceitação verificados │
│ ☐ Pronto para demo │
│ │
│ SPRINT PRONTO: │
│ ──────────── │
│ Incremento do sprint potencialmente implantável │
│ ☐ Todas as histórias comprometidas prontas │
│ ☐ Nenhum bug crítico │
│ ☐ Notas de versão atualizadas │
│ ☐ Demo pronta │
│ │
│ RELEASE PRONTO: │
│ ───────────── │
│ Pronto para produção │
│ ☐ Todas as funcionalidades prontas │
│ ☐ Performance testada │
│ ☐ Segurança revisada │
│ ☐ Documentação completa │
│ ☐ Aprovação dos stakeholders │
│ ☐ Plano de implantação pronto │
│ │
│ CADA NÍVEL SE CONSTRÓI SOBRE O ANTERIOR │
└─────────────────────────────────────────────────────────────┘
Listas de Verificação de Tarefas
Listas Incorporadas
TAREFA COM LISTA DE VERIFICAÇÃO DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ STORY-123: Adicionar funcionalidade de reset de senha │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ CRITÉRIOS DE ACEITAÇÃO: ││
│ │ ☑ Usuário pode solicitar reset da página de login ││
│ │ ☑ Email enviado com link de reset ││
│ │ ☑ Link expira após 24 horas ││
│ │ ☑ Usuário pode definir nova senha ││
│ │ ││
│ │ DEFINIÇÃO DE PRONTO: ││
│ │ ☑ Código revisado por @senior-dev ││
│ │ ☑ Testes unitários (cobertura: 85%) ││
│ │ ☑ Testes de integração passando ││
│ │ ☑ Testes manuais concluídos ││
│ │ ☐ Implantado em staging ││
│ │ ☐ Verificado em staging ││
│ │ ☐ PO aprovou ││
│ │ ││
│ │ STATUS: Em Revisão (5/7 concluídos) ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ NÃO PODE MOVER PARA "PRONTO" ATÉ TODOS MARCADOS │
└─────────────────────────────────────────────────────────────┘
DoD Específico por Tipo
DOD POR TIPO DE TRABALHO:
┌─────────────────────────────────────────────────────────────┐
│ │
│ DoD de FUNCIONALIDADE: │
│ DoD Padrão + : │
│ ☐ Feature flag criado (se aplicável) │
│ ☐ Eventos de analytics adicionados │
│ ☐ Acessibilidade verificada │
│ ☐ Responsivo para mobile │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ DoD de CORREÇÃO DE BUG: │
│ DoD Padrão + : │
│ ☐ Causa raiz identificada e documentada │
│ ☐ Teste adicionado para prevenir regressão │
│ ☐ Relator original notificado │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ DoD de MUDANÇA DE API: │
│ DoD Padrão + : │
│ ☐ Documentação da API atualizada │
│ ☐ Entrada no changelog adicionada │
│ ☐ Compatibilidade retroativa verificada (ou quebra notada)│
│ ☐ Equipes cliente notificadas se quebra │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ DoD de INFRAESTRUTURA: │
│ DoD Padrão + : │
│ ☐ Runbook atualizado │
│ ☐ Monitoramento/alertas configurados │
│ ☐ Plano de rollback documentado │
│ ☐ Impacto de custo revisado │
└─────────────────────────────────────────────────────────────┘
Evoluindo DoD
Melhorando a Definição
EVOLUÇÃO DA DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ DoD DEVE EVOLUIR COM A EQUIPE: │
│ │
│ EQUIPE INICIANTE (Mínima): │
│ ☐ Código escrito │
│ ☐ Testado manualmente │
│ ☐ Código revisado │
│ ☐ Mesclado │
│ │
│ ↓ Após 3 meses, adicionar: │
│ │
│ EQUIPE AMADURECENDO: │
│ ☐ Código escrito │
│ ☐ Testes unitários passando │
│ ☐ Código revisado │
│ ☐ Mesclado │
│ ☐ Implantado em staging │
│ ☐ QA verificou │
│ │
│ ↓ Após 6 meses, adicionar: │
│ │
│ EQUIPE MADURA: │
│ ☐ Código escrito (guia de estilo seguido) │
│ ☐ Testes unitários + integração passando │
│ ☐ Revisão de código aprovada │
│ ☐ Mesclado na principal │
│ ☐ Pipeline CI/CD verde │
│ ☐ Implantado em staging │
│ ☐ QA verificou │
│ ☐ Documentação atualizada │
│ ☐ PO aceitou │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ PERGUNTA DA RETRO: │
│ "Nossa DoD está capturando problemas antes da produção?" │
│ "O que devemos adicionar ou remover?" │
│ │
│ NÃO: Adicionar tudo de uma vez │
│ FAÇA: Adicionar incrementalmente conforme capacidade cresce│
└─────────────────────────────────────────────────────────────┘
Lacunas Comuns
O que é Perdido
ANTI-PADRÕES DA DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ "QUASE PRONTO": │
│ ───────────── │
│ "Código está pronto, só precisa de testes" │
│ "Pronto exceto pela revisão de código" │
│ "Mesclado, mas ainda não implantado" │
│ │
│ CORREÇÃO: Nenhum desses está pronto │
│ Todos os itens da DoD devem estar completos │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ "PRONTO MAS...": │
│ ────────────── │
│ "Pronto mas há um pequeno bug" │
│ "Pronto mas os testes são instáveis" │
│ "Pronto mas docs não estão atualizadas" │
│ │
│ CORREÇÃO: Não está pronto, mover de volta para Em Progresso│
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ ATALHOS DA DOD: │
│ ───────────── │
│ "Vamos pular a revisão de código para este" │
│ "Adicionaremos testes depois" │
│ "Docs podem esperar até o próximo sprint" │
│ │
│ CORREÇÃO: DoD é não-negociável │
│ Se não puder atender DoD, não se comprometa com a história│
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ TRABALHO INVISÍVEL: │
│ ─────────────── │
│ Trabalho não no quadro │
│ "Apenas uma correção rápida" │
│ "É muito pequeno para rastrear" │
│ │
│ CORREÇÃO: Todo trabalho no quadro, todo trabalho atende DoD│
│ Nenhum trabalho invisível │
└─────────────────────────────────────────────────────────────┘
Aplicando DoD
APLICAÇÃO DA DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ REGRAS DE WORKFLOW: │
│ │
│ GitScrum pode aplicar: │
│ • Não pode mover para Pronto sem lista completa │
│ • Campos obrigatórios antes da mudança de status │
│ • Verificações automatizadas (CI passando, aprovações) │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ RESPONSABILIDADE COLETIVA: │
│ │
│ No standup: │
│ "STORY-123 está realmente pronta?" │
│ "Completamos todos os itens da DoD?" │
│ │
│ Na demo: │
│ "Todas as histórias mostradas atendem nossa DoD" │
│ "Implantadas em staging e verificadas" │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ AUDITORIA DA DOD (Mensal): │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ AUDITORIA-DOD: Revisão de Conformidade de Janeiro ││
│ │ ││
│ │ Histórias concluídas: 24 ││
│ │ Conformidade completa DoD: 22 (92%) ││
│ │ Conformidade parcial: 2 (8%) ││
│ │ ││
│ │ LACUNAS ENCONTRADAS: ││
│ │ • STORY-145: Testes de integração faltando ││
│ │ • STORY-152: Docs não atualizadas ││
│ │ ││
│ │ AÇÃO: ││
│ │ • Discutir na retro ││
│ │ • Adicionar itens faltantes ││
│ │ • Lembrar equipe da importância ││
│ └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘
Soluções Relacionadas
- Melhores práticas de revisão de código
- Integração de garantia de qualidade
- Melhores práticas de planejamento de sprint
Definição de Pronto
Checklist Padrão
DEFINIÇÃO DE PRONTO EQUIPE:
┌─────────────────────────────────────────────────────────────┐
│ │
│ UMA HISTÓRIA ESTÁ PRONTA QUANDO: │
│ │
│ CÓDIGO: │
│ ☐ Código escrito e auto-revisado │
│ ☐ Código segue guia estilo equipe │
│ ☐ Nenhuma dívida técnica conhecida introduzida │
│ ☐ Nenhum valor hard-coded ou segredos │
│ │
│ TESTE: │
│ ☐ Testes unitários escritos e passando │
│ ☐ Testes integração passando │
│ ☐ Teste manual completado │
│ ☐ Casos extremos cobertos │
│ ☐ Nenhuma regressão em features existentes │
│ │
│ REVISÃO: │
│ ☐ Revisão código completada (pelo menos 1 revisor) │
│ ☐ Comentários revisão endereçados │
│ ☐ Revisor aprovou │
│ │
│ DOCUMENTAÇÃO: │
│ ☐ Comentários código onde necessário │
│ ☐ Documentação API atualizada (se aplicável) │
│ ☐ Documentação usuário atualizada (se user-facing) │
│ ☐ README atualizado (se mudanças setup) │
│ │
│ IMPLANTAÇÃO: │
│ ☐ Mesclado para branch main │
│ ☐ Pipeline CI/CD passando │
│ ☐ Implantado em staging │
│ ☐ Verificado funcionando em staging │
│ │
│ ACEITAÇÃO: │
│ ☐ Critérios aceitação atendidos │
│ ☐ PO revisou e aprovou │
│ │
│ TODOS ITENS DEVEM SER MARCADOS PARA "PRONTO" │
└─────────────────────────────────────────────────────────────┘
Níveis de Pronto
PRONTO EM DIFERENTES NÍVEIS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ TAREFA PRONTA: │
│ ──────────── │
│ Tarefa individual completada dentro história │
│ ☐ Trabalho tarefa completado │
│ ☐ Committed para feature branch │
│ │
│ HISTÓRIA PRONTA: │
│ ───────────── │
│ User story totalmente implementada │
│ ☐ Todas tarefas completas │
│ ☐ Checklist DoD completo atendido │
│ ☐ Critérios aceitação verificados │
│ ☐ Pronto para demo │
│ │
│ SPRINT PRONTO: │
│ ──────────── │
│ Incremento sprint potencialmente shippable │
│ ☐ Todas histórias comprometidas prontas │
│ ☐ Nenhum bug crítico │
│ ☐ Notas release atualizadas │
│ ☐ Demo pronto │
│ │
│ RELEASE PRONTO: │
│ ───────────── │
│ Pronto para produção │
│ ☐ Todas features prontas │
│ ☐ Performance testado │
│ ☐ Segurança revisada │
│ ☐ Documentação completa │
│ ☐ Aprovação stakeholder │
│ ☐ Plano implantação pronto │
│ │
│ CADA NÍVEL CONSTRÓI NO ANTERIOR │
└─────────────────────────────────────────────────────────────┘
Checklists Tarefa
Checklists Embutidas
TAREFA COM CHECKLIST DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ STORY-123: Adicionar funcionalidade reset senha │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ CRITÉRIOS ACEITAÇÃO: ││
│ │ ☑ Usuário pode solicitar reset da página login ││
│ │ ☑ Email enviado com link reset ││
│ │ ☑ Link expira após 24 horas ││
│ │ ☑ Usuário pode definir nova senha ││
│ │ ││
│ │ DEFINIÇÃO DE PRONTO: ││
│ │ ☑ Código revisado por @senior-dev ││
│ │ ☑ Testes unitários (cobertura: 85%) ││
│ │ ☑ Testes integração passando ││
│ │ ☑ Teste manual completado ││
│ │ ☐ Implantado em staging ││
│ │ ☐ Verificado em staging ││
│ │ ☐ PO aprovou ││
│ │ ││
│ │ STATUS: Em Revisão (5/7 pronto) ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ NÃO PODE MOVER PARA "PRONTO" ATÉ TUDO MARCADO │
└─────────────────────────────────────────────────────────────┘
DoD Específico Tipo
DOD POR TIPO TRABALHO:
┌─────────────────────────────────────────────────────────────┐
│ │
│ FEATURE DoD: │
│ DoD Padrão + : │
│ ☐ Feature flag criado (se aplicável) │
│ ☐ Eventos analytics adicionados │
│ ☐ Acessibilidade verificada │
│ ☐ Mobile responsive │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ BUG FIX DoD: │
│ DoD Padrão + : │
│ ☐ Causa raiz identificada e documentada │
│ ☐ Teste adicionado para prevenir regressão │
│ ☐ Reportador original notificado │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ API CHANGE DoD: │
│ DoD Padrão + : │
│ ☐ Documentação API atualizada │
│ ☐ Entrada changelog adicionada │
│ ☐ Compatibilidade backward verificada (ou breaking notado)│
│ ☐ Equipes cliente notificadas se breaking │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ INFRASTRUCTURE DoD: │
│ DoD Padrão + : │
│ ☐ Runbook atualizado │
│ ☐ Monitoramento/alerting configurado │
│ ☐ Plano rollback documentado │
│ ☐ Impacto custo revisado │
└─────────────────────────────────────────────────────────────┘
Evoluindo DoD
Melhorando Definição
EVOLUÇÃO DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ DOD DEVE EVOLUIR COM EQUIPE: │
│ │
│ EQUIPE INICIANTE (Mínimo): │
│ ☐ Código escrito │
│ ☐ Testado manualmente │
│ ☐ Código revisado │
│ ☐ Mesclado │
│ │
│ ↓ Após 3 meses, adicionar: │
│ │
│ EQUIPE AMADURECENDO: │
│ ☐ Código escrito │
│ ☐ Testes unitários passando │
│ ☐ Código revisado │
│ ☐ Mesclado │
│ ☐ Implantado em staging │
│ ☐ QA verificou │
│ │
│ ↓ Após 6 meses, adicionar: │
│ │
│ EQUIPE MADURA: │
│ ☐ Código escrito (guia estilo seguido) │
│ ☐ Testes unitários + integração passando │
│ ☐ Revisão código aprovada │
│ ☐ Mesclado para main │
│ ☐ Pipeline CI/CD verde │
│ ☐ Implantado em staging │
│ ☐ QA verificou │
│ ☐ Documentação atualizada │
│ ☐ PO aceitou │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ PERGUNTA RETRO: │
│ "Nossa DoD está pegando problemas antes produção?" │
│ "O que devemos adicionar ou remover?" │
│ │
│ NÃO: Adicione tudo de uma vez │
│ SIM: Adicione incrementalmente conforme capacidade equipe cresce
└─────────────────────────────────────────────────────────────┘
Lacunas Comuns
O Que É Perdido
ANTI-PADRÕES DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ "QUASE PRONTO": │
│ ───────────── │
│ "Código está pronto, só precisa teste" │
│ "Pronto exceto revisão código" │
│ "Mesclado, mas não implantado ainda" │
│ │
│ FIX: Nenhum destes está pronto │
│ Todos itens DoD devem estar completos │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ "PRONTO MAS...": │
│ ────────────── │
│ "Pronto mas há um bug pequeno" │
│ "Pronto mas testes são flaky" │
│ "Pronto mas docs não atualizadas" │
│ │
│ FIX: Não pronto, mova de volta para Em Progresso │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ ATALHOS DOD: │
│ ──────────── │
│ "Vamos pular revisão código para este" │
│ "Adicionaremos testes depois" │
│ "Docs podem esperar próximo sprint" │
│ │
│ FIX: DoD é não-negociável │
│ Se não pode atender DoD, não comprometa com história │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ TRABALHO INVISÍVEL: │
│ ──────────────── │
│ Trabalho não no board │
│ "Apenas uma correção rápida" │
│ "É pequeno demais para rastrear" │
│ │
│ FIX: Todo trabalho no board, todo trabalho atende DoD │
│ Nenhum trabalho invisível │
└─────────────────────────────────────────────────────────────┘
Aplicando DoD
APLICAÇÃO DOD:
┌─────────────────────────────────────────────────────────────┐
│ │
│ REGRAS WORKFLOW: │
│ │
│ GitScrum pode aplicar: │
│ • Não pode mover para Pronto sem checklist completo │
│ • Campos obrigatórios antes mudança status │
│ • Verificações automatizadas (CI passando, aprovações) │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ CONTABILIDADE PARE: │
│ │
│ Em standup: │
│ "STORY-123 está realmente pronta?" │
│ "Completamos todos itens DoD?" │
│ │
│ Em demo: │
│ "Todas histórias mostradas atendem nossa DoD" │
│ "Implantado em staging e verificado" │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ AUDITORIA DOD (Mensal): │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ DOD-AUDIT: Revisão Compliance Janeiro ││
│ │ ││
│ │ Histórias completadas: 24 ││
│ │ Compliance DoD completo: 22 (92%) ││
│ │ Compliance parcial: 2 (8%) ││
│ │ ││
│ │ LACUNAS ENCONTRADAS: ││
│ │ • STORY-145: Faltando testes integração ││
│ │ • STORY-152: Docs não atualizadas ││
│ │ ││
│ │ AÇÃO: ││
│ │ • Discutir em retro ││
│ │ • Adicionar itens faltantes ││
│ │ • Lembrar equipe da importância ││
│ └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘