Linear Release Setup: ligue seu CI às entregas no Linear

ANÁLISE EDITORIAL

Uma tarefa marcada como concluída não diz, por si só, se o código já chegou ao cliente. Entre o merge e a entrega podem existir ambientes, versões e aprovações diferentes. A Linear Release Setup é a Skill oficial da Linear que ajuda um agente a desenhar essa ligação entre o CI/CD e os releases registrados no produto. Ela faz perguntas sobre o que a equipe realmente entrega antes de propor um arquivo de workflow. O ZIP desta página contém apenas essa orientação documental: não instala a ferramenta de releases, não cria um pipeline e não publica uma versão.

O que a Skill faz

O documento orienta a configurar o Linear Release, ferramenta que lê o histórico Git durante o CI e associa alterações e questões do Linear a um release. Seu foco não é escrever uma configuração genérica rapidamente. Primeiro, o agente deve identificar a plataforma de CI, a branch padrão do repositório e os produtos ou canais que são entregues de forma independente. Depois, pergunta se cada fluxo é contínuo, no qual cada implantação gera um release concluído, ou programado, no qual uma versão acumula mudanças e passa por fases antes de ser encerrada.

Há uma distinção especialmente útil no texto: pipeline não é estágio. Se produção e TestFlight podem conter commits diferentes ao mesmo tempo, são dois fluxos de release. Se um mesmo build atravessa congelamento, QA e aprovação sem mudar, essas são fases do mesmo fluxo. O agente deve aplicar essa pergunta ao projeto real, em vez de converter nomes de ambientes automaticamente em estágios. Em um monorepositório, serviços publicados separadamente precisam de pipelines separados e filtros de caminhos coerentes. A documentação de Releases da Linear explica o modelo usado no produto.

Ao final, a Skill direciona o agente para os exemplos de GitHub Actions, GitLab CI e CircleCI mantidos no repositório e pede consulta ao README atual antes de escrever comandos ou opções. É uma instrução para preparar uma proposta de CI, não uma integração pronta que possa ser ativada sem revisão.

Para quem serve, e para quem não serve

Serve a equipes de engenharia e operações que já usam Linear e querem responder com mais precisão quais alterações entraram em cada entrega. Um time web com deploy contínuo, por exemplo, pode registrar a cada execução bem-sucedida o conjunto de questões encontrado nos commits. Uma equipe móvel que prepara versões por ciclos pode manter um release em andamento, avançá-lo por estágios e concluí-lo quando a distribuição for confirmada. Em ambos os casos, a utilidade depende de histórico Git e de uma convenção de identificação das questões suficientemente confiáveis.

A Skill não substitui a plataforma de CI, a revisão do código nem a confirmação de que uma versão está disponível para usuários. Também não é uma forma de obter Releases em qualquer plano do Linear. A documentação oficial consultada em 18/10/2026 informa disponibilidade em workspaces Business e Enterprise; verifique o plano do seu espaço antes de investir na configuração. Se o projeto não usa Linear, não tem acesso a Releases ou não pode fornecer ao job a chave específica do pipeline, a primeira etapa é resolver esse pré-requisito, não improvisar uma credencial diferente.

Compatibilidade e pré-requisitos

O arquivo SKILL.md é documentação para agentes que carregam Skills nesse formato. A instrução descreve GitHub Actions, GitLab CI, CircleCI e outras plataformas capazes de executar a CLI, mas não significa que o ZIP execute em todos esses sistemas. Para a integração funcional é preciso ter um workspace elegível, um pipeline já criado em Settings > Releases, a chave de acesso gerada nas configurações desse pipeline, um repositório Git e permissão para editar o CI. A Linear afirma que uma chave pessoal de API não substitui a chave do pipeline.

No repositório auditado, o package.json declara a versão 0.18.0 para a ferramenta, e a revisão desta Skill está fixada no commit b147a06516f23de9a84ae65153a3358c01011578, de 16/10/2026. A página da release v0.18.0 e o README fixado são referências para conferir binários, comandos e opções. Na consulta de 18/10/2026, o repositório tinha 68 estrelas. O catálogo abre uma exceção ao seu limiar usual de 1.000 por se tratar de uma Skill publicada pelo próprio fornecedor, com documentação, release e licença verificáveis. O número não é prova de adoção da Skill.

Instalação e configuração segura

Use o download local no card desta página e compare o SHA-256 informado ali antes de abrir o ZIP. Ele contém somente SKILL.md, LICENSE e ORIGEM.md. Para um agente que aceita Skills por projeto, copie a pasta linear-release-setup para o diretório de Skills indicado pelo seu cliente, por exemplo .agents/skills/linear-release-setup/ quando essa convenção for suportada. Confira se já há outra cópia com o mesmo nome e mantenha o commit registrado. O repositório oficial da Skill permite inspecionar o original separadamente do pacote oferecido aqui.

Instalar a Skill não instala a CLI. Para operar o Linear Release no CI, a equipe escolhe a ação oficial em GitHub Actions ou obtém o executável correspondente ao sistema na página de releases, conforme o README. Se for baixar um binário, verifique o manifesto de checksums publicado com a release escolhida. Nunca copie uma chave de acesso para o texto do workflow ou para o prompt do agente. Crie um segredo do CI chamado LINEAR_ACCESS_KEY ou use nomes distintos quando houver vários pipelines, e limite quem pode ler ou alterar esse segredo. A chave de cada pipeline é criada no Linear, não neste ZIP.

