> ## 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 # Construye con un agente de código Entregue tareas a un agente de codificación: los archivos que lee, los skills incluidos y la revisión que le mantiene en control. ## Guía paso a paso para principiantes Requisitos previos: lea las dos guías para principiantes a continuación y termine la configuración local de Mobile. Un agente de codificación es una herramienta de IA —Cursor, Claude Code, Devin o un asistente similar— que lee su proyecto, edita archivos y ejecuta comandos. Todo lo de esta página se aplica a cualquiera que use. Términos rápidos: un prompt es el texto de instrucciones que pegas en el agente. Un diff es la lista de cambios de archivos que propone. La raíz del repositorio es la carpeta superior que contiene package.json — el agente siempre debe empezar ahí. 1. Abra `.agents/skills/` en la raíz del repositorio y copie el skill más cercano a su tarea: `add-a-mobile-screen` es un buen primer intento. 2. Péguelo en su agente y describa su cambio, luego agregue una línea: Lea `llms.txt`, luego `AGENTS.md`, luego `.ai/PROJECT_CONTEXT.md` antes de tocar el código. 3. Deja que el agente liste los archivos que cambiará y las comprobaciones que ejecutará antes de editar. Cuando termine, revisa el diff — estás aprobando cambios reales en tu producto. 4. La publicación, el envío a la tienda y las llamadas a proveedores de pago nunca forman parte de un prompt de tarea. Manténgalos como pasos separados que usted aprueba explícitamente. [Antes de comenzar](https://supastack.dev/es/docs/mobile/before-you-start.md) [Conceptos básicos de terminales](https://supastack.dev/es/docs/mobile/terminal-basics.md) [Configuración local móvil](https://supastack.dev/es/docs/mobile/ship-in-5-minutes.md) ## Los archivos que lee tu agente El repositorio incluye un pequeño conjunto de archivos escritos para agentes, no solo para personas. Nunca pegas este contexto a mano — apunta al agente a `llms.txt` y él lee el resto por sí solo. El orden de lectura importa: `llms.txt` es el mapa, `AGENTS.md` fija los límites y `.ai/PROJECT_CONTEXT.md` guarda lo que aprendieron las sesiones anteriores. Un agente que se salta los límites produce código que no puedes lanzar. | Archivo | Qué le da al agente | |---|---| | `llms.txt` | El mapa de entrada del repositorio, generado para listar solo lo que este checkout realmente incluye | | `AGENTS.md` | Los límites innegociables: solo trabajo local hasta que apruebes más, ámbito por workspaceId, secretos solo en el servidor | | `.ai/PROJECT_CONTEXT.md` | Memoria entre sesiones — qué cambió recientemente y por qué; se lee antes de modificar código | | documentos espejo `.ai/` | Una nota `.ai/.md` junto a los archivos importantes, que registra decisiones por archivo e hilos abiertos | | `.agents/skills/` | Runbooks de tareas escritos para agentes: los seis skills de Mobile enumerados a continuación | | `docs/agent-security.md` | La lista de verificación de aceptación: autenticación, verificaciones de workspace y permisos, registros redactados | | `docs/mobile-store-submission.md` | El runbook de lanzamiento en la tienda: cuentas, compilaciones, notas de revisión y orden de envío | | `.env.example` | El inventario completo del entorno — el agente nunca inventa un nombre de variable ausente de este archivo | ## Los skills incluidos Cada archivo bajo `.agents/skills/` es un briefing completo: péguelo o deje que el agente lo lea, y las reglas del kit viajan con él —datos con el servidor primero, sin secretos en el paquete, sin conexión solo como fallback de error de red. La biblioteca `prompts/` lista para pegar solo se incluye en el repositorio Web; este checkout incluye skills en su lugar. Para una configuración desatendida, use el prompt preparado en la guía de agent-setup. [Deje que el agente ejecute la configuración](https://supastack.dev/es/docs/mobile/agent-setup.md) - `add-a-mobile-screen`: agregar o cambiar una pantalla, su flujo de datos y su comportamiento sin conexión - `adding-a-dependency`: agregar, actualizar o mover una dependencia npm de forma segura - `reviewing-a-pr`: revisar un diff en busca de corrección, aislamiento de workspace y secretos - `upgrading-from-upstream`: traer una versión más reciente del kit a su aplicación - `verify-changes`: elegir y ejecutar las verificaciones correctas antes de la entrega - `writing-unit-tests`: cubrir lógica nueva con Vitest ## Cómo recuerda el agente entre sesiones Los agentes no tienen memoria entre sesiones: la carpeta `.ai/` es la memoria. `.ai/PROJECT_CONTEXT.md` registra lo que cambió recientemente y por qué. Junto a él, un documento espejo como `.ai/apps/mobile/src/ideas/index.md` explica las decisiones detrás de `apps/mobile/src/ideas/index.ts` que el código por sí solo no muestra. El contrato es simple: lee el espejo de un archivo antes de editarlo y actualiza el espejo cuando el cambio aterrice. Las entradas de «Open Threads» registran trabajo sin terminar para que la próxima sesión retome en lugar de empezar de cero. Un espejo desactualizado es peor que ninguno — cuando revises el diff del agente, comprueba que los espejos de los archivos cambiados se movieron con él. ## Revisa el trabajo del agente con honestidad Una tarea terminada es evidencia, no un resumen. Antes de quedarte con el trabajo del agente, compruébalo como `docs/agent-security.md` comprueba un despliegue: Cuando algo está mal, devuelve el diff — el agente corrige su propio trabajo más rápido cuando nombras la comprobación que falla. Para cualquier cosa que nunca debió intentar solo, dilo explícitamente una vez; el límite se mantiene el resto de la sesión. [Puertas de verificación y la suite de pruebas](https://supastack.dev/es/docs/mobile/testing.md) - Ejecutó las pruebas que afirma — pide el comando y su salida, no una conclusión. - Los secretos quedaron solo en el servidor — nada nuevo lleva el prefijo `NEXT_PUBLIC_` o `EXPO_PUBLIC_`, y ninguna clave se imprimió en un informe o commit. - Cada lectura y escritura de datos de usuarios quedó acotada por `workspaceId` — ninguna consulta confía en un id enviado por el navegador. - El espejo `.ai/` de cada archivo cambiado se movió junto con el código. - Publicar, desplegar y las llamadas a proveedores de pago siguieron siendo pasos separados que aprobaste — el agente nunca fusionó, empujó ni desplegó por su cuenta. - Si un paso falló dos veces, se detuvo e informó del comando fallido en lugar de improvisar para rodearlo. Si quieres continuar la configuración, lee [Autenticación nativa](https://supastack.dev/es/docs/mobile/authentication.md). ## Siguiente [Autenticación nativa](https://supastack.dev/es/docs/mobile/authentication.md)