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

1. Emoji: El mensaje DEBE comenzar con el emoji correspondiente al tipo de cambio.
2. Idioma: Todo el contenido del commit (descripción y cuerpo) debe estar en ESPAÑOL.
3. Límite del Título: La primera línea (asunto) NO debe exceder los 50 caracteres (sin contar el emoji). Sé conciso.
4. 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.
5. 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:

1. Analiza los cambios: Revisa qué archivos se modificaron y qué tipo de cambio representan.
2. Selecciona el tipo: Elige el tipo de commit más apropiado de la tabla.
3. Define el alcance: Identifica el módulo o componente afectado (opcional pero recomendado).
4. Redacta el asunto: Máximo 50 caracteres, imperativo, en español.
5. Redacta el cuerpo: Explica qué, por qué y detalles técnicos. Es obligatorio.
6. 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.