Home | Blog | Integration

Como conectar comentários do Figma a issues do Linear

Conecte feedback de design e trabalho de engenharia ligando comentários do Figma a issues do Linear – sem copiar contexto entre abas.

By Ellis Keane · 2026-03-31

Por volta da quarta vez que assisti a um designer deixar um comentário detalhado no Figma, apenas para o engenheiro sentado três metros adiante criar uma issue quase idêntica no Linear dois dias depois, parei de pensar nisso como um problema de comunicação. É um problema de encanamento. Os canos entre essas duas ferramentas não existem da forma que todos assumem.

A integração nativa do Figma com o Linear oferece incorporações de links e um plugin para criar issues a partir de frames. Isso é genuinamente útil. Mas a parte em que um thread de comentários do Figma sobre o estado de hover de um botão silenciosamente se torna uma toca de coelho de duas semanas de engenharia, e ninguém conecta os pontos até a retrospectiva do sprint – esse é o gap que nenhuma ferramenta realmente aborda. E é sobre isso que trata este artigo: como conectar comentários do Figma a issues do Linear de uma forma que não dependa da memória de alguém.

O que a integração Figma com Linear realmente faz (e não faz)

A integração nativa faz duas coisas bem e mais nada.

Incorporação de links do Figma no Linear. Cole uma URL do Figma em qualquer issue ou comentário do Linear e ela se converte em uma pré-visualização interativa. Uma ressalva importante: a documentação do Linear afirma que as pré-visualizações interativas dentro do aplicativo só funcionam para arquivos do Figma compartilhados publicamente. Seus arquivos de design privados (ou seja, a maioria deles) serão renderizados como um link estático com uma miniatura.

O plugin do Linear para o Figma. De dentro do Figma, você pode criar issues do Linear que se vinculam automaticamente a frames, páginas ou seções específicas. Você define equipe, status, responsável e projeto – tudo sem trocar de aba. Você também pode vincular a issues existentes, o que é útil quando uma mudança de design afeta algo que já está em andamento.

A integração do Figma com o Linear é uma ponte de mão única: ela ajuda a empurrar contexto de design para o Linear. Não traz contexto de engenharia de volta ao Figma e não conecta threads de comentários entre as duas ferramentas.

O que não faz:

Comentários do Figma não criam issues do Linear automaticamente. Alguém precisa usar o plugin manualmente a cada vez.
Atualizações de issues do Linear não fluem de volta para o Figma. Se um engenheiro muda o status, adiciona um bloqueador ou reajusta o escopo do trabalho, o designer não vai saber a menos que vá verificar o Linear.
Não há busca entre ferramentas. "Onde discutimos o redesign da navegação?" pode significar comentários do Figma, issues do Linear, ou (Deus nos ajude) ambos.

Configurando o fluxo de trabalho do Figma para o Linear

A configuração leva cerca de três minutos. Os detalhes estão na documentação de integração do Figma com o Linear, mas aqui está a versão resumida:

[ ] Ative a integração do Figma nas configurações do workspace do Linear (requer admin em ambos os lados)
[ ] Instale o plugin oficial do Linear da Figma Community (evite alternativas de terceiros – tendem a quebrar com atualizações de API)
[ ] Teste: selecione um frame, execute o plugin do Linear e crie uma issue. Verifique se ela faz o link de volta ao frame.
[ ] Teste: cole um link de arquivo do Figma em uma issue do Linear e confirme que a incorporação é renderizada
[ ] Verifique as configurações de compartilhamento dos seus arquivos de design – arquivos privados exibirão links estáticos, não pré-visualizações interativas

Isso cuida do caminho óbvio: designer vê uma tarefa, designer cria uma issue, engenheiro obtém contexto. O problema começa quando a tarefa não é óbvia no momento em que o comentário é escrito.

O problema da classificação

Aqui está o cenário que quebra todo fluxo de trabalho do Figma para o Linear que já vi:

Um designer comenta em um frame: "Esse estado de carregamento não leva em conta o estado vazio que discutimos. Devemos adicionar uma tela esqueleto?" Três pessoas respondem no thread do Figma. Uma decisão é tomada. Ninguém cria uma issue no Linear porque o comentário parecia mais uma discussão de design do que uma tarefa.

Dois sprints depois, o engenheiro constrói o recurso sem uma tela esqueleto. O QA sinaliza o problema. Todos passam vinte minutos no Slack tentando descobrir se isso foi discutido alguma vez. Foi – no Figma, onde o thread de comentários ainda está lá, resolvido e esquecido.

O problema não é que as pessoas esquecem de usar o plugin do Linear. É que o feedback de design existe em um espectro, e a classificação – "aquilo era uma tarefa?" – acontece retroativamente, geralmente quando alguém percebe que a coisa não foi feita.

Três heurísticas que ajudam: Ao revisar um thread de comentários do Figma, pergunte se ele (a) afeta os critérios de aceitação de uma issue existente do Linear, (b) descreve um novo trabalho que ninguém registrou ainda, ou (c) contém uma decisão que muda o escopo. Se sim para qualquer um desses, deve se tornar uma issue rastreada. Isso não vai capturar tudo, mas dá à sua equipe um vocabulário compartilhado para "este comentário importa."

