Instrucciones para agentes
Lo que Fragua escribe en una app nueva para que cada corrida arranque orientada.
Cuando Fragua genera una app nueva (el camino greenfield), deja un pequeño archivo de instrucciones para agentes antes del primer commit. Está ahí para que cada corrida posterior —tuya o de un compañero— arranque conociendo lo básico de la app en lugar de redescubrirlo cada vez.
Qué se crea
Dos archivos, en el mismo commit. Uno es el documento real; el otro es un apuntador hacia él, para que cada agente encuentre las mismas instrucciones donde las espera.
.claude/CLAUDE.md
Las instrucciones en sí. Claude Code lee este archivo automáticamente al inicio de una corrida, sin que tengas que configurar nada.
AGENTS.md
Un symlink en la raíz del repo que apunta al archivo de arriba. Otros agentes buscan AGENTS.md ahí, así que leen las mismas instrucciones: una sola fuente, sin copia que mantener sincronizada.
Qué contiene
Un punto de partida a propósito corto: el nombre de la app, cómo correrla y espacio para que lo amplíes. Nada que tengas que mantener desde el primer día.
bin/dev
Levanta el servidor de desarrollo en el puerto asignado a la app.
bin/rails server
Levanta el servidor sin el gestor de procesos.
bin/rails test
Corre la batería de pruebas.
bin/setup
Instala dependencias, prepara la base de datos y deja un checkout fresco listo para correr.
-
El puerto de desarrollo de la app está fijo, así que nunca choca con otra app que corras al mismo tiempo.
-
Se deja una sección Gotchas vacía para que la llenes: el lugar para anotar las sorpresas conforme aparezcan. La siguiente guía cubre qué vale la pena agregar.
Por qué dos archivos
Claude Code carga el archivo .claude/CLAUDE.md por su cuenta, así que las instrucciones llegan al agente sin configuración. Otras herramientas —como Codex o Cursor— buscan un AGENTS.md en la raíz del repositorio. El symlink une a ambos: leen exactamente el mismo contenido y tú solo editas un archivo.
Unas cuantas líneas de contexto del proyecto mejoran cada corrida de forma medible.