Respuestas
¿Cómo mantener sincronizados CLAUDE.md, AGENTS.md y GEMINI.md?
No copiando. Las copias se desalinean la primera vez que una regla cambia en un archivo y en los otros no, y la herramienta que lee el desactualizado sigue la regla muerta sin ningún error. Dentro de un repositorio, los archivos pueden convertirse en uno: CLAUDE.md puede importar AGENTS.md, y la opción context.fileName de Gemini CLI puede apuntarlo a AGENTS.md. Eso pone a los agentes de código sobre un solo texto, y sigue siendo un archivo: no dice quién decidió una línea, cuándo deja de ser cierta ni si un asistente la añadió en una sesión, y no llega a la herramienta que no lee el repositorio. Una regla se mantiene sincronizada cuando vive una sola vez, fuera de todo archivo, donde alguien la ve y la aprueba, y toda herramienta la lee de ahí. Arroway es ese lugar: cada regla con quién la aprobó y cuándo termina, leída por todo asistente conectado antes de actuar. El primer paso es la página de instalación.
Última actualización 6 de octubre de 2026
Por qué tres archivos se desalinean
Cada herramienta lee su archivo: CLAUDE.md para Claude Code, GEMINI.md para Gemini CLI, AGENTS.md para los agentes que siguen esa convención. Un equipo con tres herramientas termina con tres archivos que empiezan siendo el mismo texto. El primer cambio entra en el archivo de quien lo hizo. Desde ahí un asistente sigue la regla nueva, otro sigue la vieja y un tercero nunca supo de ella. Nada falla. El desacuerdo aparece semanas después, como dos asistentes dándole al equipo dos respuestas a la misma pregunta.
Lo que de verdad se sostiene
Dentro de un repositorio, los archivos pueden convertirse en uno: CLAUDE.md puede importar AGENTS.md, y la opción context.fileName de Gemini CLI puede apuntarlo a AGENTS.md. Eso cambia cuántos archivos hay, no lo que son: texto que cada sesión carga, en el que un asistente puede escribir, sin una línea que diga quién lo aprobó ni cuándo termina. Y no llega a una regla sobre el negocio —un precio, una restricción de un cliente, una política—, porque el asistente de chat, el agente de otro repositorio y el colega sin Git no leen ninguno de los archivos. Lo que se sostiene es que la regla viva una sola vez, donde el equipo la ve, la aprueba y la retira, y que toda herramienta la lea de ahí.
Cuándo usar Arroway
Usa Arroway cuando la misma regla tiene que llegar a varias herramientas, cambiar en un solo lugar y seguir a la vista del equipo que la sigue. La regla se registra una vez, con quién la aprobó y la condición que la termina; un reemplazo nombra la regla que retira; toda herramienta conectada lee la versión vigente al comienzo de la sesión. Lo que vale va ahí, sobre el código o sobre el negocio, y no a un archivo de instrucciones donde un asistente puede cambiarlo sin que nadie lo vea. No arregla archivos que ya difieren: te da el lugar donde la regla debió vivir. El primer paso es la página de instalación.
Cómo se ve en la práctica
Un equipo de producto de tres personas usa Claude Code, Gemini CLI y Cursor. En septiembre escribieron las mismas diez reglas en CLAUDE.md, GEMINI.md y un archivo de reglas de Cursor. En octubre deciden que todo cambio de base de datos necesita un segundo revisor. Maya añade la línea a CLAUDE.md ese mismo día. GEMINI.md queda como estaba; la regla de Cursor nunca recibe la línea. Dos semanas después una migración pasa con un solo revisor, y nadie sabe decir qué asistente dijo que estaba bien. Llevan la regla a Arroway, con el nombre de Maya, en lugar de la regla anterior de un revisor. Las tres herramientas leen la misma regla vigente al comienzo de cada sesión, y el historial muestra cuándo cambió y quién la cambió. Nada de lo que el equipo necesita queda en los tres archivos.
Preguntas que la gente hace sobre esto
- ¿Un enlace simbólico o una importación mantiene los archivos sincronizados?
- Dentro de un repositorio, sí: una línea de importación o un enlace simbólico hace de los archivos uno solo. No llega a herramientas que no leen el repositorio, y no puede decir si una línea sigue vigente.
- ¿Dónde debería vivir una regla que siguen todas las herramientas?
- Fuera de todo archivo de instrucciones, en un solo lugar, donde alguien la ve y la aprueba. En Arroway cada regla lleva quién la aprobó y cuándo termina, y toda herramienta conectada lee la versión vigente antes de actuar, sea la regla sobre el código o sobre el negocio.
- ¿Cómo pruebo Arroway?
- Instálala en la herramienta que ya usas —la página de instalación tiene una ruta para Claude, ChatGPT, Codex, Cursor o cualquier herramienta MCP— e inicia sesión cuando la herramienta lo pida. Desde entonces, las sesiones abren leyendo el proyecto y cierran registrando lo que se decidió.
Dónde se puede comprobar
Documentación de Gemini CLI sobre GEMINI.md y la opción context.fileName (geminicli.com/docs/cli/gemini-md), leída el 6 de octubre de 2026; documentación de memoria de Claude Code, leída el 29 de septiembre de 2026. Cada producto se describe solo como lo describe su documentación en esas fechas. Documentación del producto en este sitio (Cómo funciona, Instalación), las respuestas sobre la misma regla escrita en cuatro prompts y sobre si Claude Code lee AGENTS.md, y las reglas de sanción, sustitución y condición de término de la especificación sancionada del producto. Todo lo que aquí se describe sobre Arroway es comportamiento que las herramientas aplican hoy, no hoja de ruta. El equipo del ejemplo es ilustrativo.
https://www.arroway.app/es/answers/one-team-three-instruction-files-and-they-drift