flujo de confirmación (commit flow)

¿Qué hace flujo de confirmación (commit flow)?

Usar cuando el usuario pida confirmar (commitar), preparar (staging) o preparar cambios para un commit.

Pasos

1. Ejecutar doc-gen — activar/ejecutar el skill gen-docs primero para actualizar la documentación según los cambios de código.
2. Revisar cambios actuales — ejecutar git status y git diff (o git diff --cached) para ver exactamente qué cambió.
3. Revisar código — leer los archivos modificados/agregados para entender qué es realmente necesario.
4. Preparar solo el código necesario — leer archivos directamente; agregar archivos que contengan cambios reales y necesarios. Para cualquier archivo que parezca no relacionado, temporal o poco claro, preguntar al usuario: "¿Debo preparar <archivo>? Contiene <resumen breve>" — no asumir.
5. Basar mensaje en el cambio de código — derivar el mensaje de commit del diff/contenido real (ej.: feat: add docs for skills a).
6. Confirmar con el usuario — mostrar el mensaje propuesto, el resultado de doc-gen y los archivos preparados; pedir aprobación (yes/approve) antes de confirmar.
7. Confirmar el código — ejecutar git commit con el mensaje aprobado, luego mostrar un breve resumen de lo que se confirmó.
8. Preguntar sobre subir (push) — preguntar al usuario si desea subir los cambios (git push).

Reglas

• Usar git, read_file, write_file y herramientas de archivo directamente dentro de este flujo — no pedir permiso para cada llamada de herramienta.
• Si no está seguro si un cambio es necesario, preguntar: "¿Debo preparar <archivo>? Contiene <resumen breve>"
• Ejecutar gen-docs antes de confirmar.
• Sugerir un mensaje de commit derivado del diff real (ejemplo de formato: feat: add docs for skills a).
• Confirmar con el usuario (yes/approve) antes de git commit y antes de git push; los demás pasos se ejecutan directamente.