Para GitHub Actions, o README mostra actions/checkout@v4 com fetch-depth: 0 seguido da ação linear/linear-release-action@v0. Em GitLab, a Skill lembra que o job precisa de clone completo e GIT_DEPTH: 0; a estratégia none ou empty impede a leitura do histórico. Adapte branch, gatilhos e filtros ao repositório. A ação oficial da Linear documenta seus próprios parâmetros e deve ser consultada no momento da configuração.

Primeiro uso e resultado esperado

Comece sem fornecer credenciais ao agente. Dê a ele o repositório e uma solicitação como: “Use Linear Release Setup para examinar nossa configuração de CI. Temos deploy web após merge e um aplicativo móvel com versão planejada. Liste quais pipelines e estágios seriam necessários, identifique a branch padrão e proponha os arquivos a alterar. Não execute o workflow, não crie segredos e não publique releases.” Uma boa primeira resposta deve separar os dois fluxos, explicar as decisões ainda abertas e mostrar o diff proposto, inclusive onde a chave será referenciada como segredo.

Depois que um responsável confirmar a modelagem, crie no Linear cada pipeline necessário e guarde sua chave no gerenciador de segredos do CI. Use um repositório ou branch de teste para validar a configuração. Para GitHub Actions, confira se o job roda somente após o deploy que você pretende registrar; associar um release a uma tentativa que falhou distorce a informação. No fluxo contínuo, o comando sync após uma implantação cria um release concluído. No programado, sync adiciona mudanças ao release em andamento, update move a fase e complete encerra o release, conforme o README. Quando há versões sobrepostas, informe explicitamente --release-version para não atingir a versão errada.

O resultado esperado é uma configuração revisada que registre no Linear as entregas que realmente ocorreram, com questões associadas a commits ou pull requests conforme a detecção disponível. Esta página não testou a integração em uma conta Linear, não afirma que uma questão específica seria associada e não apresenta uma execução de CI como se fosse sua.

Permissões, dados e riscos

O ZIP não contém executáveis ou segredos. O uso funcional, porém, envolve leitura do repositório, histórico de commits e configuração de CI, além de chamadas à API da Linear com a chave do pipeline. O agente que escreve o workflow pode ampliar gatilhos, alterar permissões do job ou expor um segredo por engano. Revise cada mudança como código de produção. Use privilégio mínimo no repositório, proteja a branch principal e teste com dados não sensíveis. Mensagens de commit e descrições de release também podem conter informação confidencial; confirme a política de compartilhamento antes de sincronizá-las.

O README oferece --dry-run, que consulta APIs de leitura e deixa de fazer as alterações de criação ou atualização; isso ainda envolve comunicação de rede e não substitui uma revisão de credenciais. O histórico Git completo é importante para a faixa de commits: clone raso ou base escolhida incorretamente pode omitir mudanças ou incluí-las duas vezes. Filtros por caminho ajudam monorepositórios, mas uma biblioteca compartilhada pode afetar vários serviços; teste as regras com commits representativos antes de confiar nelas.

Se algo der errado

Se o job não encontrar o repositório ou não associar commits, confira primeiro o checkout, a branch e a profundidade do clone. Em GitLab, verifique GIT_STRATEGY e GIT_DEPTH no próprio job. Se um sync não criar release, examine a faixa de commits e os filtros: a ferramenta pode retornar release: null quando nada corresponde. Não force uma base antiga sem entender o intervalo, porque --base-ref muda o limite inferior da análise.

Se um release inesperado for atualizado, pare o job, inspecione o pipeline e passe a versão explicitamente nos comandos seguintes. Se a CLI não iniciar em um container Alpine, a Skill alerta que o binário pré-compilado depende de glibc; use uma imagem compatível com glibc e confirme a presença de git e curl ou wget. Se a chave falhar, confirme que ela pertence ao pipeline correto e está no segredo do CI, sem imprimi-la em logs. Para diagnóstico de parâmetros e comportamento, volte ao troubleshooting do mantenedor.

Revisão, licença e download local

Auditamos a pasta skills/linear-release-setup no commit indicado, o README, a release da ferramenta e o arquivo LICENSE do repositório. A licença MIT permite redistribuição com preservação do aviso de copyright, incluído no ZIP. O pacote tem exatamente três arquivos documentais e não oferece a CLI, a ação de CI, dependências ou credenciais. O hash SHA-256 do SKILL.md original consta em ORIGEM.md; confira também o SHA-256 do ZIP mostrado no card de download.

O card abaixo baixa a cópia documental hospedada no Bastidores. O botão de repositório oficial é uma ação diferente e abre a fonte da Linear em nova aba. Se o README mudar depois deste commit, não assuma que os comandos antigos permanecem válidos. Releia a documentação, fixe uma nova revisão e submeta o workflow a teste e aprovação humana antes de mudar uma entrega real. Outras ferramentas documentais podem ser exploradas no catálogo de Skills, sem substituir a verificação da origem desta.

Fontes primárias

• SKILL.md oficial, commit auditado
• README da ferramenta no mesmo commit
• Documentação de Releases da Linear
• Release v0.18.0
• Licença MIT original