Composer 2.5 ejecuta tu primer spec en Cursor

Cursor sumó a su ecosistema un modelo propio de inteligencia artificial para programar llamado Composer, y puedes usarlo directamente desde su editor de agentes para poner en marcha tu primer spec de proyecto. Si estás explorando cómo automatizar la instalación y configuración inicial de un stack con Next.js y Hono, esta es una ruta rápida para lograrlo sin salir del IDE.

¿Qué es Composer y cómo funciona dentro de Cursor?

Composer es el modelo de IA propio de Cursor, integrado a su agente para ejecutar tareas de programación reales sobre tu proyecto.

Cuando le pides al agente que ejecute comandos, no lo hace a ciegas. Te muestra un cuadro de diálogo con dos opciones: darle run al comando puntual o darle allow para otorgar permisos recurrentes durante la sesión [00:22]. Ese allow es útil cuando ya validaste que el comando es seguro y no quieres que te interrumpa cada vez que lo repite.

¿Qué hace Composer en Cursor? Es el modelo de IA nativo de Cursor que ejecuta comandos, instala dependencias y valida criterios de un spec directamente en tu entorno de desarrollo.

¿Cómo ejecutar el spec 01 con Composer paso a paso?

La idea de un spec es entregarle al agente una lista de criterios verificables y dejar que él se encargue del resto. En este caso, el flujo fue directo: escribir ejecuta los comandos, aprobar los permisos que el agente solicita y esperar.

El agente pidió permiso para revisar la versión del package manager instalado y luego procedió a instalar todas las dependencias del proyecto [01:05]. Al terminar, marcó el spec 01 como completado y devolvió el listado de criterios de verificación con su estado.

¿Qué criterios valida el spec 01?

Estos son los seis puntos que el agente confirmó al cerrar la ejecución:

• Instalación correcta con pnpm install.
• Criterio dos y tres pasando sus pruebas con estado ok.
• Criterios cinco y seis correspondientes a la configuración de TypeScript.
• Ejecución simultánea del frontend y del backend en puertos separados.

Todo pasó sin fricción, lo que significa que el agente no solo instaló, también verificó que cada pieza estuviera funcionando.

¿Cómo verificar que el frontend y la API estén corriendo?

En la parte inferior del editor aparece una nueva pestaña que indica dos terminales activas. Al abrirla, verás una corriendo en el puerto 3000 y otra en el puerto 3001 [01:38].

La terminal del puerto 3000 tiene levantado Next.js, es decir, tu frontend. La del puerto 3001 muy probablemente esté ejecutando Hono como motor de la API. Para confirmarlo, basta con abrir el navegador.

Al entrar a localhost:3000 aparece un error, pero es el error propio de Next.js indicando que no existe una página aún. Eso confirma que el framework arrancó bien y que las dependencias quedaron instaladas correctamente. En localhost:3001 hay un endpoint de health que responde con status ok, señal de que la API está viva [02:15].

¿Qué significa que el endpoint de health responda status ok? Es la confirmación de que tu API está corriendo y respondiendo peticiones. Es la prueba mínima de que el backend quedó operativo tras la instalación.

¿Por qué comparar Composer 2.5 con otros modelos?

Aquí viene lo interesante: no todos los modelos generan código con la misma calidad ni siguen los specs con la misma disciplina. Composer 2.5 es la apuesta de Cursor, pero conviene contrastarlo con otras opciones para entender fortalezas y limitaciones.

El reto es simple: ejecuta el mismo spec 01 con Composer 2.5 y luego con el modelo de tu preferencia (Claude, GPT, Gemini, el que uses habitualmente) y evalúa cuál genera mejor código, cuál respeta más los criterios de verificación y cuál pide menos intervenciones manuales.

¿Qué debes observar al comparar modelos?

Cuando corras el experimento, presta atención a estos elementos:

• Cantidad de permisos que solicita durante la ejecución.
• Precisión al marcar los criterios del spec como completados.
• Errores de configuración en Next.js, Hono o TypeScript.
• Tiempo total desde que envías la instrucción hasta que ambos servidores están corriendo.

Esa comparación te va a dar una lectura honesta de qué modelo se adapta mejor a tu flujo. ¿Ya probaste Composer con algún spec propio? Cuéntame en los comentarios cuál modelo te dio mejores resultados y por qué.