Flujo de trabajo
- Inspecciona el estado del repositorio:
git status --short, git diff --cached y git diff. También revisa git log --oneline -10 para mantener el estilo existente.
- Si no hay nada preparado (staged), prepara los cambios relevantes por ruta explícita (evita
git add -A si hay archivos no relacionados o sensibles). Nunca prepares .env, secretos o .venv.
- Si los cambios contienen preocupaciones claramente no relacionadas, divídelos en commits separados.
- Escribe el mensaje siguiendo el formato a continuación, luego haz el commit con
git commit.
- Ejecuta
git status para verificar que el commit se realizó correctamente.
- Solo sube (push) si el usuario pasó
--push: ejecuta git push (usa git push -u origin <rama> si no hay upstream configurado). Nunca hagas force-push.
Formato del mensaje
<tipo>(<ámbito opcional>): <descripción>
<cuerpo opcional>
<pie opcional>
- Tipos:
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
- Descripción: modo imperativo, minúscula, sin punto final, máximo ~72 caracteres.
- Ámbito: sustantivo corto para el área afectada (ej.
cli, servidor, traducir); omítelo si no está claro.
- Cuerpo: explica el porqué, con saltos de línea cada ~72 caracteres; omítelo para cambios triviales.
- Cambios rupturistas: añade
! después del tipo/ámbito y un pie BREAKING CHANGE:.
Reglas
- No modifiques (amend), rebases ni reescribas el historial a menos que se te pida.
- No omitas hooks (
--no-verify).
- Si un hook falla, corrige el problema y crea un nuevo commit.
- No hagas commit cuando no haya cambios; en su lugar, indícalo.