Por Jose R. Zapata
Ultima actualización: 20/Feb/2026
El control de versiones es una práctica esencial en cualquier proyecto de software y ciencia de datos. Permite garantizar la trazabilidad y reproducibilidad del proyecto, registrando cada cambio realizado en el código, saber quién lo hizo y por qué, colaborar en equipo sin sobrescribir el trabajo de otros y revertir errores fácilmente. Herramientas como Git hacen posible trabajar en paralelo mediante ramas, mantener un historial completo y reproducible del proyecto, y gestionar releases de forma ordenada. Sin control de versiones, coordinar el trabajo en equipo (incluidos agentes de IA) se vuelve caótico y recuperarse de errores es costoso.
En la actualidad, el desarrollo de software se realiza cada vez más con la asistencia de agentes de programación con IA (Claude Code, GitHub Copilot Agent, Codex, Cursor, entre otros). Estos agentes analizan el historial de commits y el changelog para entender el contexto del proyecto: qué se cambió, por qué y cuál es el estado actual del desarrollo. Con esta información pueden generar Pull Requests precisos, sugerir cambios coherentes y mantener la documentación actualizada. Por eso, escribir commits claros con Conventional Commits y mantener un CHANGELOG.md bien estructurado no es solo una buena práctica de documentación, es darle a los agentes el contexto que necesitan para asistirte de forma efectiva.
Flujo de Trabajo para una Nueva Feature
El siguiente diagrama muestra el proceso recomendado para desarrollar una nueva funcionalidad, desde la creación de la rama hasta el Pull Request:
(feature/nombre-feature)"] --> B["Código asistido por agente de IA
(codigo, tests, docs, etc.)"] B --> BB["Hacer commit
(Conventional Commits)"] BB --> C{"¿Pre-commit
pasa?"} C -- Sí --> E{"¿Más codigo o
pruebas unitarias?"} C -- No --> D["Corregir errores
reportados"] D --> B E -- Sí --> B E -- No --> G["Actualizar
CHANGELOG.md"] G --> H["Crear
Pull Request"] H --> I["Contestar comentarios
o hacer cambios adicionales"] I --> J["Merge
Pull Request"] J --> K["Eliminar
branch"]
Contenido
Commits
Commits, buenas practicas y Conventional Commits
Changelog
Changelog y Semantic Versioning
Branching model y Gitflow
Branching model (Gitflow)
Pull Request
Que es un Pull request y recomendaciones
Repositorios (Mono y Multi)
Mono o Multi repositorios
Referencias
- Guía simple de git https://rogerdudler.github.io/git-guide/index.es.html
- Git for Data Scientists: Learn Git through Practical Examples https://codecut.ai/git-deep-dive-for-data-scientists/
- Flujo de trabajo de Gitflow https://www.atlassian.com/es/git/tutorials/comparing-workflows/gitflow-workflow
- Conventional Commits https://www.conventionalcommits.org
- https://jesusramirezguerrero.com/2016/07/29/10-consejos-clave-para-tus-pull-request/comment-page-1/