Descomponer un cambio en pasadas supervisadas

2040. Identidad de la lección

Módulo

5.3 — Orquestación de IA

Lección

Descomponer un cambio en pasadas supervisadas

Tipo académico

Sistemas

Tipo de esquema

texto

Orden

1

Tiempo estimado

35–45 minutos, incluida la práctica

Esta lección establece un patrón repetible de orquestación para un cambio acotado que afecta varios archivos: planificarlo, crear un punto de recuperación, implementarlo, validarlo y revisar el resultado sin permitir que una pasada tome silenciosamente las decisiones de la siguiente.

2041. Objetivo de aprendizaje

Al finalizar esta lección, podrás producir un plan de orquestación para un cambio acotado de varios archivos que defina los límites de cada tarea, los resultados de cada pasada, un punto de recuperación, una asociación del cambio, los criterios de aceptación y los artefactos de traspaso.

2042. Por qué importa

Un pedido que parece pequeño puede atravesar varios archivos, sistemas y supuestos. Si un agente de IA planifica, edita, prueba y aprueba el mismo cambio en una sola ejecución continua, los errores se vuelven difíciles de localizar y fáciles de justificar. Las pasadas explícitas conservan el control humano sobre el alcance y generan evidencia para cada decisión. Un punto de recuperación reduce el costo de una implementación incorrecta, mientras que la asociación del cambio permite rastrear la solicitud desde el plan aprobado hasta sus archivos y evidencias de validación.

2043. Conocimientos previos

Debes poder diagnosticar la ambigüedad y los supuestos inseguros de un prompt de IA, como se practicó en 5.2 L2 — Diagnosticar un prompt que invita a código inseguro. En inglés, la dependencia es 5.2 L2 — Diagnose a prompt that invites unsafe code. También debes conocer los criterios de aceptación, las solicitudes restringidas y la forma de pedirle a una IA que exponga sus supuestos antes de proponer una implementación.

2044. Concepto central

El concepto central es establecer límites de tarea con traspasos recuperables y trazables.

Un plan de orquestación supervisado no trata “haz el cambio” como una sola tarea. Divide el trabajo en pasadas, y cada pasada tiene una responsabilidad concreta, una entrada explícita, un artefacto de salida definido, una condición de detención, un punto de revisión humana, un punto de recuperación previo a la edición y una asociación que vincula la solicitud, el punto de recuperación, los archivos modificados y la evidencia.

Las cuatro pasadas son:

• Planificación: delimitar el cambio, sus dependencias, riesgos y criterios de aceptación sin editar archivos.
• Implementación: aplicar únicamente el cambio aprobado dentro del límite establecido.
• Validación: reunir evidencia de que el comportamiento esperado funciona y de que no se introdujeron regresiones relevantes.
• Revisión: comparar el resultado con el plan, inspeccionar el alcance y decidir si se acepta, se corrige o se detiene.

Antes de implementar, crea un punto de recuperación identificable y restaurable. No equivale a una aprobación: es un límite de recuperación, no un juicio de calidad. Planificar no es una implementación más débil y validar tampoco equivale a revisar; cada pasada responde una pregunta distinta.

2045. Modelo mental

Usa la cadena de traspaso de cuatro pasadas con punto de recuperación y asociación del cambio:

La asociación del cambio sigue esta cadena:

Solicitud de cambio → plan aprobado → punto de recuperación → archivos modificados → evidencia de validación → decisión de revisión

Cada etapa debe referirse al mismo identificador. Si un archivo, resultado o decisión no puede asociarse con el cambio previsto, detente y resuelve la asociación antes de continuar.

La regla de traspaso es sencilla: una pasada puede consumir el artefacto anterior, pero no puede reemplazar silenciosamente la decisión anterior. Si aparece una dependencia nueva, vuelve a planificación o registra una decisión explícita sobre el alcance.

Una frase de control útil es:

“Haz solamente esta pasada. No ejecutes la siguiente. Detente cuando el artefacto de traspaso esté completo.”

2046. Ejemplo concreto

Supón que el cambio acotado es: añadir un indicador de enfriamiento a una habilidad existente sin modificar sus reglas de tiempo.

Una solicitud débil sería: “Añade una interfaz de enfriamiento y asegúrate de que funcione”. Esa instrucción deja en manos de la IA la elección de los archivos, la posibilidad de reescribir la lógica temporal y la definición de qué significa que el cambio funciona.

Un plan supervisado separa esas decisiones:

Pasada de planificación

