Agentes: empieza aquí

Dónde empieza un agente de IA en este repositorio: los documentos que son dueños de las reglas, en orden de lectura, los sitios en producción y el flujo por el que pasa cada tarea.

Para agentes de IA (Claude Code, Codex, cualquier otro) que trabajan en este repositorio, y para las personas que los dirigen. Las reglas viven en estos documentos para desarrolladores, cada una en el documento que es su dueño; esta página es el orden de lectura. El AGENTS.md y el CLAUDE.md de la raíz solo apuntan aquí (dónde viven las reglas). Lee los documentos de abajo antes de cambiar nada, y síguelos por encima de tus propios valores predeterminados.

Cuando dos páginas no coinciden, gana la tabla del flujo, y la página que no coincide es un error: corrígelo en la página en la que estás (si ves algo, corrígelo). Una contradicción entre páginas nunca es motivo para detenerse, ni para preguntarle al dueño cuál es correcta.

En producción: la app https://remy-auth.gedw99.workers.dev (staging, con el inicio de sesión automático: https://remy-auth-staging.gedw99.workers.dev); los docs para desarrolladores https://remy-auth-docs.gedw99.workers.dev/dev (la guía de producto /docs, la referencia de API /reference; servidores MCP /api/mcp/dev, /api/mcp/reference, /api/mcp/docs; todo para herramientas de IA en /llms.txt). El origen de estas páginas es docs/content/dev/*.md: lee eso, no las traducciones que están al lado (*.es.md).

Principios de desarrollo: propiedad, única fuente de verdad, puertas de pruebas, código generado, decisiones del dueño.
Herramientas para desarrolladores: los scripts y comandos, herramientas fijadas y habilidades de agente. Ejecuta los comandos del proyecto con npm run <script>.
Flujo de trabajo en tiempo de ejecución de la GUI: un solo Worker, objetivos de prueba locales y remotos.
Cómo trabajamos: primero las herramientas del proyecto, encuestas antes de elegir herramientas, shadcn y TanStack de principio a fin para la UI, el flujo y quién ejecuta cada paso, trabajo multiagente. Registra ahí las reglas de trabajo, no en la memoria del agente.
Inicio de sesión y permisos: el guard, el motor de relaciones, <Allowed>, entornos y correo: lo que recibe toda app de Remy, y dónde remy-auth usa cada uno de ellos.
El plan en .plans/ que cubre tu tarea, y sus roles de Executor/Reviewer.

Empieza con npm run dev:status (qué está pasando) y las herramientas propias del proyecto, y termina siguiendo el flujo: npm run dev:change después de cada cambio, npm run dev:land -- "<qué cambió>" cuando el trabajo está terminado y la comprobación está en verde.