Sair
Manual/
Estimativas Ágeis & Consenso

Scrum Poker

Guia de Operação & Boas Práticas

O padrão ouro para estimativas ágeis. Projetado para eliminar o "Efeito Manada" e garantir que todos os riscos técnicos sejam discutidos.

Criar Sessão de Poker

Vantagem Estratégica

"Ao ocultar os votos, forçamos o cérebro a pensar de forma independente. O valor não está no número final, mas na discussão que surge quando as opiniões divergem."

Deck Recomendado

Utilize a sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21) para User Stories inteiras. Para desdobramento de sub-tarefas técnicas em refinamento fino, alterne para o deck de Horas.

Manual de Operação Passo a Passo
Siga este fluxo para conduzir uma rodada de estimativas ágil e sem atrito.
01

Criação & Pauta

O facilitador cria a sala e adiciona os itens na aba Tarefas. Cada item pode conter o link da issue no Jira e notas com critérios de aceite para consulta rápida do time.

02

Escolha do Deck

Alterne entre Fibonacci (padrão Scrum) ou Horas. Isso atualiza instantaneamente as cartas interativas disponíveis no painel de cada participante conectado.

03

Votação Silenciosa

Os participantes escolhem suas cartas em sigilo. O sistema exibe um indicador visual de quem já concluiu o voto, mas os valores só aparecem após o comando de Revelação.

04

Revelação & Consenso

Ao revelar, o sistema detecta desvios: as menores e maiores estimativas explicam seus pontos de vista técnicos. Após o alinhamento, o facilitador Salva o Consenso.

Funções Exclusivas do Facilitador

Pular tarefas (Skipped) caso o time julgue não prioritário para a rodada.

Editar estimativas individuais se algum membro errar o clique.

Comando "Limpar Mesa" para resetar votos e avançar para a próxima história.

Exportar relatório consolidado com médias, consensos e histórico em CSV/PDF.

Integração de Máquina & API
API REST & Ferramentas do Scrum Poker
Buscar estimativas de rodadas de planning poker já feitas, por texto livre.
Header: X-Api-Key

Como Obter sua Chave e Autenticar

Toda chamada exige o envio do header X-Api-Key: ask_.... Você pode gerar sua chave pessoal em Meu Espaço → Conectividade ou via painel de administração em Admin → API Keys.

Endpoints REST Disponíveis

GET/api/v1/poker/rounds

Busca estimativas de rodadas já feitas, por texto livre (tópico ou nota da rodada).

Parâmetros: q (opcional; vazio lista as mais recentes), page (1-based, padrão 1), pageSize (máx 100)

Retorno: { rounds[], page, pageSize, total, totalPages } — cada round traz topic, issueId, devPoints, qaPoints, timestamp, roomId

Exemplo Prático de Chamada

cURL
curl -s "https://espacoagil.com.br/api/v1/poker/rounds?q=winthor-integracao-matcon&pageSize=20" \
  -H "X-Api-Key: ask_SUA_CHAVE_AQUI"
Regras de Negócio & Detalhes de Integração
  • Collection-group query em rooms/*/rounds (firestore.rules aberto pra isso, mesmo padrão de knowledge_kb/prompt_hub) — sem custar índice composto, filtro/ordenação são em memória.
  • Sem campo estruturado de squad/projeto no Poker — a busca é textual sobre topic/note. O nome do serviço/projeto normalmente está dentro do texto da tarefa, não numa chave separada.
  • votes/stats/rolePoints (voto individual por participante) nunca são repassados — só topic/issueId/devPoints/qaPoints/timestamp/roomId saem da rota.
  • devPoints/qaPoints são pontos de estimativa por papel (dev = "codificação", qa = "teste"), não uma unidade de tempo fixa — depende do deck da sessão.