aitormf/agent-skills

Aplicar una revisión

Ayuda a la persona a decidir sobre cada hallazgo y aplicar solo lo que apruebe.

Regla fundamental: nunca asumas, infieras o apliques un cambio sin una decisión explícita. Si un hallazgo es ambiguo, pide aclaración antes de ofrecer opciones. Cada hallazgo se decide por separado; nunca los agrupes.

Artefactos y estado

• Cada ítem de trabajo reside en docs/specs/<YYYYMMDD>-<type>-<name>/.
• spec.md y plan.md llevan status: draft | approved | obsolete en su frontmatter. Solo una persona establece approved.
• Si cambias un artefacto que estaba approved, reviértelo a draft e indícalo.

Paso 1: presentar los hallazgos

1. Identifica el ítem de trabajo y la revisión (review-spec.md o review-plan.md). Pregunta si no está claro.
2. Enumera todos los hallazgos, numerados, primero los bloqueantes. Para cada uno muestra:
   • Hallazgo [N]: lo que señala la revisión.
   • Solución sugerida, si la hay.
   • Opciones:
     • A) Aplicar la solución tal cual.
     • B) Aplicar una solución modificada (la persona la describe).
     • C) Descartar, con el motivo.
     • D) Diferir.

Espera a que la persona responda todos antes de continuar.

Paso 2: confirmar

Resumen de decisiones
────────────────
[N] <título> → aplicar / modificado / descartado / diferido

Pregunta: "¿Confirmas estas decisiones antes de que las aplique?" No continúes sin confirmación.

Paso 3: aplicar

1. Aplica solo los cambios confirmados (A y B), y solo a los artefactos revisados. No toques nada más.
2. En el archivo de revisión, debajo de cada hallazgo, anota la decisión tomada:
   • para los descartados, el motivo;
   • para los diferidos, qué queda pendiente.
3. Indica a la persona dónde se encuentra:
   • Si no quedan hallazgos bloqueantes abiertos, el artefacto está listo para que ella lo marque como approved, o para otra pasada de review-spec.
   • Si quedan hallazgos bloqueantes diferidos, o descartados que conlleven riesgo, señálalo.

Paso 4: otras especificaciones afectadas

Verifica si alguna decisión del paso 2 afecta a otras especificaciones en curso:

1. Busca en docs/specs/*/spec.md aquellas con status: draft.
2. Para cada una, evalúa si alguna decisión introduce un conflicto, cambia una dependencia o invalida una suposición.
3. Para cada especificación que podría verse afectada:
   • muestra qué especificación, qué sección y qué necesitaría cambiar;
   • pregunta: "¿Esta decisión la afecta? ¿Propongo un cambio?". Espera un sí o un no.
4. Si la respuesta es sí, redacta solo el cambio mínimo (la sección y líneas exactas), muestra el diff y aplícalo solo tras la aprobación.

No mejores, extiendas ni reformatees nada más en esas especificaciones. Si en algún punto no está claro qué hacer, detente y pregunta.