Artigos
Priorize e reduza o débito técnico em seu backlog do Jira com o Compass
KATIE SILVER
GERENTE DE PRODUTO PRINCIPAL, ATLASSIAN
Resumo executivo
O débito técnico, causado pela escalabilidade e necessidade de lançar novas funções mais rápido, é um desafio comum para as equipes de software. As equipes assumem esses débitos de imediato, mas o excesso diminui a velocidade a longo prazo. O Atlassian Compass, uma plataforma interna para desenvolvedores (IDP), oferece às equipes um catálogo central de software para que os desenvolvedores possam encontrar informações com agilidade e entender a integridade e o desempenho de seus softwares. Ao vincular os itens do Jira ao seu catálogo e às medidas de integridade no Compass, as equipes podem identificar e reduzir o alto impacto do débito técnico ao priorizar o backlog e, ao mesmo tempo, enviar novas funções com velocidade consistente.
Tempo
Leitura de oito minutos. Menos de 10 minutos para configurar o Compass.
Público-alvo:
Usuários do Jira em uma equipe de entrega de software. Desenvolvedores, engenheiros, gerentes de produto e muitos outros podem se beneficiar.
Pré-requisitos
- Obtenha o Compass: o teste é gratuito e leva poucos minutos para começar.
- Obtenha o Jira: você tem ativo um projeto do Jira gerenciado pela empresa.
O débito técnico em seu backlog está fora de controle? Você não está sozinho
Crie, adote medidas e aprenda rápido. Equipes de software ágeis lançam código com uma velocidade incrível. A desvantagem é o débito técnico, um fenômeno inevitável que aumenta a fragilidade do código e atrasa as equipes. Até que ponto sua equipe entende sobre débito técnico? Quais insights informam como priorizar seu backlog para reduzir o débito técnico e, ao mesmo tempo, continuar oferecendo novas funções inovadoras? Continue lendo e saiba como avaliar a prioridade do backlog do Jira e lidar com o débito técnico da sua equipe para agilizar a entrega de software.
O débito técnico inclui trabalho pendente prometido, mas não entregue ao cliente, defeitos no código ou itens de trabalho que prejudicam a agilidade.
As principais causas do débito técnico: velocidade e escala
As equipes estão sob constante pressão para entregar novas funções mais rápido. Ao mesmo tempo, com o crescimento de produtos e equipes, a complexidade aumenta e as organizações enfrentam uma proliferação de serviços e uma dispersão de software. A propriedade se torna incerta, os silos de conhecimento se formam e encontrar informações se torna um grande desafio. À medida que a complexidade dos produtos cresce, as bases de código se tornam maiores e as equipes continuam a priorizar o lançamento de novas funções, aumenta a probabilidade de ter bugs e problemas de desempenho. As estatísticas são impressionantes:
77%
of devs say their codebase grew 5x over the past 3 years [1]
15%
percent of a dev’s day that’s actually spent coding [2]
70%
of devs encounter a knowledge silo at least once a week [3]
1: Big Code in the AI Era, Sourcegraph; 2: Today was a good day: The Daily Life of Software Developers; 3: Stack Overflow, Developer Survey 2022
As empresas precisam de agilidade para se manterem competitivas e as bem-sucedidas vão crescer em tamanho, receita e variedade de produtos. Então, na prática, todas as organizações devem aprender a gerenciar débitos técnicos de forma eficaz. Até que ponto sua equipe compreende seu débito técnico?
Priorize seu backlog e reduza o débito técnico com o Compass
Na Atlassian, usamos o Compass para manter um catálogo central de todos os serviços, bibliotecas, APIs e outros componentes de software criados e operados por nossas equipes. Com o Compass, as equipes usam o catálogo de software para rastrear facilmente a propriedade do serviço, conectar dados de toda a organização e revelar a integridade do nosso software. Esses insights encorajam as equipes a priorizarem seu trabalho de forma eficaz, a serem mais ágeis e a manterem um padrão alto de qualidade de código. Usar esses insights enfrentar o débito técnico de forma correta resulta em maior agilidade no futuro.
Neste artigo, vamos mostrar como a Atlassian usa o Compass, nossa plataforma de experiência de desenvolvedor, para reduzir o débito técnico e priorizar nosso backlog do Jira.
O Compass ajuda as equipes a entender o impacto de seu trabalho e se planejar de forma eficaz
O Compass é a plataforma de experiência do desenvolvedor da Atlassian, também conhecida como plataforma interna para desenvolvedores ou IDP. Ele foi criado para ajudar na jornada de microsserviços da Atlassian e agilizar nossa experiência de desenvolvedor. O Compass reduz o atrito diário dos desenvolvedores, ajudando a encontrar informações e insights com mais rapidez e acelerando os caminhos para a produção:
Catálogo
Reduza a carga cognitiva com o catálogo abrangente de componentes de software
Integridade
Aplique indicadores de desempenho de integridade, crie e comunique políticas e melhore a experiência de desenvolvedor
Extensibilidade
Conecte as informações essenciais do serviço para poupar tempo de pesquisa e reduzir a troca de contexto
Templates
Automatize a consistência e acelere os caminhos para a produção com templates de software pré-criados
Os componentes do Compass oferecem às equipes uma maneira centralizada de catalogar e entender o software. Os componentes são tudo dentro de um repositório: um serviço, uma biblioteca, um modelo de ML etc. Você pode vincular esses componentes de forma nativa no Jira para que os problemas em seu backlog se conectem às peças reais de software que eles afetam. Isso ajuda as equipes a entender o impacto de seu trabalho e como ele se relaciona com o panorama geral do software.
A equipe de engenharia de plataforma da Atlassian confia no Compass para centralizar informações, padrões e práticas que nos ajudam a manter uma boa experiência de desenvolvedor e cultura de engenharia. Isso significa equipes autônomas, clareza nos padrões e práticas, propriedade clara do serviço e menos tempo pesquisando.
Comece a usar o Compass em minutos: configure seu catálogo, métricas e indicadores de desempenho agora mesmo
Você pode começar a usar o Compass em minutos seguindo algumas etapas simples: (1) importar seus componentes, (2) atribuir às equipes a propriedade de seus componentes, (3) configurar os indicadores de desempenho.
Etapa 1: importe seus componentes de onde eles estiverem
Para a maioria das equipes, isso significa conectar uma ferramenta de gerenciamento de código-fonte (SCM), como Github ou Bitbucket, ou importar repositórios vinculados aos seus projetos do Jira. Você também pode importar componentes de um arquivo CSV ou de qualquer combinação desses métodos para criar de forma rápida um catálogo amplo de tudo o que seus desenvolvedores criam e mantêm.
Você pode começar a usar o Compass em minutos importando seus componentes de onde eles estiverem. Para a maioria das equipes, isso significa conectar uma ferramenta de gerenciamento de código-fonte (SCM), como Github ou Bitbucket, ou importar repositórios vinculados aos seus projetos do Jira. Você também pode importar componentes de um arquivo CSV ou de qualquer combinação desses métodos para criar de forma rápida um catálogo amplo de tudo o que seus desenvolvedores criam e mantêm.
Etapa 2: atribuir equipes como proprietárias de seus componentes
Geralmente, cada componente deve ter uma equipe alocada que seja a principal responsável por sua operação. Adicionar uma equipe do proprietário para cada componente reforça uma cultura de autonomia, ajuda os desenvolvedores a se manterem atualizados com informações relevantes e oferece cobertura técnica para cada componente, mesmo se um indivíduo ou líder não estiver disponível. O Compass usa o diretório da Atlassian para definições de equipes, por isso, todas as equipes existentes que você está usando no Jira já estão disponíveis.
Com o catálogo de componentes, os desenvolvedores de toda a sua organização podem encontrar mais rápido a documentação ou a atividade recente de IC/CD associada a qualquer serviço ou biblioteca. Isso aumenta a produtividade do desenvolvedor ao reduzir o tempo gasto na busca de informações e eliminar as interrupções de informações que agora podem ser obtidas por autoatendimento.
Quando uma ferramenta de SCM é conectada, o Compass detecta de forma automática eventos como implantações e os agrega no feed de atividades. O Compass tem recursos prontos para uso que calculam de modo automático várias métricas importantes, como frequência de implantação e taxa de sucesso do build, com base nos eventos no repositório. Você pode configurar métricas de pesquisa e avaliação de DevOps (DORA) e até mesmo rastrear dados personalizados, como o número de vulnerabilidades de segurança pendentes de um componente.
Etapa 3: configure os indicadores de desempenho para aplicar padrões aos componentes
Com o catálogo já preenchido e as métricas sendo geradas, é hora de usar os indicadores de desempenho. Eles servem para criar e aplicar padrões a componentes da organização inteira. Com os indicadores de desempenho, você pode definir qualquer meta desejada para as métricas dos componentes e dados de campos. Essa é uma maneira de garantir a integridade dos componentes de um software e ter certeza de que as equipes estão seguindo as práticas recomendadas. O Compass vem com alguns indicadores de desempenho padrão prontos com as métricas que recomendamos acompanhar, como Prontidão do componente e Integridade do DevOps. Mas você também pode criar seus indicadores personalizados. Ao analisar os indicadores de desempenho e identificar quais foram reprovados para seus componentes, você vai ter uma noção do débito técnico que precisa corrigir.
Continuando com o exemplo acima, vamos tratar da segurança com um indicador de desempenho personalizado que vai ser reprovado se, a qualquer momento, apontar mais de uma vulnerabilidade de segurança em aberto. As vulnerabilidades de segurança são um exemplo clássico de débito técnico. Primeiro, crie uma métrica para rastrear as vulnerabilidades de segurança. Configure essa métrica para obter dados da fonte correta de cada componente.
Depois, acesse a guia "Indicadores de desempenho" em "Integridade" na barra de navegação superior. Clique em "Criar indicador de desempenho", preencha os detalhes e adicione a métrica de vulnerabilidades de segurança que você criou como critério do indicador de desempenho. Suponha que o indicador de desempenho vai ser reprovado se em algum momento houver mais de uma vulnerabilidade de segurança em aberto. Essa é uma opção adequada para os serviços de nível 1, que são críticos para o funcionamento do software. Defina o operador como "menor ou igual a" e o valor como "1". Defina o peso como "100%" e clique em "Criar". Agora, você tem uma maneira centralizada de monitorar os riscos à segurança e oferecer às equipes orientações claras sobre o que fazer para melhorar a integridade do software.
Na prática, você vai precisar configurar vários indicadores de desempenho para medir diversos padrões e, assim, ter um panorama completo do débito técnico.
Vincule o Compass ao Jira: identifique os débitos técnicos de alto impacto e priorize seu backlog
Agora que você já configurou o Compass, tem tudo o que precisa para identificar e corrigir o débito técnico. Primeiro, verifique se seu projeto do Jira está habilitado para usar componentes do Compass. Clique em "Componentes" na barra de navegação à esquerda e marque o campo suspenso de cima à direita. Se o projeto estiver habilitado, a mensagem "Componentes do Compass" vai ser exibida.
Volte ao Compass e examine os indicadores de desempenho. Identifique as áreas reprovadas ou em risco de reprovação. Com base nas prioridades da sua equipe, determine o problema que deve ser resolvido primeiro. Você pode consultar um indicador específico em "Integridade" e avaliar o desempenho de todos os componentes pertinentes. Também é possível filtrar por equipe proprietária para entender a pontuação dos seus componentes e identificar o débito técnico que precisa ser corrigido.
Considere este outro exemplo que usa o indicador de desempenho Integridade do DevOps, que vem incluso. Você está analisando os componentes da sua equipe e percebe que vários deles foram reprovados no critério de Frequência de implantação. O indicador de desempenho foi definido para ser reprovado caso haja menos de cinco implantações por semana. Você notou que alguns dos componentes têm apenas uma ou duas implantações por semana. Essa é uma questão a ser investigada. Pode ser que esteja ocorrendo um problema no processo de compilação ou nos pipelines de implantação. Ou talvez sua equipe esteja passando por dificuldades técnicas para executar as tarefas. De qualquer forma, é um débito técnico a ser resolvido.
Retorne ao backlog e verifique se há itens relacionados ao problema de implantação lenta. Se não encontrar nada, crie um novo item na própria página do indicador de desempenho no Compass. Confirme se esses itens estão marcados com os componentes corretos do Compass. Dessa forma, você pode se organizar e monitorar o impacto do seu backlog.
A partir daí, você pode incorporar esses itens no próximo sprint ou ao quadro Kanban. Você sabe que eles são um débito técnico de alta prioridade e que o trabalho realizado vai ter impacto no desempenho da arquitetura do seu software. Depois que a equipe resolver o item, volte ao indicador de desempenho Integridade do DevOps e confira o histórico de como a frequência de implantação foi melhorada ao longo do tempo. Esse é um excelente gráfico para mostrar à liderança e à equipe e comprovar o valor do seu trabalho.
Recapitulação: use o Compass para priorizar seu backlog do Jira e reduzir o débito técnico
Nos processos modernos de entrega de software, o débito técnico é inevitável. Mas equipes eficazes sabem como priorizar as questões de maior impacto para manter um alto nível de confiabilidade e consistência de velocidade na entrega de novas funções inovadoras. Ao vincular itens do Jira a um catálogo centralizado de componentes no Compass, as equipes têm acesso a insights sobre o impacto do trabalho. Assim, podem tomar decisões equilibradas entre sanar o débito técnico e entregar funções em poucas etapas:
- Conecte sua ferramenta de SCM ou importe repositórios do Jira ou de um arquivo CSV para configurar de forma rápida um catálogo de software no Compass.
- Comece com indicadores de desempenho inclusos. Depois, crie seus próprios indicadores com métricas e outras fontes de dados para monitorar o desempenho do software em comparação aos padrões e práticas da organização. Em seguida, identifique os débitos técnicos de alta prioridade.
- Inclua o Compass nos seus rituais semanais enquanto gerencia o débito técnico e resolve os itens no backlog para evitar incidentes e entregar novas funções com consistência.