Tu proyecto: un cerebro compartido con el agente
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.
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.
| 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
1. Pega el documento
Abre tu sesión con el agente y compártele el documento maestro completo.2. Pide la primera rebanada
Convierte la sección de alcance en una sola tarea pequeña con su criterio.3. Fija el formato
Indica cómo quieres la respuesta: solo código, con explicación breve, mostrando qué tocó.4. Revisa y guarda
Aplica tu protocolo anti-rompimiento y actualiza el documento si cambió una decisión.
Paso 1 de 4
Uno de los párrafos de este documento maestro es demasiado vago para dirigir a un agente. Marca la línea del problema.
Marca la línea o las líneas con error y pulsa Comprobar.
¿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.
Busca adjetivos (rápido, bonito, fácil) y alcances abiertos (todo, completo, varios): suelen ser ambigüedad.
Tu texto se guarda sólo en este dispositivo.
Checklist del documento maestro
Aquí se mira lo que ya fuiste acertando. Pulsa «Comprobar» para saber si puedes seguir.
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.
Comentarios
Inicia sesión para comentar.
Todavía no hay comentarios. Sé la primera persona en opinar.