Make Commits

Genera commits semánticos analizando cambios archivo por archivo. Flujo iterativo con confirmación manual.

Flujo de trabajo

1. Obtener cambios

git status --porcelain

Identifica archivos modificados (M) y sin seguimiento (??) .

2. Agrupar archivos relacionados

Agrupar juntos si:

Mismo módulo/directorio (models.py + schemas.py + resources.py)
Cambio lógico cohesivo:
- (Python) auth.py + auth_decorators.py
- (PHP) Controller + views + routes
- (Nuxt) components + store + server
Misma funcionalidad o corrección de error

NO agrupar si:

Dominios diferentes
Un archivo es refactor, otro es nueva funcionalidad
Los cambios son independientes

3. Analizar cambios por grupo

Para cada grupo de archivos:

git diff <file>

Lee el diff completo. Identifica:

Motivación: ¿Qué problema resuelve?
Implementación: ¿Qué cambió técnicamente?
Impacto: ¿Cómo afecta la app/usuarios?

4. Generar mensaje semántico

Estructura:

<type>: <asunto conciso>

[Why]: <motivación en 1 oración>

[What]: <implementación en 1 oración>

[Impact]: <impacto en 1 oración>

Tipos: feat, fix, docs, style, refactor, perf, test, chore

Ver references/commit-conventions.md para guía detallada.

5. Confirmar con el usuario

Usa AskUserQuestion:

Pregunta: "¿Qué hacer con este commit?"

Opciones:

Confirmar y ejecutar
Editar mensaje
Omitir por ahora

6. Ejecutar commit confirmado

git add <file1> <file2> ...
git commit -m "<message>"

7. Continuar con el siguiente grupo

Repite pasos 3-6 para cada grupo.

Al final: resumen de commits realizados y grupos omitidos.

Ejemplo

Entrada: El usuario invoca /make-commits

Paso 1: Ejecutar git status

M  src/modules/diagram/models.py
M  src/modules/diagram/schemas.py
M  src/modules/diagram/resources.py

Paso 2: Agrupar (mismo módulo)

Grupo 1: [models.py, schemas.py, resources.py]

Paso 3: Leer diffs de los 3 archivos

Paso 4: Generar mensaje

feat: Agregar validación de diagramas con esquemas centralizados

[Why]: Los diagramas necesitaban validación consistente para
prevenir datos inválidos en la base de datos.

[What]: Se implementaron esquemas Marshmallow para validar
campos requeridos/opcionales y lógica centralizada en
DiagramStore.

[Impact]: Todas las operaciones de diagrama validan datos;
los errores retornan 400 con mensajes claros en lugar de crashes.

Paso 5: Preguntar al usuario

¿Qué hacer con este commit?
1. Confirmar y ejecutar
2. Editar mensaje
3. Omitir por ahora

Paso 6: Si se confirma, ejecutar

git add src/modules/diagram/models.py \
        src/modules/diagram/schemas.py \
        src/modules/diagram/resources.py
git commit -m "feat: Agregar validación de diagramas..."

Notas Importantes

Solo commits (el usuario hace push manualmente)
Usa herramientas nativas: Bash, Read, AskUserQuestion
Enfoque en análisis inteligente, no orquestación
Respeta archivos ya ignorados por .gitignore

IMPORTANTE - Commits profesionales:

NO añadas "Co-Authored-By: Claude" o menciones Anthropic
NO menciones IA/asistente en ningún lugar del commit
Los commits deben ser 100% profesionales sin referencias a herramientas
El mensaje debe reflejar solo el cambio técnico real

IMPORTANTE - Idioma:

Los mensajes de commit se generan en español
Los tags [Why], [What], [Impact] permanecen en inglés
Los tipos de commit (feat, fix, docs, etc.) permanecen en inglés
El contenido descriptivo está completamente en español