Linear

Conecte o Buildprint ao Linear para usar o agente de IA diretamente do seu rastreador de problemas. Mencione @Buildprint em qualquer issue do Linear para obter análises baseadas em IA do seu app Bubble sem sair do Linear. Você também pode anexar issues do Linear a conversas de chat do Buildprint para obter contexto adicional.

Conectando o Linear

Admins do workspace podem conectar o Linear em Agent → Integrations.

Clique em Connect ao lado de Linear.
Autorize o Buildprint no popup do Linear.
O nome da sua organização no Linear aparecerá uma vez conectado.

Para desconectar, use o menu suspenso ao lado do nome da organização conectada.

Configurando o escopo da equipe

Após a conexão, mapeie suas equipes do Linear para projetos do Buildprint. Isso indica ao agente quais apps Bubble usar ao responder a issues de cada equipe.

Na seção Team scope, selecione um ou mais projetos do Buildprint para cada equipe do Linear. Quando o agente recebe uma menção em uma issue, ele identifica a equipe e utiliza os projetos mapeados como contexto.

Se nenhum projeto estiver mapeado para uma equipe, o agente retornará um erro ao ser mencionado nas issues dessa equipe.

Atualmente, não é possível limitar o escopo do Linear a branches específicas. Por esse motivo, recomenda-se manter o agente do Linear no modo de planejamento (plan mode) para que ele possa realizar a triagem e o planejamento de tickets, mas não fazer alterações na aplicação.

Configurações do agente

Configure como o agente do Linear se comporta na seção Agent settings na página de Integrações:

Run as user — Quais credenciais de admin do workspace e provedor de IA o agente utiliza. Deve ser um admin ou proprietário.
Model — O modelo de IA que o agente utiliza (Claude, OpenAI ou Opencode). O usuário selecionado deve ter o respectivo provedor conectado.
Reasoning effort — Controla o quanto o agente "pensa" antes de responder: none (nenhum), low (baixo), medium (médio) ou high (alto).
Task permissions — Se o agente pode fazer edições no seu app Bubble ou se opera apenas em modo de leitura.

Usando @Buildprint no Linear

Uma vez conectado, você pode interagir com o agente de duas formas:

Menção — Marque @Buildprint em um comentário em qualquer issue. O agente lê o contexto da issue e responde com análises ou sugestões.
Atribuição — Atribua uma issue ao @Buildprint. O agente analisa a issue completa (título, descrição, comentários, issues relacionadas) e fornece uma resposta abrangente.

O agente tem acesso às mesmas ferramentas do chat do Buildprint — ele pode consultar seu banco de dados, pesquisar logs, explicar workflows e sugerir mudanças. As respostas aparecem diretamente na issue do Linear como atividades do agente.

Envie mensagens de acompanhamento para continuar a conversa. O agente mantém o contexto das mensagens anteriores na mesma sessão.

Anexando issues do Linear ao chat

No compositor de chat do Buildprint, clique em Add attachment → Link Linear issue para pesquisar e anexar uma issue do Linear. O agente recebe o título, descrição, comentários e issues relacionadas como contexto para sua conversa.

Os resultados da pesquisa são limitados às equipes do Linear mapeadas para o seu projeto atual. Anexos de arquivos da issue (até 8 arquivos, 10 MB cada) também são incluídos.

Rastreamento de branches

O Buildprint pode rastrear o progresso de branches do Bubble no Linear usando etiquetas (labels).

Para usar isso, adicione uma etiqueta no Linear que corresponda exatamente ao nome da branch do Bubble. Por exemplo, se sua issue for ACME-103 e o trabalho estiver ocorrendo na branch acme-103 do Bubble, adicione a etiqueta acme-103 a essa issue.

Certifique-se de criar as etiquetas você mesmo - o Buildprint não consegue criar etiquetas, portanto, se você quiser que as issues sejam rastreadas até os ambientes test e live, certifique-se de criar as etiquetas test e live no Linear!

Se a opção Auto-sync issue branches estiver ativada, o Buildprint adicionará o nome da branch de destino como uma nova etiqueta no Linear quando essa branch for mesclada (merged) com sucesso. O Buildprint também adicionará um comentário à issue informando quem fez o merge e como ele foi feito. Por exemplo:

se acme-103 for mesclada em test, o Buildprint adiciona a etiqueta test
se test for posteriormente implantada ou mesclada em live, o Buildprint adiciona a etiqueta live

Isso oferece uma visão simples onde as etiquetas representam as branches que contêm o trabalho dessa issue.

Recomendamos nomear as branches do Bubble com o identificador da issue do Linear, por exemplo acme-103. Isso faz com que o rastreamento de branches por etiquetas funcione perfeitamente e mantém óbvio o mapeamento de issue para branch.

Se você reverter um merge ou aplicar alterações posteriores à branch mesclada, o Buildprint não "removerá" as etiquetas de branch existentes. Portanto, como boa prática, garanta que os merges sejam finais e crie uma nova branch para atualizações (você pode atribuir várias branches do Bubble a uma única issue do Linear!)

O Buildprint não rastreará merges downstream (onde o merge ocorre para fora da Main, ex: de staging para uma feature branch ou de main para staging). Isso resultaria em notificações e etiquetas excessivas!

O rastreamento de branches não está funcionando

Certifique-se de que ativou o controle de versão avançado nas configurações gerais (General settings) do seu app Bubble (perto do final).

Isso foi útil?