dataforge/agents_and_robots

Files

T

egutierrez 37882f1c24 docs: añadir stash al flujo de sincronización en git-push

Se añade git stash / git stash pop al paso de sincronización del comando git-push para proteger cambios locales antes de hacer pull --rebase. También se añade nota sobre el caso donde no hay cambios locales y se actualiza el checklist.

2026-03-06 22:17:48 +00:00

1.8 KiB

Raw Blame History

Command: git push

Usa este comando para cerrar una tarea completa con sincronización, commits por bloques de cambio y publicación al remoto.

Flujo obligatorio

Verificar rama y estado:

git branch --show-current
git status --short

Sincronizar antes de preparar commits (stash para proteger cambios locales):

git stash
git pull --rebase
git stash pop

Si git stash reporta "No local changes to save", continuar directo con git pull --rebase (sin stash pop).

Revisar cambios y separarlos por tema:

git diff --stat
git diff

Si hay cambios de distinta naturaleza, crear varios commits:

Commit 1: refactor/código
Commit 2: documentación
Commit 3: reglas/configuración

Comandos sugeridos:

git add <archivos_del_bloque_1>
git commit -m "<tipo>: <resumen breve>" -m "Descripción larga en español explicando qué cambia, por qué se hizo, impacto esperado y alcance del bloque."

git add <archivos_del_bloque_2>
git commit -m "<tipo>: <resumen breve>" -m "Descripción larga en español explicando qué cambia, por qué se hizo, impacto esperado y alcance del bloque."

Publicar commits:

git push

Convención de commits

feat: nueva funcionalidad
fix: corrección de error
refactor: cambio estructural sin cambio funcional
docs: documentación
chore: mantenimiento

Regla de mensajes

El título (-m corto) debe resumir el bloque.
El cuerpo (-m largo) debe estar en español y explicar:
- qué se cambió,
- por qué se cambió,
- qué impacto tiene,
- qué no se tocó.

Checklist rápido

git stash + git pull --rebase + git stash pop ejecutado sin conflictos.
Se separaron cambios distintos en commits diferentes.
Cada commit tiene descripción larga en español.
git push ejecutado correctamente.