Usando Etiquetas en GitScrum | Guía
Organiza el trabajo con etiquetas en GitScrum. Crea un sistema de etiquetas que mejore la visibilidad y filtrado.
7 min de lectura
Las etiquetas transforman un backlog caótico en un sistema organizado. GitScrum permite etiquetas personalizadas con colores para categorizar trabajo por tipo, área, prioridad, o cualquier dimensión que necesites.
Estrategia de Etiquetas
Planificando tu Taxonomía
CONSTRUYENDO UN SISTEMA DE ETIQUETAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ ANTES DE CREAR ETIQUETAS, PREGUNTA: │
│ │
│ 1. ¿Qué preguntas necesitas responder? │
│ • "¿Cuánto trabajo de bugs hay?" │
│ • "¿Qué está afectando al frontend?" │
│ • "¿Qué hay bloqueado?" │
│ │
│ 2. ¿Cómo filtran trabajo las personas? │
│ • Por tipo de trabajo │
│ • Por área del producto │
│ • Por estado o urgencia │
│ • Por equipo o persona │
│ │
│ 3. ¿Qué reportes necesitas generar? │
│ • Distribución de trabajo por tipo │
│ • Velocidad por área │
│ • Bugs por componente │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ PRINCIPIOS CLAVE: │
│ │
│ ✅ Menos es más - 15-30 etiquetas total │
│ ✅ Consistencia sobre perfección │
│ ✅ Fácil de entender sin documentación │
│ ✅ Mutuamente excluyente donde sea posible │
│ ✅ Evoluciona basado en uso │
└─────────────────────────────────────────────────────────────┘
Categorías Comunes
CATEGORÍAS DE ETIQUETAS RECOMENDADAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ POR TIPO DE TRABAJO: │
│ │
│ type:feature → Nueva funcionalidad │
│ type:bug → Comportamiento roto │
│ type:tech-debt → Mejoras técnicas │
│ type:docs → Documentación │
│ type:spike → Investigación │
│ type:chore → Mantenimiento │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ POR ÁREA DEL PRODUCTO: │
│ │
│ area:frontend → Trabajo de UI │
│ area:backend → Servicios de API │
│ area:database → Trabajo de BD │
│ area:infra → Infraestructura │
│ area:mobile → App móvil │
│ area:auth → Autenticación │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ POR ESTADO: │
│ │
│ status:blocked → Esperando algo externo │
│ status:on-hold → Intencionalmente pausado │
│ status:needs-qa → Listo para testing │
│ status:ready → Listo para trabajo │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ POR ESFUERZO: │
│ │
│ effort:small → < 1 día │
│ effort:medium → 1-3 días │
│ effort:large → 3-5 días │
│ effort:epic → > 1 semana (dividir) │
└─────────────────────────────────────────────────────────────┘
Convenciones de Nombres
Patrones de Nombres
CONVENCIONES DE NOMBRES DE ETIQUETAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ USA PREFIJOS PARA CATEGORIZACIÓN: │
│ │
│ FORMATO: categoria:valor │
│ │
│ Ejemplos: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ type:bug ││
│ │ type:feature ││
│ │ area:checkout ││
│ │ area:dashboard ││
│ │ priority:critical ││
│ │ priority:low ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ BENEFICIOS: │
│ • Etiquetas ordenan juntas por categoría │
│ • Claro a qué dimensión pertenece │
│ • Fácil de filtrar por prefijo │
│ • Auto-documentado │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ REGLAS DE FORMATO: │
│ │
│ ✅ minúsculas │
│ ✅ guiones-para-espacios │
│ ✅ singular (bug, no bugs) │
│ ✅ conciso (3 palabras máx) │
│ │
│ EVITAR: │
│ ❌ MayúsculasMezcladas │
│ ❌ espacios en etiquetas │
│ ❌ etiquetas muy largas │
│ ❌ inconsistencia (bug vs Bug vs BUG) │
└─────────────────────────────────────────────────────────────┘
Estrategia de Colores
Sistema de Colores
COLORES DE ETIQUETAS CON SIGNIFICADO:
┌─────────────────────────────────────────────────────────────┐
│ │
│ USA COLORES CONSISTENTEMENTE: │
│ │
│ ETIQUETAS DE TIPO: │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ 🔴 ROJO → bug, error, defect │ │
│ │ 🟢 VERDE → feature, enhancement │ │
│ │ 🔵 AZUL → tech-debt, refactor │ │
│ │ 🟡 AMARILLO → docs, documentation │ │
│ │ 🟣 MORADO → spike, research │ │
│ │ ⚪ GRIS → chore, maintenance │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
│ ETIQUETAS DE PRIORIDAD: │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ 🔴 ROJO → critical, urgent │ │
│ │ 🟠 NARANJA → high │ │
│ │ 🟡 AMARILLO → medium │ │
│ │ 🟢 VERDE → low │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
│ ETIQUETAS DE ÁREA: │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ Usar tonos de misma familia de color │ │
│ │ O categoría de color distinta de tipo/prioridad │ │
│ │ │ │
│ │ 🔵 Azul claro → frontend │ │
│ │ 🔵 Azul medio → backend │ │
│ │ 🔵 Azul oscuro → database │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
│ ETIQUETAS DE ESTADO: │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ ⚫ NEGRO → blocked (alto contraste, atención) │ │
│ │ 🟠 NARANJA → needs-review │ │
│ │ 🟣 MORADO → on-hold │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Gobernanza
Gestión de Etiquetas
MANTENIENDO ETIQUETAS ORGANIZADAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ ROLES DE GOBERNANZA: │
│ │
│ ADMIN DE ETIQUETAS (1-2 personas): │
│ • Pueden crear nuevas etiquetas │
│ • Revisan solicitudes de etiquetas │
│ • Limpian duplicados │
│ • Documentan significados │
│ │
│ TODOS LOS MIEMBROS DEL EQUIPO: │
│ • Pueden aplicar etiquetas existentes │
│ • Solicitan nuevas etiquetas │
│ • Reportan etiquetas confusas │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ PROCESO DE SOLICITUD DE ETIQUETAS: │
│ │
│ 1. ¿Existe una etiqueta para esto? │
│ → Buscar antes de solicitar │
│ │
│ 2. ¿Por qué la necesitamos? │
│ → Justificar caso de uso │
│ │
│ 3. ¿Cuántos items se aplicarían? │
│ → Si < 5 items, probablemente no vale │
│ │
│ 4. Admin aprueba y crea │
│ → Estandariza nombre y color │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ LIMPIEZA REGULAR: │
│ │
│ Trimestral: │
│ ☐ Revisar etiquetas no usadas (0 items) │
│ ☐ Fusionar duplicados │
│ ☐ Renombrar confusos │
│ ☐ Actualizar colores si es necesario │
│ ☐ Documentar cambios │
└─────────────────────────────────────────────────────────────┘
Auditoría de Etiquetas
AUDITANDO USO DE ETIQUETAS:
┌─────────────────────────────────────────────────────────────┐
│ │
│ MÉTRICAS A RASTREAR: │
│ │
│ COBERTURA: │
│ • % de items con etiqueta de tipo → Meta: 100% │
│ • % de items con etiqueta de área → Meta: >90% │
│ • % de items sin etiquetas → Meta: <5% │
│ │
│ SALUD: │
│ • Etiquetas nunca usadas → Eliminar │
│ • Etiquetas usadas una vez → Considerar │
│ • Etiquetas muy usadas (>50%) → Útil o genérica? │
│ │
│ ─────────────────────────────────────────────────────────── │
│ │
│ REPORTE DE AUDITORÍA: │
│ │
│ Etiquetas Más Usadas: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ type:feature ████████████████████ 234 items ││
│ │ type:bug ████████████ 156 items ││
│ │ area:frontend ██████████ 128 items ││
│ │ priority:high ████████ 98 items ││
│ │ status:blocked ████ 45 items ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ Etiquetas Candidatas para Eliminación: │
│ ┌─────────────────────────────────────────────────────────┐│
│ │ legacy-code │ 1 item │ 6 meses antiguo ││
│ │ temp │ 0 items │ Nunca usado ││
│ │ fix-later │ 2 items │ Vago ││
│ └─────────────────────────────────────────────────────────┘│
│ │
│ ACCIÓN: Revisar con equipo, fusionar o eliminar │
└─────────────────────────────────────────────────────────────┘