Tu proyecto: un cerebro compartido con el agente

Acto de egreso de la Primera Promoción de Maestras-Maestros Normales - (M.A.B.H Escuela de la Barranca).jpg — Imagen libre de Wikimedia Commons (Public domain, autor: Unknown author Unknown author)

Llegó el momento de juntar todo el curso en un solo entregable: tu documento maestro. Es el texto que pegas al inicio de cada sesión con tu agente para que no vuelvas a explicar lo mismo veinte veces. Un buen documento maestro no es una carta a los Reyes Magos: es un contrato de trabajo que define el objetivo, el contexto, las reglas, el alcance y qué cuenta como bien hecho. Este proyecto es escritura y criterio, no código.

El criterio sigue siendo tuyo El documento maestro no le delega el pensamiento a la IA: lo externaliza para que tú y el agente vean el mismo proyecto. Si algo está ambiguo en el documento, estará ambiguo en el resultado.

Qué lleva un documento maestro

Objetivo: qué se construye, para quién y qué problema resuelve.
Contexto: negocio, usuario, tecnologías y convenciones del proyecto.
Restricciones: qué debe respetar y qué nunca debe tocar.
Alcance y fuera de alcance: qué entra en esta fase y qué no.
Criterio de calidad: cómo se ve el terminado y qué pruebas debe pasar.
Modo de trabajo: cómo pedirás los cambios y cómo revisarás.

Cada sección mata una suposición que la IA habría tenido que adivinar.
Sección	Pregunta que cierra	Mal ejemplo	Buen ejemplo
Objetivo	¿Qué y para quién?	Una app de ventas	Registrar ventas de una reparadora desde el celular
Restricciones	¿Qué no tocar?	Cuidado con el código	No cambiar el esquema de la base de datos sin avisar
Alcance	¿Hasta dónde?	Todo el sistema	Solo el alta de clientes en esta fase
Calidad	¿Cómo se ve listo?	Que esté bonito	Guardar, listar y validar campos vacíos, sin romper nada

Manos a la obra: escribe tu documento

Toma la app que has venido imaginando en el curso y redacta su documento maestro en las seis secciones. Sé específico: cada frase debe borrarle una decisión a la IA. Te dejo el espacio de trabajo.

Mi documento maestro (borrador)

Cómo pasar del documento a la primera orden

Abre tu sesión con el agente y compártele el documento maestro completo.
Convierte la sección de alcance en una sola tarea pequeña con su criterio.
Indica cómo quieres la respuesta: solo código, con explicación breve, mostrando qué tocó.
Aplica tu protocolo anti-rompimiento y actualiza el documento si cambió una decisión.

Uno de los párrafos de este documento maestro es demasiado vago para dirigir a un agente. Marca la línea del problema.

Objetivo: una app para que la recepcionista registre clientes y sus equipos en reparación.
El diseño debe ser moderno, atractivo y que le guste a todo el mundo.
Restricción: no agregar librerías nuevas ni tocar la pantalla de login.

Identifica la linea con error.

¿Cuál es la mejor señal de que tu documento maestro está listo para dirigir un proyecto?

Relee tu documento y subraya cada frase que un agente podría interpretar de dos maneras. Reescríbela para dejar una sola lectura posible.

Pista

Busca adjetivos (rápido, bonito, fácil) y alcances abiertos (todo, completo, varios): suelen ser ambigüedad.

Checklist del documento maestro

Se requiere 60% de aciertos para avanzar.

Fin del Curso 2 y de la ruta Nivel 1. Ya entiendes, describes y diriges. La ruta sigue en el Nivel 2 Construir con el curso Agentes de IA desde cero. Recuerda la filosofía: una empresa no paga por usar IA; paga porque le resuelvas un problema.