Contextor Revert

Revierte cambios de forma inteligente, entendiendo unidades lógicas de trabajo.

Argumento: $ARGUMENTS

Formatos válidos:

•track:{nombre} - Revierte todo un track
•fase:{número} - Revierte una fase del track activo
•tarea:{número} - Revierte una tarea específica
•Sin argumentos - Muestra opciones disponibles

Proceso

Sin Argumentos: Mostrar Opciones

Si no se proporcionan argumentos:

•Identifica el track activo
•Lista las opciones de reversión:

code

Opciones de reversión disponibles:

Track actual: {nombre}

Revertir track completo:
  /contextor-revert track:{nombre}

Revertir fase específica:
  /contextor-revert fase:1
  /contextor-revert fase:2

Revertir tarea específica:
  /contextor-revert tarea:1.1
  /contextor-revert tarea:2.3

Revertir Track Completo

Comando: track:{nombre}

•Confirmar acción - Pregunta al usuario si está seguro
•Identificar commits - Busca todos los commits con Track: {nombre}
•Listar cambios - Muestra qué se va a revertir
•
Ejecutar reversión:
- •git revert de cada commit en orden inverso
- •O crear un commit de reversión único
•Actualizar plan.md - Marca todas las tareas como pendientes [ ]
•Actualizar spec.md - Cambia estado a "Revertido"

Revertir Fase

Comando: fase:{número}

•Identificar track activo
•Confirmar acción
•Identificar commits de la fase - Busca commits con Fase: {número}
•Listar cambios
•Ejecutar reversión
•Actualizar plan.md - Marca tareas de la fase como pendientes

Revertir Tarea

Comando: tarea:{número}

•Identificar track activo
•Confirmar acción
•Identificar commit de la tarea - Busca commit con Tarea: {número}
•Mostrar cambios
•Ejecutar reversión
•Actualizar plan.md - Marca tarea como pendiente

Estrategias de Reversión

Opción 1: Git Revert (Preferida)

bash

git revert {commit-hash} --no-edit

•Mantiene historial
•Seguro para branches compartidos

Opción 2: Git Reset (Solo si el usuario lo pide)

bash

git reset --soft HEAD~{n}

•Elimina commits
•Solo para branches locales no compartidos

Manejo de Conflictos

Si hay conflictos durante la reversión:

•Notifica al usuario
•Muestra los archivos en conflicto
•
Opciones:
- •Resolver manualmente
- •Abortar reversión
- •Forzar reversión (perder cambios posteriores)

Ejemplo de Uso

code

Usuario: /contextor-revert tarea:2.1

Claude:
Revirtiendo tarea 2.1 del track "api-endpoints"

Tarea: Crear endpoint GET /users
Commit: abc123f "feat(api-endpoints): crear endpoint GET /users"
Archivos afectados:
  - src/routes/users.ts (modificado)
  - src/controllers/users.ts (creado)
  - tests/users.test.ts (creado)

¿Confirmar reversión? (sí/no)

[Después de confirmar]

✓ Reversión completada
✓ plan.md actualizado: tarea 2.1 marcada como pendiente
✓ Commit de reversión: def456g "revert: tarea 2.1 de api-endpoints"

Notas de Seguridad

•SIEMPRE pide confirmación antes de revertir
•NUNCA uses git reset --hard sin confirmación explícita
•Muestra exactamente qué se va a revertir antes de hacerlo
•Ofrece opción de backup antes de reversiones grandes
•Si hay trabajo no commiteado, advierte al usuario