Criar User Story

User stories capturam requisitos da perspetiva do utilizador final. Cada story segue o formato: "Como [quem], eu quero [o quê], para que [porquê]." Esta estrutura garante que cada funcionalidade tem propósito claro e valor mensurável.

Abrir a Modal

Aceda à modal de criação através de múltiplos caminhos:

• Cabeçalho do projeto: Clique no botão "Nova" na secção de user stories
• Atalho de teclado: Cmd/Ctrl + Shift + U de qualquer lugar no projeto
• Estado vazio: Clique no link "Crie a sua primeira user story"
• Criação rápida: Use menu de criação rápida global e selecione "User Story"

A modal abre com o seu projeto atual pré-selecionado. Se abriu do menu global, selecione workspace e projeto primeiro.

Modos de Criação

Modo Tradicional

Escreva user stories no formato standard:

Estrutura do template:

Como [tipo de utilizador],
Eu quero [algum objetivo],
Para que [alguma razão].

Exemplo:

Como gestor de projeto,
Eu quero ver gráficos de burndown de sprint,
Para que possa acompanhar a velocidade da equipa.

O formato tradicional garante:

• Identificação clara da persona do utilizador
• Declaração de objetivo específica e acionável
• Justificação de valor de negócio

Escrever stories eficazes:

1. Seja específico sobre o utilizador. "Como utilizador" é demasiado vago. Use "Como administrador de faturação" ou "Como visitante de primeira vez"

1. Foque num objetivo. Se escrever "e" na cláusula do quero, considere dividir em múltiplas stories

1. Declare valor mensurável. "Para que possa poupar tempo" é fraco. "Para que possa processar 50% mais faturas" é acionável

Modo AI

Descreva o que precisa em linguagem natural. A AI gera uma user story corretamente formatada:

Input:

Preciso de uma forma para managers aprovarem entradas de tempo antes de irem para faturação

Story gerada:

Como gestor de equipa,
Eu quero rever e aprovar entradas de tempo antes de exportação,
Para que a precisão de faturação melhore e disputas diminuam.

Modo AI destaca-se quando:

• Converter pedidos de stakeholders em formato user story
• Transformar bug reports em stories de melhoria
• Decompor requisitos vagos em necessidades específicas

Campos da Modal

Título (Obrigatório)

Em modo Tradicional, este é o texto completo da sua user story. Em modo AI, esta é a sua descrição em linguagem natural.

Limite de caracteres: 500 caracteres Melhor prática: Mantenha títulos escaneáveis. A primeira linha deve resumir a story.

Critérios de Aceitação

Defina o que "pronto" significa para esta story. Use condições testáveis:

Critérios fracos:

- Deve funcionar corretamente
- Deve ser rápido
- Precisa ter boa aparência

Critérios fortes:

- Entradas de tempo exibem em ordem cronológica
- Manager pode aprovar/rejeitar entradas individuais
- Entradas rejeitadas retornam ao submissor com comentário obrigatório
- Entradas aprovadas marcadas com timestamp e nome do aprovador
- Página carrega em menos de 2 segundos para até 500 entradas

Opções de formato:

Given/When/Then:

Dado que sou um manager logado
Quando vejo entradas de tempo pendentes
Então vejo entradas agrupadas por membro de equipa

Estilo checklist:

- [ ] Filtrar por intervalo de datas funciona
- [ ] Aprovar em massa entradas selecionadas funciona
- [ ] Exportar entradas aprovadas para CSV funciona

Informação Adicional

Contexto que ajuda durante implementação:

• Links para mockups de design
• Restrições técnicas
• Documentação relacionada
• Contactos de stakeholders
• Edge cases a considerar

Este campo suporta formatação Markdown completa incluindo links, blocos de código e imagens.

Prioridade

Defina nível de urgência da lista de prioridades do seu projeto:

Prioridade afeta:

• Ordenação padrão em vistas de backlog
• Sugestões de planeamento de sprint
• Cálculos de carga de trabalho de equipa

Epic

Ligue a story a um epic pai para organização:

Nenhum Epic selecionado: Story aparece no backlog sem agrupamento Epic selecionado: Story agrupa sob epic em roadmap e vistas de planeamento

Criar Epic inline: Clique "Criar novo epic" para adicionar um epic sem sair da modal. Introduza título e guarde—o novo epic fica imediatamente selecionável.

Isto é valioso quando:

• Uma story revela necessidade de uma nova iniciativa
• Stakeholder pede uma funcionalidade fora dos epics existentes
• Está a decompor um requisito grande em epic + stories

Validação de Formulário

O botão criar ativa quando:

1. Projeto selecionado: Obrigatório para todas stories
2. Título fornecido: Mínimo 3 caracteres
3. Conteúdo apropriado ao modo: Formato tradicional ou descrição AI

Erros de validação aparecem inline:

• Título vazio: "Título é obrigatório"
• Título demasiado curto: "Mínimo 3 caracteres"
• Sem projeto: "Selecione um projeto primeiro"

Após Criação

Estado de Sucesso

A modal confirma criação com opções:

Ir para User Stories: Navegar para o board de user stories do projeto Criar Outra: Limpar formulário, manter na modal para criação em batch

O Que Acontece

1. Story criada com estado "Aberta"
2. Aparece no backlog pronta para planeamento de sprint
3. Ligada ao epic se selecionado
4. Equipa notificada via feed de atividade do projeto
5. Sincronização em tempo real entre todas as vistas dos membros de equipa

Atalhos de Teclado

Melhores Práticas

Escrever Independentemente

Cada story deve ser completável sem dependências:

Dependente (evitar):

Como utilizador, quero ver o dashboard que foi criado na US-123

Independente (preferido):

Como utilizador, quero ver métricas chave no meu dashboard

Dimensionar Apropriadamente

Stories devem completar dentro de um sprint. Se maiores:

• Divida em múltiplas stories
• Use epic para agrupar stories relacionadas
• Considere padrão "Como utilizador, quero [parte 1]"

Incluir Critérios de Aceitação

Cada story precisa de condições testáveis. Isto não é opcional—é como a sua equipa sabe quando trabalho está completo.

Investimento de tempo: 5 minutos escrevendo critérios poupa 2 horas de perguntas de esclarecimento depois.

Conectar a Epics

Stories órfãs criam caos no planeamento. Mesmo "melhorias diversas" merecem um epic para agrupamento.

Padrões Comuns

Story de Funcionalidade

Como [tipo de utilizador],
Eu quero [capacidade],
Para que [valor de negócio].

Conversão Bug-para-Story

Como [utilizador afetado],
Eu quero [coisa quebrada] corrigida,
Para que [impacto quando corrigido].

Story Técnica

Como developer,
Eu quero [melhoria técnica],
Para que [benefício de manutenção/performance].

Story de Pesquisa

Como product manager,
Eu quero entender [desconhecido],
Para que [decisões futuras].

Resolução de Problemas

Modal não abre:

• Verifique permissões de projeto (precisa createuserstories)
• Garanta que projeto está selecionado na navegação
• Tente atualizar página

Modo AI não gera:

• Forneça mais detalhe na descrição
• Inclua contexto sobre tipo de utilizador e objetivo
• Verifique conexão de rede

Não consegue selecionar epic:

• Epics carregam após seleção de projeto
• Crie novo epic se nenhum existir
• Verifique se epic não está arquivado

Dropdown de prioridade vazio:

• Prioridades vêm de configurações do projeto
• Admin pode adicionar prioridades em Configurações do Projeto → Prioridades