Como sincronizar story points com o Jira

Você pode fazer planning poker direto no seu backlog do Jira: importe as issues para uma sala, estime em time, e tenha os story points aceitos escritos de volta em cada issue automaticamente, sem copiar na mão. Isso remove o passo lento e sujeito a erro do fim da maioria das sessões, em que alguém digita os números nos tickets um por um. Abaixo: como conectar o Jira, importar issues, estimar e enviar os pontos de volta, mais como estimar bem depois de configurado.

Ainda escolhendo uma ferramenta? Veja por que os times usam planning poker para Jira sem instalar um app do Marketplace.

O que você precisa

• Um site Jira Cloud. (Jira Data Center não é suportado.)
• Uma conta Jira que possa navegar no projeto (para importar issues) e editar issues nele (para escrever a estimativa de volta). Uma conta compartilhada criada para isso, como [email protected], funciona melhor que a de uma pessoa, já que o token para de funcionar quando essa pessoa sai.
• A permissão de gerenciar o Planning Poker na sua organização, para conectar o Jira. Owners têm por padrão.

Passo 1: conecte o Jira

1. Abra Configurações → Integrações e escolha Jira, depois Conectar.
2. Conecte do jeito que preferir:

• OAuth: você é enviado à Atlassian, aprova o acesso e volta. Não há nada para copiar. Essa opção aparece quando foi configurada para o seu workspace.
• Token de API: uma chave de acesso pessoal. Preencha três campos: seu site do Jira (por exemplo https://seu-time.atlassian.net), seu e-mail da conta e o token de API. Você cria o token na própria página da Atlassian: id.atlassian.com → Security → API tokens → Create API token (o simples, não o "with scopes"). O token tem as mesmas permissões da conta que o criou. Passo a passo, com o que verificar se falhar: conectar o Jira com um token de API.

1. Use Testar para checar a conexão. Sua chave é guardada com segurança e nunca é mostrada de novo.

Passo 2: escolha para onde vai a estimativa

Logo após conectar, um passo de Configurar pergunta se a estimativa aceita deve ser enviada de volta ao Jira, e para qual campo.

• Ligue Enviar a estimativa aceita de volta.
• Escolha o campo do Jira que guarda suas estimativas. A lista mostra os campos numéricos do seu site, e Story point estimate já vem selecionado quando existe.
• Você pode mudar isso depois em Configurações de estimativa.

Não sabe qual dos dois campos de estimativa do Jira escolher? A próxima seção explica.

Story Points ou Story point estimate? Qual campo escolher

O Jira tem dois campos de estimativa parecidos, e escolher o errado é o motivo mais comum de uma estimativa não aparecer no board. Qual você precisa depende do tipo de projeto:

Dois cuidados:

• Boards customizados se comportam como company-managed. Em um board customizado só Story Points aparece como estatística de estimativa, mesmo quando o projeto é team-managed. A Atlassian recomenda usar o board criado junto com o projeto team-managed.
• Mudar o tipo do projeto pode perder estimativas. Ao migrar um projeto team-managed para company-managed, mantenha a opção "Retain" marcada para os story points virem junto.

Seja qual for o campo, garanta que ele está na tela da issue naquele projeto, senão o Jira recusa a atualização.

Passo 3: traga as issues para uma sala

1. Crie uma sala (ou abra uma existente) e escolha Importar no painel de Tarefas.
2. Escolha Jira, depois o seu projeto.
3. Reduza a lista com os filtros: sprint, epic, tipo de issue e status. Você também pode buscar por texto.
4. Selecione as issues que quiser, ou todas, e importe.

Issues que já estão na sala são marcadas, então nada é adicionado duas vezes. Cada tarefa mantém sua chave do Jira (como PROJ-142), um link de volta para a issue e as primeiras linhas da descrição.

Passo 4: estime

Conduza a sessão como sempre: abra uma tarefa, todos votam, revelem, discutam as diferenças, e aceitem a estimativa. Se você é novo no ritual, nosso guia passo a passo de planning poker mostra cada etapa. Quando você aceita a estimativa, o número é escrito na issue do Jira em instantes, sem fazer a sala esperar. O histórico da sala então mostra Estimativa enviada, ou o motivo de não ter sido.

O que é e o que não é enviado

• Números são enviados. Meios pontos também funcionam, já que o campo do Jira é numérico.
• As cartas ? e ☕ e os tamanhos de camiseta não, porque não são números. Ficam no histórico como "não enviado".

Se o seu time estima em tamanhos de camiseta, continue usando na sala, e escreva os story points no Jira na mão, ou combinem um deck numérico para as sessões que alimentam o Jira.

Estimar bem, com ou sem Jira

• Estime antes da sprint, não durante. Olhe os itens do backlog que vêm a seguir, para a sprint começar com números que todos já discutiram.
• Use uma escala e mantenha. Alternar entre Fibonacci e tamanhos de uma sessão para outra torna seu histórico impossível de comparar.
• Pontos medem esforço e incerteza, não tempo. Evite traduzi-los em horas. A velocidade das sprints passadas vai dizer quantos pontos cabem na próxima. Para o que os pontos realmente são, e não são, veja o que são story points.
• Reestime quando o escopo muda. Uma tarefa que cresceu depois da discussão merece um novo voto.

Planning poker é uma entre várias técnicas de estimativa ágil, e é a que combina mais naturalmente com escrever um único número acordado de volta em um tracker como o Jira.

Se uma estimativa não foi enviada

• "O campo não está na tela" ou um erro de permissão: confira que o campo está na tela da issue naquele projeto, e que a conta conectada pode editá-lo.
• A conexão parou de funcionar: o token pode ter sido revogado ou expirado. Use Testar na página de Integrações, e Reconectar se preciso.
• Algo não é um número: a carta ?, ☕ ou um tamanho de camiseta. Isso é esperado.

Conectar leva alguns minutos, e a partir daí os números das suas sessões caem no lugar certo sem ninguém copiar.

Perguntas frequentes

Dá para fazer planning poker dentro do Jira?

Você faz em uma sala de planning poker conectada ao Jira: importa as issues, estima em time, e os story points aceitos são escritos de volta em cada issue do Jira automaticamente, sem nada ser copiado na mão.

Em qual campo do Jira os story points entram?

No campo numérico que você escolher ao conectar, normalmente Story point estimate. Note que o Jira tem dois campos parecidos, Story points e Story point estimate, então escolha o que o seu board exibe e garanta que ele está na tela da issue.

Funciona com Jira Data Center ou Server?

Não. A integração suporta apenas Jira Cloud.

Preciso de um token de API, ou posso usar OAuth?

Qualquer um. OAuth é uma aprovação em um clique quando está configurado para o seu workspace. Um token de API é uma chave pessoal que você cria na Atlassian e cola em três campos. Os dois funcionam igual depois de conectados.

O que acontece com votos não numéricos como "?" ou tamanhos de camiseta?

Não são enviados ao Jira, porque o campo é numérico. Ficam no histórico da sala marcados como "não enviado". Se você estima em tamanhos de camiseta, adicione os pontos ao Jira na mão ou use um deck numérico nas sessões que alimentam o Jira.

O time inteiro pode estimar sem contas do Jira?

Sim. Só a conexão usa uma conta do Jira. Os colegas entram na sala por um link sem conta, e apenas a estimativa aceita é escrita de volta no Jira.