Composer ejecuta el spec 01 en Cursor
Contenido del curso
Nicolás Alejandro Vargas Cárdenas
Kenneth Angulo L
ANDRES ALFONSO MIRA MEJIA
Daniel Alfredo García Serna
Kenneth Angulo L
¿Qué pasa si Next.js muestra un error?
No siempre significa que la instalación falló. Si ves la interfaz de error característica del framework, confirma que el servidor local está corriendo correctamente y respondiendo peticiones.<br><br>Este comportamiento es común cuando la ruta principal aún no tiene una página definida. El siguiente paso lógico es crear ese archivo inicial para renderizar tu UI.
✅
📚 CLASE: COMPOSER EJECUTA EL SPEC 01 EN CURSOR
━━━━━━━━━━━━━━━━━━
🎯 IDEA PRINCIPAL
🟡 Un spec no termina cuando la IA escribe código: termina cuando sus criterios de verificación están cumplidos.
🔵 Composer puede ejecutar comandos, instalar dependencias y levantar servicios, pero tú mantienes el control mediante aprobaciones.
━━━━━━━━━━━━━━━━━━
⚡ RESUMEN ULTRA RÁPIDO
🔵 Composer actúa como agente de programación capaz de ejecutar acciones sobre el proyecto.
🟢 Usa Run para autorizar un comando individual y Allow para permitir comandos similares durante la sesión.
🟡 La ejecución debe terminar con una validación objetiva del spec, no con la confianza en el agente.
🔵 En el ejemplo, Next.js corre en 3000 y Hono en 3001.
🟢 Un health endpoint permite comprobar rápidamente que la API realmente responde.
━━━━━━━━━━━━━━━━━━
🔑 LO IMPORTANTE
🔵 Spec = instrucciones + criterios verificables que definen cuándo una unidad de trabajo está terminada.
🟡 Composer no debería considerarse exitoso simplemente porque terminó su respuesta.
🟢 Comprueba cada criterio del spec y verifica directamente los servicios resultantes.
🔴 Un error visual de Next.js no necesariamente significa que el framework falló; puede faltar todavía una página.
🟡 En la práctica, pnpm install, TypeScript y los criterios definidos en el spec se utilizan como comprobaciones concretas.
🟣 Comparar el mismo spec con diferentes modelos permite evaluar resultados mediante evidencia, no por popularidad del modelo.
━━━━━━━━━━━━━━━━━━
🧩 MODELO MENTAL
🔵 Spec → Ejecutar → Aprobar → Verificar → Probar → Aceptar
🟡 La pregunta profesional cambia de “¿la IA terminó?” a “¿puedo demostrar que el resultado cumple?”
━━━━━━━━━━━━━━━━━━
🚀 ACCIONES PARA HOY
🟢 Elige un spec pequeño de tu proyecto y define primero sus criterios de aceptación.
🟢 Ejecuta el spec con tu agente y revisa cada solicitud de permisos antes de aprobarla.
🟢 Diferencia permisos puntuales de permisos recurrentes durante una sesión.
🟢 Comprueba manualmente los servicios levantados desde navegador o terminal.
🟢 Verifica endpoints críticos mediante un health check o prueba equivalente.
🟢 Si puedes, ejecuta el mismo spec con dos modelos y compara código, pruebas y cambios realizados.
━━━━━━━━━━━━━━━━━━
🟣 VENTAJA PROFESIONAL
🟣 Convierte los criterios del spec en una barrera de calidad: ningún cambio se considera terminado hasta cumplirlos.
🟣 No evalúes modelos solamente por el código generado; compara también pruebas, estructura, errores y capacidad de cumplir el spec.
🟣 Hack: incluye en cada spec una sección de verificación ejecutable para que el agente tenga un objetivo medible.
🟣 Este enfoque prepara el terreno para automatizar QA posteriormente con herramientas como MCP y Playwright dentro de Cursor.
━━━━━━━━━━━━━━━━━━
📝 CIERRE
🟡 El principiante acepta que la IA “terminó”; el profesional exige evidencia de que terminó correctamente.
🟢 Cuando uses agentes, piensa siempre: ejecutar es una etapa; verificar es lo que convierte el trabajo en resultado.
¿Cómo verifico mi frontend y mi API?
Revisa el panel de terminales integradas en tu editor. Generalmente, los proyectos full-stack levantan servicios independientes, asignando puertos distintos como el 3000 para la interfaz y el 3001 para el backend.<br><br>Abre tu navegador y visita esos puertos locales. Si ves la pantalla de bienvenida de tu framework o un JSON con estado ok, la configuración fue un éxito.
