Conventional Commits: guia completa para equipos de software

Conventional Commits no es una moda de estilo. Es una interfaz de comunicacion entre humanos, CI/CD y tooling.

Si tu historial de git parece una conversacion caotica, pierdes trazabilidad, automatizacion y contexto.

Estructura minima

<type>(optional-scope): <description>

Tipos mas utiles en equipos:

• feat: nueva funcionalidad
• fix: correccion
• refactor: mejora interna sin cambio funcional
• docs: documentacion
• test: pruebas
• chore: mantenimiento

Ejemplos buenos

• feat(auth): add refresh token rotation for mobile sessions
• fix(payments): handle timeout retries with exponential backoff
• docs(ci): document crosspost workflow and fallback behavior

Errores comunes

• Mensajes genericos (update, changes, fix stuff)
• Mezclar 4 tipos de cambio en un solo commit
• Scope inexistente o arbitrario

Adopcion sin friccion

1. Define convencion minima de tipos.
2. Agrega validacion en hooks/CI.
3. Empieza por nuevos commits (sin reescribir historia vieja).
4. Mide impacto en releases y debugging.

Integracion con tu stack

Con una convencion estable puedes:

• generar changelog automatico,
• controlar semantic versioning,
• auditar cambios por area de dominio.

En este blog ya hay casos relacionados para profundizar:

• /blog/11-how-to-setup-multiple-git-accounts-with-ssh/
• /blog/13-syncing-and-signing-commits-for-different-remotes-and-different-git-accounts-using-hooks-from-a-single-local-repository/
• Hub Git: /blog/category/git/

Cierre

Un commit message bueno reduce dudas futuras. No escribes para el presente, escribes para tu equipo de dentro de 3 meses.