#400 · Herramienta para desarrolladores

Branch Name Generator

Convierte una descripción de tarea en un nombre de rama Git consistente. Elige un tipo como feature, fix, hotfix, chore o docs, añade un ticket opcional y selecciona el separador. El generador elimina acentos, símbolos problemáticos y repeticiones, produce una versión legible en minúsculas y avisa cuando el nombre resultante es demasiado largo para resultar cómodo en comandos, CI o interfaces de pull requests.

Datos de entrada

Descripción de la rama
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Describe el cambio con pocas palabras pero suficiente contexto.
  2. Selecciona el tipo de rama que usa tu equipo.
  3. Añade un identificador de ticket si forma parte de vuestra convención.
  4. Genera el nombre y acorta la descripción si el resultado queda demasiado largo.

Qué hace esta herramienta para desarrolladores

El nombre combina un prefijo de tipo, un ticket opcional y un slug normalizado. Se eliminan acentos y símbolos para reducir problemas al escribir la rama en terminales, scripts y URLs.

La descripción pasa por normalización Unicode NFKD, eliminación de marcas diacríticas, minúsculas y sustitución de grupos de símbolos por el separador elegido. Después se añade el tipo y, si existe, el ticket.

Git admite más caracteres que los usados aquí. El generador aplica una convención conservadora para priorizar portabilidad y nombres fáciles de copiar.

Ejemplo

Tipo: fix Ticket: AUTH-42 Descripción: Corregir error de sesión al renovar el token

Puede generar fix/AUTH-42/corregir-error-de-sesion-al-renovar-el-token.

Casos de uso

  • Aplicar una convención homogénea en equipos grandes.
  • Crear ramas desde tickets de Jira, Linear u otros trackers.
  • Evitar espacios, tildes y símbolos poco prácticos en nombres de rama.

Consejos para obtener resultados fiables

  • Mantén la descripción centrada en un solo cambio.
  • Usa el mismo conjunto de tipos que tu convención de commits cuando sea útil.
  • No incluyas datos sensibles ni nombres de clientes en ramas públicas.
  • Evita nombres de más de 100 caracteres salvo necesidad.
  • Alinea el formato del ticket con las automatizaciones de tu plataforma.

Detalles del procesamiento

La generación es determinista para los mismos valores de entrada. No consulta el repositorio, por lo que no sabe si la rama ya existe ni si hay reglas de protección sobre su patrón.

No ejecuta git check-ref-format ni inspecciona políticas del servidor. La convención generada evita muchos caracteres conflictivos, pero debes confirmar reglas internas específicas de tu equipo.

Preguntas frecuentes

¿Cómo genero nombres de rama Git con un ticket como ABC-123?

Introduce ABC-123 en el campo Ticket y la descripción de la tarea; el identificador se insertará entre el tipo y el slug.

¿Por qué el generador elimina tildes y caracteres especiales?

Usa una convención conservadora para facilitar el uso del nombre en terminales, scripts, URLs y herramientas de CI.

¿Puedo usar guion bajo en lugar de guion para separar palabras?

Sí. Cambia el selector de separador y el slug utilizará _ entre las palabras normalizadas.

¿El nombre generado garantiza que git check-ref-format lo acepte?

El formato evita muchos caracteres problemáticos, pero no ejecuta Git. Si necesitas una garantía estricta, valida el resultado con git check-ref-format --branch.

¿Cómo evito nombres de rama demasiado largos?

Reduce la descripción a la intención principal del cambio y conserva el ticket solo si tu flujo realmente lo necesita.

Módulos de la herramienta

MóduloQué comprueba o genera
Normalizador UnicodeElimina diacríticos y símbolos no deseados.
Constructor de convenciónUne tipo, ticket y slug.
Control de longitudMide el resultado y avisa si supera 100 caracteres.