Times e contribuidores
Organize contribuidores em times para comparar squads e recortar métricas por grupo. Esta página explica por que vale a pena estruturar seus times, como criá-los, a diferença entre membros automáticos e contribuidores manuais, e como o filtro de Time muda o que você vê em toda a plataforma.
Por que organizar em times#
A atividade bruta dos repositórios mistura todo mundo. Ao agrupar em times você consegue:
- Filtrar qualquer tela para a atividade de um squad específico.
- Comparar squads lado a lado na tela Times (cycle time, throughput, rework, review), recurso do plano Starter.
- Dar contexto organizacional aos números: um cycle time alto faz mais sentido quando você sabe de qual squad é, e quem o compõe.
A regra de ouro: espelhe a estrutura real de squads. Comparações entre times só são justas quando os times refletem como o trabalho realmente se organiza.
Criar um time#
- Abra Times no menu lateral.
- Crie um time dando a ele um nome (ex.: "Backend", "Plataforma", "Mobile").
Pronto: o time já existe e pode receber membros.
Membros: automáticos vs. manuais#
Um time é composto por contribuidores, que entram de duas formas:
Membros vinculados pela atividade real#
A maioria dos membros são pessoas que já aparecem na atividade dos repositórios: autores de PRs, revisores, autores de commits. Você os vincula ao time a partir dessa atividade real. Como têm rastro de código, eles contam para todas as métricas do squad (cycle time, throughput, rework, review etc.).
Esses contribuidores também aparecem na tela Contribuidores, que é a visão por pessoa de quem atua nos repositórios.
Contribuidores manuais#
Nem todo membro do squad escreve código: pense em PO, designer, gestor. Para representar o squad completo, você pode cadastrar um contribuidor manual, informando nome e papel, mesmo sem atividade de código associada.
| Membro vinculado pela atividade | Contribuidor manual | |
|---|---|---|
| Origem | Atividade real (PRs, reviews, commits) | Cadastrado à mão |
| Tem rastro de código? | Sim | Não |
| Entra nas métricas de código? | Sim | Não (só compõe o squad) |
| Uso típico | Devs | PO, designer, gestor |
Como o filtro de Time afeta as métricas#
Com o filtro de Time ativo (no topo de qualquer tela), as métricas passam a considerar apenas a
atividade dos membros daquele time. Combine com os filtros de período e repositório para recortes
precisos. Por exemplo: "Backend, nos últimos 30 dias, no repositório api".
Na tela Times, você não filtra para um só squad: você os vê lado a lado, comparando os mesmos indicadores entre eles.
Como o filtro de Time é global, ele também é o padrão do assistente de IA: se um time está selecionado, perguntas como "qual o nosso cycle time?" respondem sobre aquele squad.
Organizar por produto ou projeto#
Além de membros, um time possui repositórios (na aba Repositórios do botão Gerenciar do time). É essa propriedade que recorta as telas baseadas em código, em especial a tela Projeto (progresso, saúde de issues, fluxo de valor, mapa de conhecimento). Como um mesmo repositório pode pertencer a mais de um time, dá para modelar produtos sem duplicar nada.
Cenário comum: um squad cuida de dois produtos, cada um com um repo de front e um de back (Produto 1
= front-1 + back-1, Produto 2 = front-2 + back-2). Para ver cada produto separado:
- Sem hierarquia (qualquer plano): crie um time por produto ("Produto 1" dono de
front-1+back-1, "Produto 2" dono defront-2+back-2). Se também quiser a visão combinada, crie um time "Squad" dono dos quatro (o mesmo repo pode estar nos dois times ao mesmo tempo). No topo, troque o escopo entre os times. - Com hierarquia (Enterprise): crie os times por produto e um grupo "Squad" com os dois aninhados (tela Hierarquia). O escopo do grupo soma os repos dos times abaixo automaticamente (dispensa o time combinado) e ainda habilita o acesso escopado (um visualizador vê só o produto dele).
O que cada escopo passa a mostrar na tela Projeto:
| Escopo selecionado | Telas de código (progresso, issues, fluxo, conhecimento) |
|---|---|
| Time "Produto 1" | só front-1 + back-1 |
| Time "Produto 2" | só front-2 + back-2 |
| Grupo "Squad" (ou time combinado) | os quatro repos |
| Filtro de Repositório | um repo só |
Limites: o agrupamento é sempre por time (um conjunto de repos). Não existe um objeto "produto" próprio. Milestones e issues continuam por repositório. O filtro Projeto (no topo da tela Projeto) recorta apenas os dados de tracker (Jira/Azure); as telas de código seguem o escopo de Time / Grupo / Repositório. Para isolar só o front ou só o back de um produto, use o filtro de Repositório (um de cada vez).
Se cada produto tem um projeto de tracker próprio (Jira/Azure), atribua-o ao time correspondente (é o que a próxima seção explica) para que os cards de planejamento também acompanhem o produto.
Projetos do tracker por time#
Se você usa Jira e/ou Azure Boards, pode atribuir cada projeto do tracker a um time. Por
exemplo: "o time Pagamentos cuida do Jira PAY; o time Infra cuida do Azure Platform". Com isso, o filtro
de Time passa a recortar as métricas de planejamento (backlog, fluxo de valor, story points) pelos
projetos daquele time.
No card Projetos do tracker por time (na tela Times, visível para Owner/Admin), cada projeto ativo tem um seletor: escolha o time dono ou "Organização toda" (sem dono, vale para todos). Sem atribuição, o projeto vale para a organização inteira.
Os projetos do tracker são uma camada diferente dos membros: atribuí-los a um time recorta as métricas de planejamento, enquanto os membros recortam as de código. Detalhes em Projetos e múltiplos trackers.
A tela Contribuidores#
Separada da tela Times, a tela Contribuidores é a visão por pessoa: quem atua nos repositórios e como (PRs, reviews, commits). É a partir dessa atividade que os membros vinculados dos times são identificados.
Boas práticas#
- Espelhe os squads reais para que as comparações na tela Times sejam justas.
- Use contribuidores manuais com parcimônia: eles servem para representar a composição do squad (quem faz parte), não para inflar métricas de produção de código. Afinal, não têm atividade de código.
- Revise os times quando a organização muda (reorgs, novos squads) para manter os números fiéis.
Perguntas frequentes#
Um dev aparece em dois times. Pode? Organize conforme a realidade do seu time; o objetivo é que cada time reflita um squad real, então mantenha a composição condizente com como o trabalho se divide.
Cadastrei um contribuidor manual e o cycle time do time não mudou. Normal? Sim. Contribuidores manuais não têm atividade de código, então não entram nas métricas de produção. Eles só representam a composição do squad.
Onde comparo os times? Na tela Times, lado a lado (recurso do plano Starter). Para focar em um único squad em qualquer outra tela, use o filtro de Time do topo.
Próximos passos#
- Dashboards e telas: como os filtros globais (incluindo Time) recortam as telas.
- Projetos e múltiplos trackers: atribuir projetos de Jira/Azure a times.
- Glossário de métricas: o que cada indicador comparado entre times significa.