O que realmente funciona (e o que não funciona)

A configuração recomendada: plugin nativo mais convenções leves mais uma rede de segurança. Use o plugin do Linear para o Figma sempre que um designer identificar um trabalho claro – um componente precisa ser atualizado, um bug precisa ser registrado, uma nova tela precisa ser construída. Adicione uma convenção simples de comentários (nossa equipe usa um prefixo "Action:" ou menciona o engenheiro relevante) para sinalizar intenção sem processos pesados. E aceite que algumas coisas vão escapar – crie uma revisão semanal onde você varre threads recentes de comentários do Figma junto ao quadro do sprint, buscando threads não resolvidos com mais de uma semana que possam se mapear a issues existentes. Isso é um sistema perfeito para conectar comentários do Figma a issues do Linear? Não, é uma solução paliativa manual – mas é a solução paliativa manual mais confiável que encontrei, e dá tempo até que você possa automatizar a camada de classificação.

O que funciona

Plugin nativo para tarefas claras – quando um designer sabe que algo é uma tarefa, o plugin do Linear é rápido e direto
Convenções de comentários – tags simples como Action: ou menções a engenheiros para sinalizar intenção
Revisão semanal de comentários e quadro – varrer threads não resolvidos do Figma contra o quadro do sprint

O que falha

Roteamento manual em escala – depender de humanos para classificar cada comentário quebra durante sprints intensos
Automações do Zapier baseadas em palavras-chave – os webhooks de comentários do Figma disparam em toda atividade (respostas, resoluções, reações), gerando ruído que requer manutenção constante de filtros
Ignorar completamente o gap – esperar que as pessoas "simplesmente verifiquem ambas as ferramentas" não é uma estratégia

Alternativa: Zapier ou Make. Você pode configurar um gatilho em novos comentários do Figma para criar issues no Linear. O problema prático é que os webhooks do Figma podem gerar altos volumes de eventos de comentários – respostas, threads resolvidos, reações de emoji, tudo dispara. Sem filtragem cuidadosa, você vai inundar o Linear com uma nova issue toda vez que alguém reagir a um comentário com um joinha, que é exatamente o tipo de progresso que faz você questionar suas escolhas de carreira. Com filtragem, você está mantendo regras de regex que ficam desatualizadas em relação à forma como sua equipe realmente escreve comentários. Funciona para equipes pequenas com padrões de comentários previsíveis, mas acaba se tornando o trabalho de meio período de alguém.

Alternativa: inteligência de sinais semântica. Em vez de rotear comentários individuais como issues, um sistema que entende ambas as ferramentas em nível semântico pode reconhecer quando um thread de comentários do Figma se sobrepõe a uma issue existente do Linear, ou quando um novo comentário implica trabalho não rastreado. Essa é a abordagem que estamos construindo no Sugarbug – scrapers nativos para Figma e Linear que classificam sinais e revelam conexões através de um grafo de conhecimento, para que o link entre uma discussão de design e uma tarefa de engenharia não dependa de alguém lembrar de clicar em um botão.

O objetivo não é transformar cada comentário do Figma em uma issue do Linear. É garantir que quando um comentário implica trabalho, a conexão não dependa da memória de alguém. attribution: Chris Calo

Perguntas frequentes

Receba inteligência de sinais direto na sua caixa de entrada.

Q: Posso criar issues do Linear diretamente dos comentários do Figma? A: Sim, mas não automaticamente. Você precisa ter o plugin do Linear para o Figma instalado, e alguém precisa executá-lo manualmente a cada vez. Ele permite criar issues vinculadas a frames específicos, definir equipe, status, responsável e projeto – tudo sem trocar de aba. O gap é que ninguém faz isso para comentários que não parecem tarefas óbvias na hora.

Q: O Sugarbug conecta automaticamente comentários do Figma a issues do Linear? A: O Sugarbug raspa tanto o Figma quanto o Linear de forma nativa, classifica sinais de cada um e os conecta pelo seu grafo de conhecimento. Quando um comentário do Figma faz referência a trabalho rastreado no Linear, o Sugarbug exibe essa conexão sem vinculação manual.

Q: Por que as notificações de comentários do Figma não aparecem no Linear? A: Porque a integração é de mão única. O Linear incorpora pré-visualizações de design do Figma e permite criar issues pelo plugin, mas os threads de comentários do Figma não fluem para o Linear como notificações. As atualizações também não são espelhadas de volta – se um engenheiro muda o status de uma issue, o designer precisa ir verificar o Linear para descobrir.

Q: Como sei quais comentários do Figma devem se tornar issues do Linear? A: Use três heurísticas: o comentário afeta os critérios de aceitação de uma issue existente? Descreve um novo trabalho que ninguém registrou ainda? Contém uma decisão que muda o escopo? Se sim a qualquer uma delas, deve ser rastreado no Linear.