Tu primer prompt de arquitectura profesional
Pasa de entender el vibe coding pro a aplicarlo en tu contexto real en una sola ejecución
Llegaste al momento en que el conocimiento de este curso se convierte en acción concreta. No en un ejercicio teórico: en una instrucción real que vas a ejecutar con un agente de IA para obtener un resultado tangible. Esta unidad no explica más conceptos — te prepara para ejecutar con precisión profesional lo que aprendiste. La calidad de lo que construyas en el laboratorio depende directamente de la calidad del prompt que diseñes aquí.
El prompt que separa al vibe coder aficionado del ingeniero que orquesta
Un prompt débil produce código que funciona en el demo y colapsa en producción. Un prompt profesional produce código que un equipo puede mantener, auditar y escalar. La diferencia no está en la longitud del prompt: está en los elementos estructurales que incluye. El spec-driven development que vimos en la Unidad 1 no es una metodología abstracta — es exactamente la estructura de un buen prompt de arquitectura.
Caso de Ejemplo
"Contraste: prompt débil vs prompt profesional Prompt débil: 'Crea una aplicación de gestión de tareas con React y una base de datos.' Problemas: sin stack específico, sin restricciones de seguridad, sin modelo de datos, sin casos extremos, sin criterios de éxito. El agente tomará decisiones arbitrarias en cada punto de ambigüedad. Prompt profesional: 'Construye una aplicación de gestión de tareas con Next.js 14 (App Router), TypeScript estricto y Supabase como backend. Requisitos de datos: tabla tasks con campos id, title, description, status (enum: pending/in_progress/done), user_id, created_at. Seguridad: habilita RLS en Supabase asegurando que cada usuario solo acceda a sus propias tareas. UI: componentes funcionales con Tailwind CSS, formulario de creación con validación en cliente y servidor. No uses server actions para operaciones que modifican datos de otros usuarios. Muéstrame la estructura de archivos propuesta antes de generar cualquier código.'"
Los cinco elementos de un prompt de arquitectura profesional
Checklist de verificación antes de ejecutar tu prompt en el laboratorio:
- Stack tecnológico con versiones exactas: no 'React', sino 'Next.js 14 con App Router y TypeScript estricto'. Sin esto el agente elige por ti.
- Modelo de datos concreto: tablas, campos con tipos, relaciones y restricciones. Una tabla sin tipos de campo produce migraciones que deberás reescribir.
- Restricciones de seguridad explícitas: qué usuario puede leer qué datos, qué operaciones requieren autenticación, dónde aplica RLS. Si no lo dices, el agente no lo asume.
- Criterios de construcción modular: pide que el agente proponga la estructura de archivos antes de generar código, y que construya componente por componente, no el sistema completo de una vez.
- Restricciones de comportamiento del agente: qué no debe hacer sin tu aprobación, qué convenciones de código seguir, qué herramientas o patrones están prohibidos en tu contexto.
El prompt de arquitectura profesional es la forma operativa del spec-driven development: transforma las especificaciones del proyecto en instrucciones deterministas que el agente puede ejecutar con coherencia y predictibilidad. Es el artefacto que separa el vibe coding exploratorio del desarrollo de software profesional asistido por IA.
Consejo FLOW: antes de escribir el prompt en el laboratorio, léelo en voz alta como si se lo explicaras a un desarrollador senior que no conoce tu proyecto. Si en algún punto de la lectura sientes que falta contexto para tomar una decisión de implementación, eso es exactamente lo que debes agregar al prompt.
En esta unidad hay una práctica interactiva: el PromptLab. Tendrás una sola ejecución para enviar tu prompt al agente y recibir una respuesta real. No hay reintentos: diseña tu prompt con la estructura del checklist anterior antes de ejecutarlo. La microactividad de abajo es tu espacio para escribir el borrador y revisarlo con calma antes de la ejecución.
Resumen de la unidad
- Un prompt de arquitectura profesional incluye stack con versiones exactas, modelo de datos concreto, restricciones de seguridad explícitas, criterios de construcción modular y restricciones de comportamiento del agente.
- La diferencia entre un prompt débil y uno profesional no es la longitud: es la presencia de especificaciones deterministas que eliminan las decisiones arbitrarias del agente.
- Pedir al agente que proponga la estructura de archivos antes de generar código es una práctica crítica que previene el desvío arquitectónico desde la primera línea.
- El PromptLab de esta unidad es una ejecución real: la calidad del prompt que diseñes determina directamente la calidad del resultado que obtendrás.
Laboratorio FLOW
Prueba tu primer prompt profesional
Tienes una sola ejecución en esta práctica. Escribe un prompt real para tu contexto y observa cómo responde Flow Copilot.
Consejo: mientras más claro sea tu contexto, más valiosa será la respuesta.
Haz la práctica con Flow Copilot una sola vez para desbloquear el cierre del módulo y pasar al examen.