Git como disciplina: commits atómicos, ramas cortas y una historia que se puede leer

Cómo usar git para que la historia del proyecto sirva de verdad: commits pequeños y descriptivos, ramas de corta duración, conflictos resueltos con calma, versiones etiquetadas, trabajo en paralelo.

Metodologíametodologiagitversionamentoingegneria del software19 de noviembre de 2026 · 3 min de lectura

Una historia de commits hecha de «fix», «wip» y «cambios varios» no sirve a nadie: no permite entender por qué cambió un comportamiento, no deja deshacer un solo cambio y convierte la revisión en un esfuerzo. Git es la misma herramienta en ambos casos: cambia la disciplina con que se usa.

Commits atómicos

Un commit contiene un cambio con una sola intención, y se sostiene solo: el proyecto compila y las pruebas pasan antes y después. Si para describir el commit hace falta la palabra «y», son dos commits. La ventaja es práctica: se puede deshacer un cambio sin arrastrar otros, y quien busca el origen de un defecto encuentra un cambio legible.

Mensajes que explican el porqué

La línea de apertura dice qué cambia, de forma breve y específica. El cuerpo, cuando hace falta, explica por qué: el problema que se resuelve, la elección hecha, la alternativa descartada. El «qué» ya lo muestra la diferencia; el «porqué» no lo muestra nadie.

Ramas de corta duración

Una rama vive días, no semanas. Cuanto más vive, más se aleja de la rama principal y más cuesta reunirla. Para trabajos largos se cortan cambios pequeños que entran cada día, ocultando lo incompleto tras un interruptor de configuración. El nombre de la rama dice la intención (por ejemplo, corrección o funcionalidad, más un breve asunto).

Antes de guardar, mirar

Antes de cada commit se relee la diferencia: ¿hay líneas de depuración, archivos que no vienen al caso, secretos? Lo que entra en la historia se queda. Los archivos generados, las dependencias descargadas y los secretos no van en el repositorio.

Conflictos

Se resuelven con calma, entendiendo las dos intenciones, no eligiendo una u otra al azar. Tras la resolución se vuelven a ejecutar las pruebas. Se realinea la propia rama a menudo, para que los conflictos sigan siendo pequeños.

Versiones

Las versiones publicadas se etiquetan con números que dicen algo sobre la compatibilidad (mayor para los cambios incompatibles, menor para las adiciones, parche para las correcciones). La etiqueta se aplica después de que el lanzamiento haya ido bien, no antes.

Trabajo en paralelo

Cuando varias personas o agentes trabajan en el mismo proyecto, cada uno tiene su propia rama (o su propia copia de trabajo), con tareas que no tocan los mismos archivos. El trabajo en paralelo funciona si los límites están claros; si dos actividades tocan los mismos archivos, se hacen una después de la otra.

Señales de alarma

  • Commits con mensajes como «fix» o «wip».
  • Commits gigantes que mezclan varias intenciones.
  • Ramas de semanas de antigüedad.
  • Secretos o archivos generados en el repositorio.
  • Conflictos resueltos sin volver a probar.
  • Reescrituras de historia ya compartida.
  • Grandes cambios sin guardar que se acumulan.

Un ejemplo

Una corrección toca tres cosas: el cálculo de un total, el nombre de una variable y una prueba. En tres commits: «Corrige el redondeo del total del pedido (dos puntos de redondeo)», «Renombra tot a total_pedido», «Añade prueba para pedidos con dos descuentos». Si la corrección causa un problema, se deshace el primero sin perder los demás.

Cuándo usarlo

Cada vez que se cambia el código; al guardar, crear una rama, resolver un conflicto u organizar el trabajo en varios flujos paralelos.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

git-workflow-and-versioningMétodo para usar git de modo que la historia sirva: commits atómicos con mensajes que explican el porqué, ramas de corta duración, revisión del diff antes de guardar, conflictos resueltos con pruebas, versiones etiquetadas, trabajo en paralelo. Úsese cada vez que se guarda un cambio o se organiza el trabajo en ramas.