O que um ticket deve incluir
Descreve o problema, a pessoa ou processo afetado, o comportamento esperado e o âmbito. Junta fontes relevantes, dependências e critérios de aceitação verificáveis. Marca decisões em aberto e indica quem as resolve. O comprimento não mede a qualidade: um erro pequeno não precisa de um modelo extenso, mas uma integração arriscada exige mais contexto.
Funcionalidade: exportação de clientes
Antes: «Adicionar botão para exportar clientes». Faltam permissões, filtros, formato e dados abrangidos.
Depois: «Na área Clientes, uma pessoa autorizada deve poder exportar a lista filtrada, incluindo linhas fora da página visível. Excluem-se envios por e-mail e exportações recorrentes. Antes de começar, Product Ownership confirma que permissão existente se aplica, que colunas com dados pessoais são permitidas e o que acontece sem resultados. Ligam-se a documentação da API e o desenho dos estados de carregamento e erro». Os critérios definitivos vêm depois destas decisões.
Erro: formulário nem sempre guarda
Antes: «Guardar falha às vezes».
Depois: «Em ambiente de teste, editar a morada de um cliente devolve ocasionalmente HTTP 409. Esperado: nova morada e confirmação. Real: morada anterior sem mensagem de erro. Passos: abrir um cliente, mudar a morada e carregar duas vezes em Guardar em cinco segundos; ocorreu em três de cinco tentativas. Juntam-se o identificador do pedido e a versão do navegador». Permite investigar sem presumir uma causa.
Tarefa técnica: atualizar a framework
Antes: «Atualizar Laravel».
Depois: «Atualizar a aplicação de Laravel 10 para uma versão acordada de Laravel 11. Antes, confirmar a compatibilidade de PHP e pacotes. Manter os contratos da API pública, atualizar o ficheiro de dependências e executar testes unitários e de integração. Em staging, verificar início de sessão e criação de faturas. Registar pacotes incompatíveis para decisão separada». Não é preciso convertê-la numa história de utilizador artificial.
Mudança de interface: mostrar o erro junto ao campo
Antes: «Tornar o formulário mais intuitivo».
Depois: «Em telemóveis, o erro do código postal obrigatório passa despercebido porque aparece abaixo do botão de compra. Mostrá-lo junto ao campo segundo o padrão existente e colocar aí o foco. Com entrada válida, continuar a compra. Confirmar texto e desenho antes da implementação».
Usa a checklist de prontidão para encontrar lacunas. Redige resultados confirmados com o guia de critérios e usa a ferramenta de preparação de tarefas antes do refinement.