Desenvolvimento
Linear — Criando Issues
Guia para membros não técnicos criarem issues no Linear
Essa página é voltada para membros não técnicos do time (produto, negócio). Existem dois templates de formulário no Linear.
Template: Nova Feature (Team CRM)
Use quando quiser pedir uma funcionalidade nova ou melhoria.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Título | Sim | Nome curto e claro. Ex: "Filtro de negócios por vendedor" |
| Módulo | Sim | Dropdown: Pipeline, Atividades, Empresas, Contatos, Produtos, Propostas, Qualificação, Carteira, Configurações |
| O que precisa acontecer? | Sim | Descreva o que o usuário precisa fazer ou ver. Não precisa ser técnico. Escreva como se estivesse explicando pro cliente. |
| Por que isso é importante? | Sim | Qual problema isso resolve? Que dor do cliente isso ataca? |
| Tem referência visual? | Não | Cole link de screenshot, print, vídeo Loom ou nome de concorrente que faz algo parecido |
| Urgência | Sim | Bloqueia cliente / Importante mas não urgente / Seria legal ter |
Template: Novo Indicador (Team Dashboard)
Use quando quiser pedir um novo indicador ou métrica no dashboard.
| Campo | Obrigatório | Descrição |
|---|---|---|
| Título | Sim | Nome do indicador. Ex: "Taxa de conversão por etapa" |
| O que mostra? | Sim | Que número ou informação aparece na tela? |
| Por que é útil? | Sim | Que decisão o gestor toma olhando esse número? |
| Como mostrar? | Não | Dropdown: Card KPI, Gráfico de barras, Tabela, Funil, Barra de progresso |
| Tem referência? | Não | Print, link ou nome de ferramenta que tem algo parecido |
O que acontece depois
Triage
A issue cai automaticamente em Triage.
Revisão técnica
O dev revisa, adiciona critérios de aceite técnicos e valida a viabilidade.
Backlog
A issue move para Backlog quando estiver pronta para ser priorizada.
Desenvolvimento
Entra no fluxo de desenvolvimento quando for priorizada para o sprint atual.
Dicas para criar boas issues
- Foque no problema, não na solução técnica
- Seja específico: "filtrar negócios por vendedor" é melhor que "melhorar filtros"
- Sempre preencha o "Por que é importante" — se não conseguir explicar, talvez não seja prioridade
- Referências visuais ajudam muito: um print de concorrente vale mais que mil palavras
- Uma issue por pedido. Não misture duas coisas diferentes na mesma issue
Em caso de dúvida sobre qual template usar, crie como Nova Feature no Team CRM. O dev reclassifica se necessário.