> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Deja que un agente lo configure Pega un prompt ya preparado en un agente de código, deja que ejecute la configuración web en tu computadora y revisa el informe que escribe sobre cada paso. ## 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](https://supastack.dev/es/docs/mobile/local-setup.md) [Ejecuta la aplicación de escritorio](https://supastack.dev/es/docs/desktop/run.md) ## 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](https://supastack.dev/es/docs/web/before-you-start.md) 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 `` 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 `` 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](https://supastack.dev/es/docs/web/troubleshooting.md). 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](https://supastack.dev/es/docs/web/ship-in-5-minutes.md) para la primera demo y luego la [configuración local web](https://supastack.dev/es/docs/web/local-setup.md) 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](https://supastack.dev/es/docs/web/agents.md) cubre tareas cotidianas como pantallas nuevas, rediseños y revisiones. ## Siguiente [Lanza en 5 minutos](https://supastack.dev/es/docs/web/ship-in-5-minutes.md)