Conectar o Linear
O Linear é um rastreador de planejamento na plataforma (par do Jira): times, issues, estimativas e cycles alimentam o value stream, o investimento por tipo de trabalho, a tela de Projeto e o vínculo PR ↔ issue.
Como conectar#
- Vá em Integrações e clique em Conectar no card do Linear.
- Autorize via OAuth: a plataforma pede apenas o escopo de leitura (
read). - Selecione os times que quer acompanhar e clique em Ativar (no Linear, o prefixo da issue,
como
ENG-123, vem do time). - A sincronização do histórico começa em segundo plano; as métricas aparecem conforme os dados chegam.
O que é sincronizado#
Para cada time que você ativar, a plataforma importa:
- Issues com estados, prioridades e labels (só metadados).
- Estimativas (alimentam velocity e os cards de pontos).
- Cycles (tratados como sprints).
- Datas nativas de fluxo: o Linear registra quando a issue começou e terminou, então o dev-start e o value stream ficam exatos, sem aproximação por histórico.
O vínculo PR ↔ issue acontece sozinho: basta o identifier da issue aparecer na branch, no título
ou no corpo do PR. A convenção do próprio Linear já resolve (o botão "copy git branch name" gera algo
como ana/eng-123-corrigir-checkout).
Webhook (atualização em tempo real)#
Sem webhook, sincronizamos de hora em hora. Para tempo quase-real, crie o webhook no Linear (é a única configuração manual, porque criar via API exigiria um escopo de administrador que preferimos não pedir):
- Na plataforma, abra Integrações → Linear → Gerenciar projetos e copie a URL do webhook.
- No Linear, vá em Settings → API → Webhooks → New webhook, cole a URL e selecione o resource type Issues (e os times que quiser).
- Opcional: copie o signing secret exibido pelo Linear e cole na plataforma para validarmos a assinatura de cada entrega.
Perguntas comuns#
Preciso dar acesso de escrita? Não. O escopo pedido é só read; a plataforma nunca escreve no
seu Linear.
Quais times aparecem? Os que o usuário que conectou enxerga (times privados exigem que essa pessoa seja membro).
E os Projects do Linear? Hoje importamos times, issues e cycles. Projects (agrupadores cross-team) estão no radar como camada de épicos.