EN
Best Practices 2026

Tipos de Commit

Conventional Commits
featNUEVA FUNCIÓN

Añade una nueva característica al producto.

feat(api): add user oauth login

fixCORRECCIÓN

Resuelve un error o comportamiento inesperado.

fix(ui): resolve button jump on hover

refactorESTRUCTURA

Mejora el código sin alterar su lógica externa.

refactor: extract validation logic

choreMANTENIMIENTO

Actualización de dependencias o tareas rutinarias.

chore(deps): update react to v19

perfRENDIMIENTO

Mejoras de código que optimizan la velocidad o el uso de recursos.

perf(db): optimize query indexing

docsDOCUMENTACIÓN

Cambios exclusivos en archivos de documentación (README, manuales).

docs: update api endpoint reference

!
BREAKING CHANGE
Cambios Incompatibles

Usa un ! después del tipo o añade el footer BREAKING CHANGE: para notificar cambios de versión mayor.

feat(auth)!: drop support for legacy api
logoxeland314
Commits claros • Equipos felices.
#git #productivity #standards

¿Qué son los tipos de commit?

El tipo de commit es la primera palabra del mensaje y dice, de un vistazo, qué clase de cambio contiene. Es la base de Conventional Commits: tipo(ámbito): descripción. Con ese formato el historial se lee solo, se pueden generar changelogs automáticos y las herramientas deciden la siguiente versión según SemVer.

Los tipos más usados

  • feat: una funcionalidad nueva para el usuario. Sube la versión minor.
  • fix: corrige un error. Sube la versión patch.
  • docs: cambios solo en documentación.
  • style: formato, espacios o punto y coma; no cambia el comportamiento.
  • refactor: reorganiza el código sin añadir funciones ni corregir errores.
  • perf: mejora el rendimiento.
  • test: añade o corrige pruebas.
  • build y ci: cambios en el sistema de compilación, dependencias o en la integración continua.
  • chore: tareas de mantenimiento que no tocan el código de producción.
  • revert: deshace un commit anterior.

Cambios que rompen compatibilidad

Añade ! después del tipo (feat!: elimina la API v1) o un pie BREAKING CHANGE: en el cuerpo. Eso indica una versión major.

Un buen mensaje

Usa el imperativo y minúsculas (fix(ui): evita el salto del botón), mantén la primera línea en unos 72 caracteres y explica el porqué en el cuerpo. Para ver cada parte de un mensaje, revisa la anatomía de un commit.