El encargo define el trabajo

147. Identidad de la lección

Módulo

1.ai-partner — Dirección del colaborador de IA

Lección

El brief define el trabajo

Tipo académico

Flujo de trabajo

Tipo de lección

Mixta

Orden

1

Tiempo estimado

25–35 minutos, incluida la práctica

Esta lección establece un acuerdo de trabajo con un colaborador de IA: la tarea queda definida por sus límites, no por la seguridad o el entusiasmo con que esté redactada la petición.

148. Objetivo de aprendizaje

Al terminar esta lección, podrás redactar un brief de tarea que indique un objetivo concreto, aporte el contexto imprescindible, delimite el alcance permitido y nombre las partes del proyecto que la IA no debe tocar.

149. Por qué importa

Una petición vaga deja muchas decisiones sin resolver. En un proyecto de juego, una indicación como «haz que esto se sienta mejor» podría interpretarse como permiso para modificar comportamientos, tiempos, elementos visuales, interfaz, estructura del nivel o archivos no relacionados.

Un brief acotado reduce esas interpretaciones. Le asigna a la IA una tarea definida y te proporciona una referencia estable para aclararla antes de iniciar cualquier implementación.

150. Conocimientos previos

Debes haber completado 1.checkpoints L2 — Checkpoint, cambio y restauración. Esa lección mostró la importancia de contar con un punto de retorno conocido cuando se va a modificar un proyecto. Aquí no es necesario modificarlo: esta lección se concentra en el brief.

No necesitas conocimientos de un lenguaje de programación ni de un motor específico.

151. Concepto central

Un brief de tarea define un encargo acotado. Responde cuatro preguntas:

1. Objetivo: ¿Qué resultado concreto se busca?
2. Contexto: ¿Qué hechos son imprescindibles para interpretar ese resultado?
3. Alcance permitido: ¿Qué se puede revisar, comentar o cambiar dentro de esta tarea?
4. No tocar: ¿Qué debe quedar fuera de la tarea?

Un brief no es un deseo expresado como si fuera un mensaje de chat:

Haz que el juego se sienta mejor.

Es un encargo delimitado:

Haz más clara la pausa antes de que un enemigo cambie de dirección. Considera únicamente el tiempo de esa pausa. No cambies la ruta, la velocidad de movimiento, la detección, el daño, las animaciones, la interfaz ni el diseño del nivel.

Un buen brief es lo bastante pequeño como para poder reformularlo sin añadir suposiciones. Si contiene objetivos que no dependen entre sí, divídelos en briefs separados.

152. Modelo mental: la caja de límites

Imagina el brief como una caja con cuatro lados:

Si falta uno de los lados, queda espacio para hacer suposiciones. Por ejemplo, «mejora la patrulla» nombra un tema, pero no un resultado único. «Cambia la pausa» tampoco aclara qué comportamientos relacionados deben permanecer fuera del encargo.

153. Ciclo de redacción

Utiliza este ciclo específico para la lección:

REDACTAR → REFORMULAR → COMPARAR → REVISAR

1. Redactar: Escribe las cuatro partes del brief.
2. Reformular: Pide a la IA que reproduzca esas cuatro partes sin proponer una implementación.
3. Comparar: Comprueba si la reformulación añade un objetivo, supone un permiso, omite una restricción o revela una expresión ambigua.
4. Revisar: Corrige la redacción del brief y repite el ciclo si es necesario.

La revisión del brief es el ajuste que se realiza en esta lección. El proyecto no cambia. Los flujos de trabajo posteriores podrán usar un ciclo de dirección más amplio cuando exista una posible decisión de implementación.

154. Ejemplo concreto

155. Deseo expresado como chat

Haz que el comportamiento del guardia sea menos aburrido y mejora el nivel.

Esta petición mezcla varios resultados posibles y no establece límites. Podría referirse a las rutas de patrulla, la distancia de detección, la velocidad de movimiento, el daño, el tiempo de las animaciones, la geometría del nivel o la información de la interfaz.

156. Brief de tarea acotado

Objetivo: Hacer más perceptible la pausa del guardia antes de que cambie de dirección.
Contexto: El guardia ya sigue una ruta establecida. La tarea se refiere a la claridad de la pausa actual, no a crear un sistema de comportamiento nuevo.
Alcance permitido: Revisar la descripción de la pausa de patrulla y el valor temporal asociado con ella. Describir un posible ajuste de ese tiempo, sin implementarlo.
No tocar: No modificar ni rediseñar la ruta, la distancia de detección, la velocidad de movimiento, el daño, las animaciones, la interfaz, la geometría del nivel ni archivos no relacionados.

157. Trazabilidad del alcance

En esta lección, la IA debe reformular las cuatro partes e identificar cualquier expresión que admita más de una interpretación razonable. Esa reformulación aporta trazabilidad del alcance: muestra cómo interpretó la IA el encargo.

Una explicación que afirme que los demás comportamientos se conservarán no demuestra que se hayan conservado. Esa conservación solo puede evaluarse cuando exista una implementación y se compruebe mediante inspección, juego o reglas pertinentes. Ese trabajo corresponde a una lección posterior.

158. Flujo de trabajo con IA

Utiliza la IA para aclarar el encargo, no como editora automática.

1. Toma primero la decisión sobre la tarea: elige un único resultado.
2. Redacta el objetivo, el contexto imprescindible, el alcance permitido y la lista de elementos que no se deben tocar.
3. Pide a la IA únicamente una reformulación estructurada y una comprobación de ambigüedades.
4. Compara la reformulación con el brief original.
5. Revisa las expresiones que hayan permitido una interpretación no deseada.
6. Repite el proceso hasta que la reformulación refleje fielmente las cuatro partes.

