Respuestas
copilot-instructions.md vs CLAUDE.md: ¿necesitas los dos?
Según la documentación de GitHub, Copilot lee .github/copilot-instructions.md para todo el repositorio, archivos .instructions.md específicos de ruta que traen un patrón applyTo, archivos AGENTS.md (el más cercano en el árbol de directorios tiene precedencia) y un único CLAUDE.md o GEMINI.md en la raíz del repositorio como alternativa a AGENTS.md. Así que Copilot puede leer un CLAUDE.md por sí solo; lo que un CLAUDE.md no le da son reglas por ruta, que existen solo en archivos .instructions.md, y la documentación dice que las instrucciones por ruta hoy se admiten en GitHub.com solo para el agente en la nube de Copilot y la revisión de código de Copilot. Cuando un archivo de todo el repositorio y uno de ruta específica coinciden, Copilot usa los dos. Entre instrucciones personales, de repositorio y de organización, se proporcionan todos los conjuntos relevantes, y la documentación aconseja evitar conflictos entre ellos. Ninguno de los dos archivos registra quién decidió una línea ni cuándo deja de valer. En Arroway, los asistentes escriben propuestas, una persona aprueba lo que se vuelve regla, cada regla lleva la condición que la termina, y Copilot, Claude Code, Cursor o cualquier herramienta por MCP lee la versión vigente antes de actuar. El primer paso es la página de instalación.
Última actualización 9 de octubre de 2026
Qué lee cada herramienta
La documentación de GitHub que leí lista los archivos que Copilot toma como instrucciones: .github/copilot-instructions.md para el repositorio, archivos .instructions.md en .github/instructions con un patrón applyTo para rutas específicas, AGENTS.md en cualquier lugar del repositorio y un CLAUDE.md o GEMINI.md en la raíz. Funciones distintas de Copilot leen conjuntos distintos: el agente en la nube y la revisión de código leen los archivos por ruta, y Copilot Chat usa las instrucciones del repositorio cuando el repositorio está adjunto. Leí solo la documentación de GitHub para esta página, así que lo que Claude Code hace con .github/copilot-instructions.md no se describe aquí.
Dónde se detiene
La documentación dice que la revisión de código de Copilot lee las instrucciones de la rama de origen del pull request, no de la rama base, así que una rama que edita el archivo de instrucciones se revisa bajo su propia edición. Dice también que, cuando los conjuntos de instrucciones entran en conflicto, se proporcionan todos y evitar el conflicto te toca a ti; no dice cómo interactúan CLAUDE.md y AGENTS.md cuando existen los dos. Un archivo muestra quién cambió una línea y cuándo. No muestra quién la decidió, si todavía vale o qué reemplazó, y quien trabaja fuera del repositorio no tiene archivo alguno.
Cuándo usar Arroway
Usa Arroway cuando una regla tiene que llegar a Copilot, a Claude Code y a las personas que nunca abren el repositorio, con alguien que responda por ella. Cada regla se registra una vez, por quien responde por ella, con quién la aprobó y la condición que la termina, y todo asistente conectado lee la versión vigente al comenzar una sesión. Cuando la regla cambia, la sustituta nombra la que retira, y la siguiente sesión de todos abre con la nueva. Lo que vale va allí, y los archivos quedan sin nada que merezca quedarse. El primer paso es la página de instalación.
Cómo se ve en la práctica
Un equipo de seis personas usa la revisión de código de Copilot en sus pull requests y Claude Code para buena parte de la escritura. En junio, quien lidera lo técnico añade una línea a .github/copilot-instructions.md: todo endpoint nuevo necesita una prueba de integración. Un desarrollador añade una línea parecida a CLAUDE.md, con otras palabras. En septiembre, un desarrollador abre un pull request que relaja la línea de copilot-instructions.md para un servicio. Copilot revisa ese pull request usando la rama de origen, así que revisa el cambio bajo la regla que el propio cambio reescribió, mientras Claude Code, en la siguiente sesión, todavía lee la redacción de junio. Nadie sabe decir cuál versión quería el equipo, ni quién tenía autoridad para relajarla. En Arroway, la regla se registra una vez con el nombre de quien lidera lo técnico; la excepción de septiembre es una propuesta hasta que esa persona la aprueba como reemplazo, con su propia condición de término. Copilot y Claude Code abren su siguiente sesión con la regla vigente, y el historial muestra la antigua, cuándo cambió y quién la cambió. El equipo de este ejemplo es ilustrativo.
Preguntas que la gente hace sobre esto
- ¿Copilot lee CLAUDE.md?
- Según la documentación de GitHub, sí: un único CLAUDE.md o GEMINI.md en la raíz del repositorio se lee como alternativa a AGENTS.md. Las reglas por ruta necesitan archivos .instructions.md.
- ¿Dónde debe vivir una regla que siguen las dos herramientas?
- Fuera de los dos archivos, en un solo lugar donde alguien la vea y la apruebe. En Arroway la regla se registra una vez, con quién la aprobó y la condición que la termina, y las dos herramientas la leen antes de actuar.
- ¿Cómo pruebo Arroway?
- Instálalo 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 GitHub sobre cómo añadir instrucciones personalizadas de repositorio para Copilot (docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions), leída el 9 de octubre de 2026 — Copilot se describe solo como esa documentación lo describe en esa fecha, y puede cambiar en cualquier versión. Documentación del producto en este sitio (Cómo funciona, Instalación), las respuestas sobre reglas de Cursor y CLAUDE.md en el mismo equipo y sobre mantener tres archivos de instrucciones en sincronía, y las reglas de sanción, sustitución y condición de término de la especificación sancionada del producto. Todo lo que se describe aquí 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/copilot-instructions-and-claude-md-in-the-same-repo