7 min leitura • Guide 93 of 877
Usando Labels e Tags Efetivamente
Labels e tags transformam uma lista plana de tarefas em um sistema multidimensional que habilita filtragem instantânea, relatórios precisos, e automação de workflow. As capacidades de labels do GitScrum permitem categorizar trabalho por prioridade, tipo, componente, time, e qualquer dimensão customizada que seu workflow exija. A chave é estabelecer uma taxonomia consistente que todo o time use confiavelmente, evitando proliferação de labels que cria confusão.
Estratégia de Labels
Desenhando Sua Taxonomia
CONSTRUINDO UM SISTEMA DE LABELS:
┌─────────────────────────────────────────────────────────────┐
│ CATEGORIAS DE LABELS │
├─────────────────────────────────────────────────────────────┤
│ │
│ CATEGORIAS ESSENCIAIS: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ 1. PRIORIDADE (quão urgente) ││
│ │ 🔴 critical – Largar tudo ││
│ │ 🟠 high – Este sprint, importante ││
│ │ 🟡 medium – Trabalho planejado ││
│ │ 🟢 low – Nice to have ││
│ │ ││
│ │ 2. TIPO (que tipo de trabalho) ││
│ │ 🐛 bug – Algo quebrado ││
│ │ ✨ feature – Nova capacidade ││
│ │ 🔧 improvement – Melhorar existente ││
│ │ 📚 docs – Documentação ││
│ │ 🧹 chore – Manutenção, limpeza ││
│ │ 🔬 spike – Pesquisa, investigação ││
│ │ ││
│ │ 3. STATUS (estado workflow além de colunas) ││
│ │ 🚧 blocked – Não pode continuar ││
│ │ 👀 needs-review – Aguardando review ││
│ │ ✅ ready – Pronto para começar ││
│ │ 🔙 returned – Devolvido para mudanças ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ CATEGORIAS CONTEXTUAIS: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ 4. COMPONENTE (onde no codebase) ││
│ │ frontend, backend, api, database, mobile ││
│ │ auth, payments, notifications, analytics ││
│ │ ││
│ │ 5. ESFORÇO (estimativa tamanho) ││
│ │ xs (< 1 hora) ││
│ │ s (1-4 horas) ││
│ │ m (1-2 dias) ││
│ │ l (3-5 dias) ││
│ │ xl (1+ semanas) ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Convenções de Nomes
MELHORES PRÁTICAS NOMES:
┌─────────────────────────────────────────────────────────────┐
│ NOMES CONSISTENTES │
├─────────────────────────────────────────────────────────────┤
│ │
│ USAR PREFIXOS PARA AGRUPAR: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Formato: categoria/valor ││
│ │ ││
│ │ priority/critical ││
│ │ priority/high ││
│ │ priority/medium ││
│ │ priority/low ││
│ │ ││
│ │ type/bug ││
│ │ type/feature ││
│ │ type/improvement ││
│ │ ││
│ │ Benefícios: ││
│ │ • Labels ordenam juntas alfabeticamente ││
│ │ • Fácil filtrar por categoria ││
│ │ • Claro qual dimensão cada label representa ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ REGRAS DE NOMES: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ ✅ SIM: ││
│ │ • Usar minúsculas: priority/high ││
│ │ • Usar hífens para multi-palavra: good-first-issue ││
│ │ • Ser específico: component/auth-service ││
│ │ ││
│ │ ❌ NÃO: ││
│ │ • Maiúsculas mistas: Priority/High ││
│ │ • Espaços: "priority high" ││
│ │ • Vagos: misc, other, stuff ││
│ │ • Duplicados: bug, bugs, bug-fix, bugfix ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Codificação por Cores
Hierarquia Visual
ESTRATÉGIA DE CORES:
┌─────────────────────────────────────────────────────────────┐
│ USANDO CORES EFETIVAMENTE │
├─────────────────────────────────────────────────────────────┤
│ │
│ CORES PRIORIDADE (semáforo intuitivo): │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ 🔴 Vermelho – Crítico, urgente ││
│ │ 🟠 Laranja – Alto, importante ││
│ │ 🟡 Amarelo – Médio, normal ││
│ │ 🟢 Verde – Baixo, pode esperar ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ CORES TIPO (significado semântico): │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ 🔴 Vermelho – Bug (algo errado) ││
│ │ 🟣 Roxo – Feature (coisa nova) ││
│ │ 🔵 Azul – Melhoria (coisa melhor) ││
│ │ 🟤 Marrom – Documentação ││
│ │ ⚫ Cinza – Chore (manutenção) ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ CORES STATUS (nível atenção): │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ 🔴 Vermelho – Bloqueado (precisa atenção!) ││
│ │ 🟡 Amarelo – Precisa review (ação necessária) ││
│ │ 🟢 Verde – Pronto (pode começar) ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Filtragem e Relatórios
Filtragem Poderosa
USANDO LABELS PARA FILTRAR:
┌─────────────────────────────────────────────────────────────┐
│ COMBINAÇÕES FILTRO │
├─────────────────────────────────────────────────────────────┤
│ │
│ PADRÕES COMUNS FILTRO: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ "Quais bugs precisam atenção?" ││
│ │ Filtro: type/bug + priority/high ││
│ │ ││
│ │ "O que está bloqueado agora?" ││
│ │ Filtro: status/blocked ││
│ │ ││
│ │ "Qual trabalho frontend está pronto?" ││
│ │ Filtro: component/frontend + status/ready ││
│ │ ││
│ │ "Quais tarefas pequenas para novos devs?" ││
│ │ Filtro: effort/xs OU effort/s + good-first-issue ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ FILTROS SALVOS NO GITSCRUM: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ Criar views salvas para combinações comuns: ││
│ │ ││
│ │ "Bugs Este Sprint" ││
│ │ → type/bug + sprint atual ││
│ │ ││
│ │ "Minha Alta Prioridade" ││
│ │ → assigned:me + priority/high OU priority/critical ││
│ │ ││
│ │ "Pronto para Dev" ││
│ │ → status/ready + sem assignee ││
│ │ ││
│ │ "Trabalho Bloqueado" ││
│ │ → status/blocked ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Automação Workflow
Regras Baseadas em Labels
AUTOMATIZANDO COM LABELS:
┌─────────────────────────────────────────────────────────────┐
│ TRIGGERS AUTOMAÇÃO │
├─────────────────────────────────────────────────────────────┤
│ │
│ PADRÕES COMUNS AUTOMAÇÃO: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ TRIGGER: Label priority/critical adicionada ││
│ │ AÇÃO: ││
│ │ • Notificar #canal-urgente no Slack ││
│ │ • Atribuir à rotação on-call ││
│ │ • Mover para topo do board ││
│ │ ││
│ │ TRIGGER: Label status/blocked adicionada ││
│ │ AÇÃO: ││
│ │ • Notificar project manager ││
│ │ • Criar lembrete diário até desbloquear ││
│ │ • Adicionar ao relatório "Bloqueadores" ││
│ │ ││
│ │ TRIGGER: Label needs-review adicionada ││
│ │ AÇÃO: ││
│ │ • Notificar canal reviewers ││
│ │ • Iniciar timer review ││
│ └─────────────────────────────────────────────────────────┘│
│ │
└─────────────────────────────────────────────────────────────┘
Governança
Prevenindo Proliferação Labels
HIGIENE LABELS:
┌─────────────────────────────────────────────────────────────┐
│ MANTENDO LABELS GERENCIÁVEIS │
├─────────────────────────────────────────────────────────────┤
│ │
│ SINTOMAS PROLIFERAÇÃO: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ ⚠️ 100+ labels no sistema ││
│ │ ⚠️ Múltiplas labels significando mesma coisa ││
│ │ (bug, bug-fix, bugfix, bugs) ││
│ │ ⚠️ Labels não usadas em 3+ meses ││
│ │ ⚠️ Pessoas criam labels sem perguntar ││
│ │ ⚠️ Ninguém sabe o que algumas labels significam ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ REGRAS GOVERNANÇA: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ 1. LIMITAR QUEM PODE CRIAR: ││
│ │ Só team leads/PM podem criar novas labels ││
│ │ Processo de solicitação para novas propostas ││
│ │ ││
│ │ 2. DOCUMENTAR LABELS: ││
│ │ No NoteVault, manter glossário labels: ││
│ │ • Nome ││
│ │ • Cor ││
│ │ • Quando usar ││
│ │ • Quando NÃO usar ││
│ │ • Exemplos ││
│ │ ││
│ │ 3. AUDITORIA TRIMESTRAL: ││
│ │ Revisar todas labels: ││
│ │ • Deletar não usadas ││
│ │ • Mesclar duplicatas ││
│ │ • Renomear confusas ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ META: 30-50 labels máximo para maioria dos times │
│ │
└─────────────────────────────────────────────────────────────┘