Deja que un agente lo configure

Puedes delegar la parte aburrida

Este repositorio se escribió para que un agente de código pueda leerlo. Incluye un archivo de mapa (llms.txt), un archivo de reglas (AGENTS.md), un manual paso a paso (docs/agent-setup.md) y un prompt listo para usar (prompts/agent-setup.md). En lugar de aprender cada comando de configuración, pegas un solo prompt y el agente sigue el manual en tu computadora.

Delegar la escritura no significa saltarse las comprobaciones. El agente trabaja dentro de tu copia del repositorio y debe informar lo que hizo con evidencia. Las secciones siguientes muestran cómo luce un buen informe, para que sigas controlando el resultado.

Un límite honesto: esta ruta automatizada configura la aplicación web y su backend — el servidor que maneja cuentas y datos. El prompt y el manual se entregan con el repositorio web y con el monorepo All Platforms. Las descargas solo de móvil o solo de escritorio incluyen en su lugar su propio llms.txt acotado y guías de configuración de plataforma.

• Configura la aplicación móvil en local
• Ejecuta la aplicación de escritorio

Lo que necesitas primero

Termina primero la guía de preparación: Node.js, Git y un editor instalados, la invitación de GitHub aceptada y la carpeta supastack descargada en tu computadora. El agente trabaja dentro de esa carpeta, así que todo lo de Antes de empezar sigue vigente.

También necesitas una herramienta que pueda actuar como agente de código — un editor con un agente de código de IA integrado (un IDE con IA), o un agente que se ejecuta en tu terminal (una CLI de agente). Vale cualquier herramienta actual con capacidad de agente; el prompt ya especifica lo que debe leer y ejecutar, así que no tienes que escribir las instrucciones tú mismo.

Por último, necesitas una de dos formas de ejecutar la aplicación: Node.js 22 o más reciente instalado en tu computadora — la ruta que preparó la guía de preparación — o una herramienta de contenedores como Docker o Podman, que ejecuta la aplicación dentro de contenedores y no necesita Node.js instalado. Eliges una dentro del prompt y el agente la sigue.

Copia el prompt, rellena dos espacios y pégalo

Abre prompts/agent-setup.md en el editor — está en la carpeta prompts, en el nivel superior de la carpeta supastack, junto a llms.txt. Selecciona todo su texto y cópialo.

Dos marcadores necesitan tu elección. Reemplaza <SETUP_PATH: docker | podman | host> por docker, podman o host — host ejecuta la aplicación directamente en tu computadora con el Node.js que instalaste; docker o podman la ejecutan dentro de contenedores. Reemplaza <DEPLOY_TARGET: coolify | vps-docker | local-only> por dónde debe quedar la aplicación — local-only la ejecuta en esta computadora y no despliega nada, que es la opción correcta para una primera mirada.

Pega el texto editado en el chat del agente y envíalo. La primera línea ya rellenada de abajo muestra las opciones docker más local-only; los pasos numerados bajo esa línea se quedan exactamente como los trae el archivo.

Stand up this supastack checkout end to end for **docker**
and deploy it to **local-only**.

Qué hace el agente con el prompt

El prompt dirige al agente hacia el manual y las reglas de seguridad, y luego le indica que los trabaje en orden y demuestre cada fase. En términos sencillos, el agente:

• Lee el mapa del repositorio (llms.txt), las reglas del proyecto (AGENTS.md) y las reglas de manejo de credenciales (docs/agent-security.md) antes de tocar nada.
• Crea los archivos de configuración .env con node scripts/setup-env.mjs. El asistente copia solo desde .env.example, así que el agente nunca inventa nombres de ajustes y conserva los secretos que ya tienes en lugar de sobrescribirlos.
• Inicia Postgres — la base de datos donde la aplicación guarda cuentas y registros — y la propia aplicación, como contenedores en la ruta docker o podman, o con comandos en tu computadora en la ruta host.
• Ejecuta las migraciones de base de datos — los comandos que crean las tablas de la aplicación — antes del primer inicio de sesión real, porque una cuenta creada antes de que existan las tablas es una cuenta rota.
• Verifica cada fase en un punto de control y termina con un informe que marca cada comprobación como PASS, FAIL, BLOCKED o NOT RUN, con la salida que lo respalda.

Qué revisar en el informe del agente

Un buen informe muestra evidencia, no afirmaciones. Busca la respuesta de salud real y la salida de comandos detrás de cada PASS — no una frase como «todo funciona».

El prompt indica al agente que se detenga e informe cuando el mismo paso falla dos veces — no que rodee el fallo — y que te pregunte antes de cualquier acción destructiva, como borrar una base de datos. Si tu agente sigue improvisando tras fallos repetidos, deténlo y lleva el primer error a la guía de solución de problemas.

Dos cosas no deben aparecer nunca: una función de seguridad desactivada para silenciar un error, y un valor secreto como una contraseña o clave impreso en el chat o en el informe. Si ves alguna de las dos, considera la ejecución como fallida.

Mantén separadas en tu mente la demostración y un inicio de sesión real. El flujo de referencia local de la demo /dashboard no necesita base de datos, así que puede pasar por sí solo; crear una cuenta en /auth solo funciona después de que se ejecuten las migraciones. «La demo funcionó» todavía no es «las cuentas funcionan».

Si prefieres hacerlo a mano

Cada paso anterior también existe como tutorial clic a clic. Ejecuta la guía web de cinco minutos para la primera demo y luego la configuración local web para el entorno local completo con una base de datos real.

Un agente sigue siendo útil después de la configuración aunque no hiciera la instalación — la guía de flujo de trabajo con agentes cubre tareas cotidianas como pantallas nuevas, rediseños y revisiones.