• Asignar un identificador, por ejemplo, ability-cooldown-indicator.
• Identificar el estado existente de la habilidad que proporciona la información de enfriamiento.
• Identificar el componente de interfaz que muestra el estado de la habilidad.
• Confirmar que las reglas de tiempo deben permanecer intactas.
• Definir criterios observables: mostrar el estado no disponible durante el enfriamiento, actualizarlo cuando la habilidad vuelva a estar disponible y no alterar el momento de activación.
• Registrar las dependencias inciertas en vez de adivinarlas.

Artefacto de traspaso: mapa de archivos y dependencias, supuestos, criterios de aceptación, archivos propuestos e identificador del cambio.

Control del punto de recuperación

• Crear un punto de recuperación con nombre inmediatamente antes de implementar.
• Registrar su identificador junto a ability-cooldown-indicator.
• Confirmar que puede inspeccionarse o restaurarse antes de autorizar cualquier edición.

Artefacto de traspaso: registro del punto de recuperación asociado con el plan aprobado.

Pasada de implementación

• Leer el plan aprobado y el registro del punto de recuperación.
• Modificar únicamente los puntos de presentación e integración autorizados.
• No reescribir el temporizador, añadir limpieza ajena al cambio ni modificar el comportamiento de entrada.
• Informar todos los archivos modificados y cualquier desviación del plan.
• Rechazar la edición y detenerse si hace falta un archivo no aprobado, si el cambio alteraría las reglas de tiempo, si no puede asociarse con el identificador o si el punto de recuperación deja de ser utilizable.

Artefacto de traspaso: resumen del diff, lista de archivos modificados, notas de implementación, desviaciones y asociación entre el identificador, el punto de recuperación y los archivos.

Pasada de validación

• Probar la habilidad antes, durante y después del enfriamiento.
• Comprobar los criterios de aceptación uno por uno.
• Verificar que el momento de activación no haya cambiado.
• Registrar los fallos observados sin corregirlos durante esta pasada.
• Detenerse sin editar si los archivos probados no coinciden con la implementación asociada, falta el punto de recuperación o el identificador, o la evidencia no puede atribuirse a este cambio.

Artefacto de traspaso: tabla de resultados criterio por criterio, con instrucciones para reproducir los fallos y referencias al cambio asociado.

Pasada de revisión

• Comparar los archivos modificados con el límite aprobado.
• Confirmar la asociación entre el cambio, el punto de recuperación y la evidencia de validación.
• Contrastar la evidencia con cada criterio de aceptación.
• Decidir si se acepta el cambio, se devuelve para una corrección concreta o se detiene porque el alcance o la trazabilidad dejaron de estar acotados.

Artefacto de traspaso: registro de la decisión, su justificación, el resumen de asociaciones y las acciones siguientes.

La implementación produce un cambio, pero no declara que sea correcto. La validación produce evidencia, pero no corrige silenciosamente el código. La revisión toma la decisión de aceptación. El punto de recuperación permite volver al estado anterior y la asociación del cambio conserva la trazabilidad.

2047. Flujo de trabajo nativo de IA

Usa la IA como participante de cada pasada, no como responsable de todo el cambio.

1. En planificación, proporciona la solicitud, el contexto disponible, las restricciones y la prohibición de editar. Pide mapa de archivos, supuestos, riesgos, criterios, preguntas abiertas e identificador del cambio.
2. En el punto de control humano, rechaza suposiciones no justificadas y acota el límite antes de autorizar la implementación.
3. Crea y registra un punto de recuperación restaurable; verifica tú mismo que puede usarse.
4. En implementación, proporciona solo el plan aprobado y la asociación con el punto de recuperación. Exige la lista de archivos modificados y las desviaciones.
5. Indica a la IA que rechace la edición y se detenga si descubre una dependencia no aprobada, necesita salir del límite, no puede conservar el comportamiento especificado o no puede asociar la edición con el cambio.
6. Inspecciona el diff o los cambios del proyecto y decide qué hacer con cualquier desviación.
7. En validación, proporciona criterios, archivos, asociación e identificador. Pide comprobaciones sin modificar la implementación y exige resultados observados.
8. En revisión, compara plan, punto de recuperación, diff, asociación, evidencia y decisión final. La decisión de aceptación sigue siendo humana.

No combines todo en una sola instrucción como “planifica, implementa, prueba y revisa esta funcionalidad”. Eso elimina los puntos de traspaso que hacen supervisable el proceso.

2048. Error común

El error común es tratar un prompt más largo como si fuera un flujo de trabajo descompuesto. Añadir “ten cuidado”, “prueba todo” o “no rompas nada” no crea límites de tarea. Una sola ejecución puede elegir su alcance, cambiar el plan durante la implementación y declarar validada su propia salida.

