Generador de Commits

Cuando se te pida realizar un commit o generar un mensaje de commit, DEBES seguir estrictamente este formato.

Estándar: Conventional Commits con Emojis

Utilizamos Conventional Commits enriquecidos con Gitmoji como base. Todo el contenido debe estar en ESPAÑOL.

Formato

<emoji> <tipo>(<alcance>): <descripción corta>

<cuerpo detallado y extenso>

<footer>

Reglas Obligatorias

• Emoji: El mensaje DEBE comenzar con el emoji correspondiente al tipo de cambio.

• Idioma: Todo el contenido del commit (descripción y cuerpo) debe estar en ESPAÑOL.

• Límite del Título: La primera línea (asunto) NO debe exceder los 50 caracteres (sin contar el emoji). Sé conciso.

• Descripción Extensa: El cuerpo del mensaje es OBLIGATORIO. Debes explicar detalladamente:

• Qué se ha cambiado.

• Por qué se ha hecho el cambio.

• Detalles técnicos relevantes de la implementación.

• Tiempos Verbales: Usa el modo imperativo en el asunto (ej: "agrega", "corrige", "cambia"), no en pasado.

Tipos Permitidos y Emojis

Emoji Tipo Descripción

✨ feat

Nueva característica (correlaciona con MINOR en SemVer).

🐛 fix

Corrección de un bug (correlaciona con PATCH en SemVer).

📚 docs

Cambios en la documentación.

💄 style

Cambios que no afectan el significado del código (espacios, formato, etc).

♻️ refactor

Cambio de código que no corrige bugs ni añade funcionalidades.

⚡ perf

Cambio de código que mejora el rendimiento.

✅ test

Añadir tests faltantes o corregir existentes.

📦 build

Cambios que afectan el sistema de construcción o dependencias externas.

👷 ci

Cambios en archivos de configuración y scripts de CI.

🔧 chore

Otros cambios que no modifican src o test files (ej. config de herramientas).

⏪ revert

Reversión de un commit anterior.

Procedimiento

Cuando el usuario pida hacer commit:

• Analiza los cambios: Revisa qué archivos se modificaron y qué tipo de cambio representan.

• Selecciona el tipo: Elige el tipo de commit más apropiado de la tabla.

• Define el alcance: Identifica el módulo o componente afectado (opcional pero recomendado).

• Redacta el asunto: Máximo 50 caracteres, imperativo, en español.

• Redacta el cuerpo: Explica qué, por qué y detalles técnicos. Es obligatorio.

• Ejecuta el commit: Usa git commit -m con el formato completo.

Ejemplo Correcto

✨ feat(auth): integra login social con Google

Se ha implementado la autenticación mediante OAuth2 con Google para facilitar el acceso a nuevos usuarios.

Cambios principales:

• Agrega configuración de estrategia de Passport.js para Google.
• Crea nuevas rutas de callback en el controlador de autenticación.
• Actualiza el modelo de Usuario para almacenar el providerId.
• Ajusta la interfaz de login para incluir el botón de "Entrar con Google".

Motivación: Reducir la fricción en el registro de usuarios y aumentar la conversión.

Errores Comunes a Evitar

• fix: error login → Falta emoji, título vago, sin cuerpo.

• 🐛 Fix: arregla login → Tipo en mayúscula, lo correcto es minúscula fix .

• ✨ feat(user): Update user logic → En inglés, debe ser en español.

• Título que excede 50 caracteres → Acorta y mueve el detalle al cuerpo.

Integración con el Workflow

Después de ejecutar un commit exitoso, el router debe activar la skill changelog-updater para registrar el cambio automáticamente en CHANGELOG.md .