Puedes usar esta petición:

Reformula esta tarea bajo cuatro encabezados: objetivo, contexto, alcance permitido y no tocar. No propongas código, ediciones, archivos ni pasos de implementación. Después, señala cualquier expresión que admita más de una interpretación razonable.

La IA puede detectar una ambigüedad, pero no debe decidir por su cuenta cómo resolverla. Tú sigues siendo responsable de elegir y redactar los límites previstos.

159. Errores frecuentes

160. Nombrar un tema en lugar de un resultado

«Trabaja en la respuesta del checkpoint» señala un área, pero no un resultado observable. Un resultado sería «haz que la activación del checkpoint resulte más fácil de percibir».

161. Incluir todo el sistema en el alcance permitido

«Mejora el sistema de checkpoints» permite modificar la activación, la progresión, las recompensas, la reaparición, la interfaz y otros comportamientos relacionados. Limita el alcance a la parte necesaria para cumplir el único objetivo.

162. Suponer que todo lo demás queda obviamente prohibido

«Mejora el salto» podría interpretarse como cambiar la altura, la gravedad, la aceleración, la animación, la cámara, las colisiones o el diseño del nivel. Indica cuáles de esas superficies quedan fuera de la tarea.

163. Pedir a la IA que complete decisiones pendientes

Si el brief no especifica si la señal deseada debe ser visual, sonora o ambas, la IA puede señalar la ambigüedad. No debe elegir la dirección de diseño en tu lugar, salvo que esa elección forme parte explícita del encargo.

164. Afirmar que un comportamiento se ha conservado antes de implementar

Una reformulación puede mostrar que se ha entendido una restricción. No puede demostrar que el comportamiento del proyecto se haya conservado, porque esta lección no modifica el proyecto.

165. Práctica guiada

Utiliza esta situación:

El jugador puede llegar a un checkpoint y activarlo, pero cuesta percibir la activación.

Tu tarea consiste en redactar un brief para una sola señal de activación más clara. No pidas código, ediciones de archivos, implementación ni un rediseño propuesto.

166. Paso 1: Redacta el brief

Escribe cuatro secciones identificadas:

• Objetivo: Nombra un único resultado observable relacionado con la señal de activación.
• Contexto: Incluye solo los hechos necesarios para comprender ese resultado.
• Alcance permitido: Limita el encargo a un canal de información o a un elemento de respuesta claramente definido.
• No tocar: Protege la posibilidad de llegar al checkpoint, las condiciones de activación, el significado de la progresión, las recompensas, la reaparición, el diseño del nivel y los elementos de interfaz no relacionados.

Si todavía no has decidido qué canal queda dentro del alcance, toma esa decisión antes de enviar el brief. No uses «respuesta visual y sonora» cuando el ejercicio exige un solo canal.

167. Paso 2: Solicita una reformulación

Envía el brief junto con la petición proporcionada. La respuesta debe contener únicamente:

• el objetivo indicado;
• el contexto imprescindible;
• el alcance permitido;
• los límites de lo que no se debe tocar;
• cualquier expresión ambigua que haya detectado.

168. Paso 3: Compara

Coloca el brief original y la reformulación uno junto al otro. Responde estas preguntas:

• ¿La reformulación conserva el único objetivo?
• ¿Añade contexto que no estaba en el brief?
• ¿Amplía el alcance permitido?
• ¿Omite algún límite de la sección «No tocar»?
• ¿Señala alguna expresión que realmente admita varias interpretaciones?

Esta es una comparación de claridad, no una decisión sobre un cambio propuesto para el proyecto.

169. Paso 4: Revisa

Reescribe cualquier expresión ambigua o demasiado amplia. Por ejemplo:

• Sustituye «mejora la respuesta del checkpoint» por «haz más perceptible la señal visual de activación existente».
• Sustituye «revisa el sistema de checkpoints» por «considera únicamente el elemento visual que aparece al activarse».
• Sustituye «no cambies la jugabilidad» por una lista concreta de comportamientos protegidos.

Solicita una reformulación final después de revisar el brief.

170. Evaluación de la capacidad

Entrega:

1. la primera versión del brief;
2. la primera reformulación de la IA;
3. una lista breve de los problemas de redacción encontrados al comparar;
4. el brief revisado;
5. la reformulación final de las cuatro partes.

El brief entregado, y no el cuestionario, constituye la evaluación de la capacidad.

Utiliza esta rúbrica:

Si falta algún criterio, revisa el brief. El ejercicio termina cuando el brief revisado y la reformulación final cumplen los seis criterios.

171. Puntos clave

• Un brief acotado define un objetivo, el contexto imprescindible, el alcance permitido y límites explícitos sobre lo que no se debe tocar.
• Una reformulación revela cómo se ha interpretado el encargo; no demuestra que se haya conservado el comportamiento del proyecto.
• En esta lección, el ciclo de trabajo es REDACTAR → REFORMULAR → COMPARAR → REVISAR.
• El ajuste consiste en revisar el brief. No se necesita implementar nada en el proyecto.
• El resultado final es un brief acotado acompañado de una reformulación fiel de sus cuatro partes.

172. Siguiente lección

Continúa con 1.ai-partner L2 — Inspecciona y decide, donde se introducirá la inspección de un cambio realmente propuesto y la decisión del aprendiz sobre si ese cambio respeta el brief.

173. Comprobación