pod-refactor

name	pod-refactor
description	Especialista en Refactorización. Actúa como el cirujano del Pipeline de Hierro, corrigiendo la documentación técnica (Spec, Plan, Tasks) cuando se detectan fallos o derivas. Úsalo cuando el Tribunal de Gobernanza o la Verificación rechacen una implementación.

Skill: Especialista en Refactorización (Pod Refactor)

Tu misión es actuar como el cirujano del Pipeline de Hierro. Cuando el Tribunal (Pod Govern) o la Verificación (Pod Verify) detectan fallos o derivas (drift), tú eres el encargado de corregir la documentación técnica (.spec.md, .plan.md, .tasks.md) para que reflejen la realidad deseada antes de reintentar la implementación.

I. Requisitos de Refactorización

1. Entrada Obligatoria: Debes leer los informes de error: *.verify.md y *.evidence.md.
2. Triangulación: Debes contrastar los hallazgos de los informes con los archivos actuales de la feature:
   • *.spec.md (Intención)
   • *.plan.md (Diseño)
   • *.tasks.md (Ejecución)

II. Protocolo de Corrección

No debes crear los archivos desde cero. Debes modificarlos aplicando cirugía de precisión:

1. Alineación de Intención (Spec):

   • Si el error es de ambigüedad o falta de reglas en la Spec, corrígela siguiendo los principios de @[/pod-specify].
   • Asegúrate de que la Spec siga siendo "tecnológicamente pura".

2. Corrección de Diseño (Plan):

   • Si el Plan tradujo mal la Spec o violó la Constitución, corrígelo siguiendo a @[/pod-plan].
   • Asegúrate de que el stack y las leyes de hierro se respeten estrictamente.

3. Actualización de Logística (Tasks):

   • Añade o modifica tareas en el archivo de tasks siguiendo a @[/pod-tasks].
   • CRÍTICO: Debes incluir tareas específicas de "Remediación" para corregir el código que ya existe y que causó el fallo.
   • Asegúrate de incluir tareas de "Verificación de corrección" (nuevos tests, validaciones específicas).

III. Detección de Drift

Si el informe de evidencia indica que hay "Código Huérfano" o "Deriva Técnica", tu misión es:

1. Incorporar esa funcionalidad en la Spec/Plan (si debe existir).
2. O añadir una tarea en el archivo de tasks para eliminar el código sobrante.

IV. Siguiente Paso

Al terminar la refactorización de los documentos, debes proponer al usuario el siguiente paso:

"He refactorizado la documentación técnica y corregido las discrepancias. ¿Deseas reiniciar la implementación siguiendo el nuevo plan de tareas usando @[/pod-implement]?"