¿Qué son los Conventional Commits?
Conventional Commits es una especificación que define cómo deben escribirse los commits en Git. Su objetivo es lograr un historial más claro.
Cada commit sigue una estructura predecible que describe la intención del cambio: si corrige un error (fix), agrega una funcionalidad (feat) o introduce un cambio importante (breaking change).
Estructura de un Commit Convencional
Un commit se compone así:
<tipo>[ámbito opcional]: <descripción>
[cuerpo opcional]
[nota(s) al pie opcional(es)]- Tipo (
<tipo>): comunica la intención del cambio (por ejemplo, feat, fix o docs). - Ámbito (opcional): indica qué parte del código se modificó, por ejemplo, feat(api) o fix(auth).
- Descripción: breve y concisa, explica el cambio.
- Cuerpo (opcional): da contexto o detalles técnicos.
- Notas al pie: se usa para breaking changes, referencias a issues o revisiones.
Tipos más comunes
| Tipo | Propósito |
|---|---|
| fix | Corrige un error |
| feat | Añade una nueva funcionalidad |
| docs | Cambios solo en documentación |
| refactor | Mejora del código sin cambiar su comportamiento |
| build | Cambios en dependencias o configuración de compilación |
| chore | Tareas rutinarias sin impacto funcional |
Ejemplos prácticos
Nueva funcionalidad con ámbito:
feat(auth): agregar inicio de sesión con GoogleCorrección de error con detalles:
fix: corregir manejo de errores en peticiones asíncronas
Se agregó un identificador único para evitar condiciones de carrera.
Refs #133Conclusión
Adoptar Conventional Commits no es solo escribir commits más bonitos: es mejorar la comunicación, evitar errores y automatizar procesos clave del ciclo de desarrollo.
Al principio puede parecer una regla más, pero pronto notarás cómo tus commits se vuelven más expresivos y tu flujo de trabajo más ordenado.
La próxima vez que escribas un mensaje, piensa:
“¿Qué tipo de cambio estoy haciendo?”
Usa feat:, fix: o docs: y deja que tus commits hablen por ti.
