Git Flow para equipos con Claude Code

Estrategia de branches

main ────────────────────────────────────────────
       \              /          \              /
        dev1/feature ┘            dev2/fix    ┘

main: Rama protegida. Todo se mergea aqui.
Feature branches: nombre-dev/<descripcion-corta>. Maximo 1-2 dias.
Push directo a main: Aceptable si los devs trabajan en modulos distintos.

Regla de oro: rebase antes de push

git pull --rebase origin main   # SIEMPRE antes de git push

Esto es obligatorio y automatico — el hook SessionStart lo ejecuta al iniciar sesion. El agente debe hacerlo antes de cada push sin preguntar.

Flujo de trabajo

Crear branch: git checkout -b dev1/nombre-corto
Trabajar, commitear normalmente
Antes de mergear: git pull --rebase origin main
Mergear: git checkout main && git merge dev1/nombre-corto
Push: git push origin main
Limpiar: git branch -d dev1/nombre-corto

Conflictos en documentacion

Si CLAUDE.md, TASK.md o CHANGELOG.md conflictan: el ultimo en push resuelve (estos archivos cambian constantemente y la resolucion es trivial).

Operaciones prohibidas

Operacion	Por que
`git push --force` a main	Destruye historia de otros devs
`git reset --hard`	Pierde trabajo local
`--no-verify`	Salta el harness sin justificacion
`git rebase -i` en main	Reescribe historia compartida

Véase también

[[ia-tech—metodo—commit-rules]]
[[ia-tech—metodo—multi-dev]]
[[ia-tech—metodo—claude-method-guide]]
[[crearack-tech—guides—agent-rules]]