7 min leitura • Guide 751 of 877
Usando Labels Efetivamente no GitScrum
Labels ajudam a categorizar e encontrar trabalho rapidamente. O sistema de labels do GitScrum permite que equipes criem taxonomias customizadas que combinam com seu workflow.
Estratégia de Labels
Para Que Servem Labels
USO EFETIVO DE LABELS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ LABELS SÃO BONS PARA: │
│ │
│ ✅ CATEGORIZAÇÃO │
│ Tipo: bug, feature, melhoria, docs │
│ Área: frontend, backend, api, infraestrutura │
│ │
│ ✅ FILTRAGEM │
│ "Mostre todos os bugs de frontend" │
│ "O que está bloqueado agora?" │
│ │
│ ✅ VISIBILIDADE │
│ Label "urgente" chama atenção │
│ "precisa-review" mostra itens esperando │
│ │
│ ✅ PREOCUPAÇÕES TRANSVERSAIS │
│ "tech-debt" abrange todas as áreas │
│ "quick-win" abrange todos os tipos │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ LABELS NÃO SÃO PARA: │
│ │
│ ❌ VALORES ÚNICOS (use campos customizados) │
│ Prioridade: só um valor → use campo │
│ Sprint: só um valor → use campo │
│ │
│ ❌ DADOS COMPLEXOS (use descrições/campos) │
│ "deadline-jan-15" → use campo de data │
│ "atribuído-alex" → use campo de responsável │
│ │
│ ❌ ESTADOS TEMPORÁRIOS (use status) │
│ "em-progresso" → use status do workflow │
│ "feito" → use status do workflow │
└─────────────────────────────────────────────────────────────┘
Taxonomia de Labels
CATEGORIAS DE LABELS RECOMENDADAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ TIPO (Que tipo de trabalho): │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ 🐛 bug │ Algo está quebrado │ │
│ │ ✨ feature │ Nova funcionalidade │ │
│ │ ⬆️ melhoria │ Melhorar feature existente │ │
│ │ 📄 docs │ Apenas documentação │ │
│ │ 🔧 chore │ Trabalho de manutenção │ │
│ │ 🧪 teste │ Trabalho relacionado a testes │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
│ ÁREA (Que parte do sistema): │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ frontend │ Trabalho de UI/UX │ │
│ │ backend │ Trabalho server-side │ │
│ │ api │ Endpoints de API │ │
│ │ database │ Camada de dados │ │
│ │ devops │ Infraestrutura │ │
│ │ mobile │ App mobile │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
│ STATUS (Estados especiais): │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ 🚫 bloqueado │ Esperando dependência externa │ │
│ │ 👀 precisa-review │ Esperando revisão │ │
│ │ ❓ precisa-info │ Falta informação │ │
│ │ 🔥 urgente │ Atenção de alta prioridade │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
│ ESFORÇO (Dimensionamento rápido): │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ 🎯 quick-win │ < 30 minutos │ │
│ │ 📦 good-first-issue│ Bom para novos contribuidores │ │
│ │ 🏔️ épico │ Esforço grande multi-sprint │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Convenções de Nomenclatura
Nomes Consistentes de Labels
MELHORES PRÁTICAS DE NOMENCLATURA:
┌─────────────────────────────────────────────────────────────┐
│ │
│ FORMATO: prefixo:nome │
│ │
│ EXEMPLOS: │
│ tipo:bug │
│ tipo:feature │
│ area:frontend │
│ area:backend │
│ prioridade:critica │
│ status:bloqueado │
│ │
│ POR QUE PREFIXOS: │
│ │
│ 1. AGRUPAMENTO │
│ Todos labels "tipo:" ordenam juntos │
│ Fácil ver categorias de labels │
│ │
│ 2. CLAREZA │
│ "tipo:bug" é mais claro que apenas "bug" │
│ Contexto imediato │
│ │
│ 3. GOVERNANÇA │
│ Fácil ver se categoria já existe │
│ Evita duplicação │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ OUTRAS CONVENÇÕES: │
│ │
│ ✓ Use minúsculas │
│ ✓ Use hífen para separar palavras │
│ ✓ Seja breve mas descritivo │
│ ✓ Consistência é mais importante que perfeição │
│ │
│ ✗ Evite espaços (use hífens) │
│ ✗ Evite caracteres especiais │
│ ✗ Não misture idiomas │
└─────────────────────────────────────────────────────────────┘
Governança de Labels
Mantendo Labels Limpos
GOVERNANÇA DE LABELS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ QUEM PODE CRIAR: │
│ ───────────────── │
│ Opção 1: Qualquer um (cuidado com proliferação) │
│ Opção 2: Apenas admins/leads (mais controle) │
│ Opção 3: Aprovação necessária (balanceado) │
│ │
│ Recomendação: Comece restrito, relaxe se necessário │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ AUDITORIA REGULAR: │
│ ────────────────── │
│ │
│ Mensal ou trimestral: │
│ ├── Listar todos os labels │
│ ├── Identificar não usados │
│ ├── Identificar duplicados │
│ ├── Consolidar similares │
│ └── Deletar obsoletos │
│ │
│ Perguntas de auditoria: │
│ • Esse label é usado? (últimos 90 dias) │
│ • Adiciona informação útil? │
│ • É distinto de outros labels? │
│ • Segue as convenções? │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ DOCUMENTAÇÃO: │
│ ───────────── │
│ │
│ Mantenha lista de labels com: │
│ ├── Nome │
│ ├── Descrição │
│ ├── Quando usar │
│ ├── Quando NÃO usar │
│ └── Exemplos │
│ │
│ Exemplo: │
│ tipo:bug │
│ "Use quando algo que funcionava parou de funcionar. │
│ NÃO use para features faltando ou melhorias." │
└─────────────────────────────────────────────────────────────┘
Usando Labels para Filtrar
FILTRAGEM COM LABELS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ FILTROS COMUNS: │
│ │
│ Ver todos os bugs: │
│ → Filtrar por tipo:bug │
│ │
│ Ver bugs de frontend: │
│ → Filtrar por tipo:bug E area:frontend │
│ │
│ Ver work bloqueado: │
│ → Filtrar por status:bloqueado │
│ │
│ Ver quick wins disponíveis: │
│ → Filtrar por esforço:quick-win │
│ │
│ Ver tech debt acumulada: │
│ → Filtrar por tipo:tech-debt │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ VIEWS SALVAS: │
│ │
│ Crie views salvas para filtros frequentes: │
│ │
│ "Bugs Urgentes" │
│ → tipo:bug + status:urgente │
│ │
│ "Backlog de Tech Debt" │
│ → tipo:tech-debt + status != feito │
│ │
│ "Meu Trabalho (Frontend)" │
│ → area:frontend + atribuído a mim │
└─────────────────────────────────────────────────────────────┘
Erros Comuns
ERROS A EVITAR:
┌─────────────────────────────────────────────────────────────┐
│ │
│ ERRO 1: LABELS DEMAIS │
│ ───────────────────── │
│ ❌ Tarefa com 10 labels │
│ ❌ Labels que ninguém entende │
│ ❌ Labels redundantes com campos │
│ │
│ ✅ 1-4 labels por tarefa │
│ ✅ Cada label tem propósito claro │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ ERRO 2: LABELS MUITO ESPECÍFICOS │
│ ──────────────────────────────── │
│ ❌ "sprint-23-bugfix-login-modal" │
│ ❌ "joão-tarefa-segunda" │
│ │
│ ✅ Labels genéricos e reutilizáveis │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ ERRO 3: SEM GOVERNANÇA │
│ ────────────────────── │
│ ❌ Qualquer um cria qualquer label │
│ ❌ Nunca limpa labels antigos │
│ ❌ Labels inconsistentes │
│ │
│ ✅ Processo claro para criar labels │
│ ✅ Auditoria regular │
│ ✅ Documentação de labels │
└─────────────────────────────────────────────────────────────┘