Los revisores leen tu historia

Un pull request es una historia que cuentas sobre un cambio. Antes de abrirlo, dedica de cinco a diez minutos a limpiar la narrativa.

Paso 1: rebase sobre main

git fetch origin
git rebase origin/main

Paso 2: squashear commits WIP

git rebase -i origin/main

Paso 3: reescribir mensajes

Usa reword en el rebase interactivo para arreglar typos, expandir contexto y asegurar que cada commit explique por qué.

Paso 4: re-ejecutar tests y linters

npm test
npm run lint
npm run typecheck

Paso 5: auto-revisar el diff

git diff origin/main...HEAD
git log origin/main..HEAD --oneline

Paso 6: verificar secretos

git diff origin/main...HEAD | grep -iE 'password|secret|api[_-]?key|token'

Paso 7: verificar el build

Push a un PR borrador o ejecuta CI localmente si es posible.

Paso 8: escribir la descripción del PR

Incluye: qué cambia, por qué, cómo probaste, capturas si UI, y cualquier riesgo o seguimiento.

Paso 9: force-push con cuidado

git push --force-with-lease origin feature/login

Paso 10: mantén el PR pequeño

Si tu diff supera las 400 líneas o toca más de 10 archivos, considera dividirlo.