También es un error crear un punto de recuperación sin asociarlo con el cambio o registrar la asociación después, basándose en la memoria. La asociación debe establecerse antes de implementar y actualizarse con los archivos realmente modificados.

La validación tampoco debe reparar fallos. Registra el fallo, vuelve a la pasada correspondiente y genera nueva evidencia después de la corrección. Si no puede identificarse el cambio o su punto de recuperación, detén la validación e informa el fallo de trazabilidad.

2049. Práctica guiada

Crea un plan para este cambio:

Añadir un estado visible de “interactuando” a un prompt de interacción existente. La regla de interacción y la asignación de entrada deben permanecer sin cambios. El cambio puede requerir más de un archivo, pero no debe introducir un sistema nuevo de interacción.

Incluye:

1. Un identificador, un límite de comportamiento y una exclusión de alcance.
2. Archivos o límites de sistema, supuestos, tres criterios de aceptación, dos riesgos y preguntas abiertas.
3. Un punto de recuperación con nombre y la evidencia que confirmaría que puede restaurarse o inspeccionarse.
4. Un registro que vincule solicitud, plan, punto de recuperación, archivos propuestos y reales, evidencia y decisión.
5. Una instrucción de implementación con límite aprobado y lista de archivos requerida.
6. Esta condición: “Si necesitas un archivo no aprobado, descubres un sistema nuevo de interacción, no puedes conservar la regla existente o la asignación de entrada, o no puedes asociar la edición con el punto de recuperación y el identificador del cambio registrados, rechaza editar y detente. Informa la condición que bloquea el trabajo.”
7. Una instrucción de validación que prohíba cambiar código, exija evidencia criterio por criterio y detenga el proceso si la implementación, el punto de recuperación o la evidencia no pueden asociarse con el mismo identificador del cambio.
8. Una regla de revisión con tres resultados: aceptar, devolver para una corrección específica o detener y volver a planificar.
9. Una condición que obligaría a volver a planificación.

La decisión importante es la elección del límite: decide qué puede inspeccionar la IA, qué puede editar, qué debe asociarse con el punto de recuperación y qué requiere autorización antes de la siguiente pasada.

2050. Rúbrica de la entrega práctica

Puntúa el plan de orquestación con siete criterios. Asigna 2 puntos si el control es específico y aplicable, 1 punto si aparece pero resulta impreciso o incompleto y 0 puntos si falta o no funciona.

1. Calidad del límite: especifica el comportamiento autorizado, los archivos o sistemas permitidos y las exclusiones.
2. Artefactos de cada pasada: cada pasada produce un artefacto que la siguiente puede utilizar de forma efectiva.
3. Recuperabilidad: el punto de recuperación tiene nombre, está asociado con el cambio y cuenta con evidencia de que puede inspeccionarse o restaurarse.
4. Trazabilidad: el identificador conecta la solicitud, el plan aprobado, el punto de recuperación, los archivos reales, la evidencia y la decisión de revisión.
5. Condiciones de detención: cada pasada indica cuándo debe detenerse en lugar de ampliar el alcance o reparar resultados sin autorización.
6. Puntos de decisión humana: la autorización entre pasadas y la aceptación final tienen responsables humanos explícitos.
7. Gestión del nuevo alcance: una dependencia imprevista provoca rechazo, escalamiento o regreso a planificación.

El plan es suficiente con 11 de 14 puntos o más, siempre que no obtenga cero en calidad del límite, recuperabilidad o trazabilidad. Revisa cualquier traspaso que nombre un artefacto pero no aporte la información necesaria para que la siguiente pasada avance de forma segura.

2051. Validación / evidencia

2052. Puntos clave

• Un cambio de varios archivos debe dividirse por responsabilidad, no solo describirse con más palabras.
• Planificación, implementación, validación y revisión responden preguntas diferentes.
• Un punto de recuperación ofrece un estado anterior conocido; no sustituye la revisión.
• Las asociaciones conectan solicitud, plan, punto de recuperación, archivos, evidencia y decisión.
• Las condiciones de rechazo y detención impiden ampliar el alcance en silencio.
• La validación debe observar y registrar, no reparar silenciosamente.

2053. Próxima lección

Continúa con 5.3 L2 — Construye una secuencia de cambios con intervención humana. Usarás el plan de orquestación creado aquí para señalar quién decide, dónde debe detenerse cada pasada para inspección, cómo escalar un bloqueo y qué autorización permite iniciar la pasada siguiente.

2054. Comprobación