Linear

O Linear é onde grande parte do trabalho de engenharia é de fato rastreado -- bugs, pedidos de funcionalidades, projetos -- e conectá-lo permite que a tAI pesquise, leia e crie esse rastreamento diretamente de uma conversa, em vez de você trocar de aba para fazer isso manualmente.

Ele é vinculado da mesma forma que todo conector, em Settings -> Connectors, por meio da própria tela de autorização OAuth do Linear, onde você aprova em qual workspace a tAI tem permissão para atuar. A tAI nunca vê sua senha do Linear, apenas o token de acesso que o Linear emite depois da sua aprovação.

Depois de conectada, dez ferramentas ficam disponíveis -- cobrindo busca, leitura completa dos detalhes de uma issue, criação de issues e projetos, listagem de equipes e projetos, atualização do status de uma issue, atribuição dela a alguém, comentários nela, e anexação de um arquivo do sandbox.

linear_search_issues pesquisa no seu workspace conectado por título e retorna as issues correspondentes, de forma semelhante a digitar na própria pesquisa do Linear. É o ponto de partida para quase todo pedido que faça referência a trabalho existente, em vez de pedir a criação de algo totalmente novo.

linear_read_issue recebe uma issue encontrada por pesquisa e retorna seus detalhes completos -- status, descrição e o restante do que realmente está naquela issue -- em vez de apenas o título que um resultado de pesquisa mostraria. A tAI a usa sempre que um pedido precisa do conteúdo substancial de uma issue, não apenas da confirmação de que ela existe.

linear_create_issue cria uma nova issue no workspace. Se o workspace tiver mais de uma equipe, a ferramenta precisa saber a qual equipe a issue pertence -- a tAI vai usar o contexto da conversa quando ele for claro, ou perguntar diretamente quando não for, em vez de adivinhar e registrar algo no lugar errado.

linear_create_project funciona da mesma forma, mas para projetos em vez de issues: ela cria um novo projeto, e se o workspace tiver múltiplas equipes, uma equipe precisa ser especificada pelo mesmo motivo -- o próprio Linear exige que um projeto pertença a uma equipe, e a tAI trabalha dentro dessa exigência, não ao redor dela.

Vale entender essa exigência de equipe como uma restrição genuína de como o Linear é estruturado, não uma limitação que a tAI acrescenta -- um workspace com uma única equipe nunca gera essa pergunta, já que só existe um lugar possível para uma nova issue ou projeto ir.

Um pedido realista de pesquisar e resumir seria algo como 'encontre issues abertas que mencionem exportação e resuma o status delas' -- a tAI pesquisa e, em seguida, lê as issues que parecem genuinamente relevantes para obter o status real delas, em vez de relatar apenas os títulos retornados pela pesquisa.

Um pedido realista de criação seria algo como 'crie uma issue intitulada CSV export times out na equipe Engineering' -- com a equipe especificada de antemão, para que linear_create_issue possa rodar imediatamente sem precisar fazer uma pergunta de acompanhamento antes.

Pesquisa e leitura costumam ser encadeadas até mesmo dentro de um único pedido: perguntar 'qual é o status do bug de redirecionamento de login' exige primeiro encontrá-lo pelo título e depois ler seu status atual real, e as duas etapas acontecem dentro da mesma resposta.

A tAI decide quais dessas quatro ferramentas se aplicam com base no que você pede, assim como em qualquer outro conector -- uma pergunta que não tem nada a ver com trabalho rastreado não invoca nenhuma delas, e um pedido que só pede para encontrar algo nunca toca nas duas ferramentas de criação.

Como linear_search_issues faz correspondência por título, uma descrição muito vaga, sem nenhuma das palavras reais da issue, pode não trazer o resultado certo -- mencionar uma palavra-chave com boa chance de estar no título, como 'export' ou 'login', traz resultados muito melhores do que uma descrição puramente conceitual.

Conectar o Linear é uma ação em nível de conta na tAI: vincule uma vez em Settings, e toda nova conversa a partir daí tem acesso, sem necessidade de reconectar a cada chat.

A desconexão acontece na mesma aba Connectors e afeta apenas o acesso futuro -- quaisquer issues ou projetos que linear_create_issue ou linear_create_project já tenham criado permanecem exatamente onde estão no Linear, já que se tornam objetos comuns do Linear assim que criados, não algo que a conexão ativa continue gerenciando.

Quais equipes e issues a tAI realmente consegue acessar depende do que a própria conta do Linear conectada tem acesso -- o conector não concede nenhuma permissão além daquela que a pessoa que aprovou a autorização já tinha no workspace.

Combinar o Linear com o GitHub em um único pedido é comum para trabalho de engenharia: 'encontre o bug de exportação CSV no Linear, corrija-o e abra um pull request referenciando a issue' faz com que a tAI leia a issue para obter contexto antes de tocar em qualquer código, de modo que a correção realmente resolva o que a issue descreve.

Vale afirmar diretamente o que esse conector não faz: não pode atualizar o status de uma issue existente, não pode atribuir issues a pessoas, não pode excluir issues ou projetos, e não pode comentar em uma issue. Seu acesso de escrita se limita a criar novas issues e novos projetos.

Também não há como navegar pela lista completa de issues de uma equipe independentemente de um termo de pesquisa -- linear_search_issues precisa de algo para comparar, então um pedido como 'mostre tudo que existe no Linear' não é algo que esse conector responde diretamente; ele funciona melhor quando direcionado a algo específico, uma palavra-chave, um tópico, um título aproximado.

Nenhuma configuração acontece fora do aplicativo tAI e da própria tela de OAuth do Linear -- nenhuma chave de API para gerar manualmente, nada para configurar dentro do próprio Linear além de aprovar a solicitação de autorização uma única vez.

Os detalhes completos sobre o que a tAI faz e não faz com o acesso ao workspace estão na política de privacidade do Linear, com link no rodapé desta página, no mesmo painel Settings -> Connectors usado para gerenciar a conexão.