Copilot Memory vs. instrucciones personalizadas: dónde se guardan las memorias y cómo borrarlas

Los 12 pasos: de la carpeta en tu disco a una plantilla de instrucciones versionada con el código

Una plantilla de instrucciones personalizadas que cubre las seis cosas que Copilot realmente necesita

La propia guía de GitHub recomienda mantener el archivo corto y concreto: cuál es el stack, cómo ejecutar las cosas, dónde vive el código, qué convenciones son obligatorias y qué evitar. Los bloques de abajo están escritos para copiarlos y luego recortarlos: borra cualquier línea que el agente pueda deducir leyendo el repositorio, porque un archivo de instrucciones inflado diluye las reglas que importan. Guárdalo como .github/copilot-instructions.md en la raíz del repositorio.

# .github/copilot-instructions.md

## Project and stack
- Next.js 15 app router, TypeScript strict, Node 22.
- Package manager: pnpm. Never run npm or yarn install.

## Commands
- Build: pnpm build
- Lint: pnpm lint
- Test everything: pnpm test
- Test one file: pnpm test -- path/to/file.test.ts

## Layout
- Routes: src/app/**
- UI components: src/components/**
- Data access: src/lib/db.ts and src/lib/repositories/**
- Tests live next to the file they cover: *.test.ts

## Conventions
- Named exports only; no default exports from src/lib.
- Handle errors at the boundary and return early instead of nesting.
- Import order: node builtins, external packages, then @/ aliases.

## Testing and review
- Every behaviour change ships with a test in the same pull request.
- Run the single-file test before requesting review.
- Commit messages follow Conventional Commits.

## Do not
- Do not edit files under src/generated/**.
- Do not add a dependency without calling it out in the pull request.
- Do not log secrets, tokens or full request bodies.

• 1Proyecto y stack — nombra el framework, el modo de lenguaje y el gestor de paquetes en una sola línea. Este es el bloque que evita que el agente dude entre npm, pnpm y yarn y genere un archivo de bloqueo de dependencias que no pediste.
• 2Comandos — los comandos exactos de build, lint, test y test de un solo archivo, copiados de tu configuración de CI y no de la memoria. Un comando de test equivocado es la línea más cara que puedes omitir.
• 3Estructura — dónde viven las rutas, los componentes, el acceso a datos y los tests. Señala directorios en lugar de describir la arquitectura en prosa; una ruta se puede comprobar, un párrafo no.
• 4Convenciones — nombres, manejo de errores, orden de imports y reglas de formato que tu equipo realmente aplica. Que cada regla sea binaria: o el código la cumple o no la cumple.
• 5Tests y revisión — qué tiene que salir con un test, qué se espera que verifique una revisión y tu convención de commits o de ramas. Este es el bloque que convierte una memoria que necesitarías en una garantía.
• 6No hacer — los antipatrones. Archivos generados, dependencias nuevas sin avisar, refactors que no vienen al caso, secretos en los logs. Las reglas negativas son la forma más barata de evitar toda una clase de pull requests malos.

Acótala con un segundo archivo

Mantén corto el archivo del repositorio moviendo las reglas de cada carpeta a sus propios archivos bajo .github/instructions/. El front matter es lo que hace que esto funcione: applyTo adjunta el archivo automáticamente a las rutas que coinciden, y description permite que el agente lo traiga para la tarea correcta. VS Code documenta name, description y applyTo como los campos admitidos.

---
name: 'React components'
description: 'Use when creating or updating components under src/components.'
applyTo: 'src/components/**/*.tsx'
---

# React components
- One component per file, named after the file.
- Props are typed with an explicit interface; no React.FC.
- Colocate styles with the component; no global class names.

Deja tus propias preferencias fuera del archivo del repositorio

Todo lo que va sobre ti y no sobre el proyecto — la longitud de las respuestas, el tono, cómo quieres que se expliquen los diffs — pertenece a las instrucciones personales. Copilot CLI y el host del agente leen ~/.copilot/copilot-instructions.md; en github.com, abre Copilot Chat, haz clic en tu foto de perfil y elige Personal instructions, donde GitHub también incluye plantillas con marcadores como [format]. Las instrucciones personales tienen prioridad sobre las del repositorio y la organización, así que una preferencia definida ahí no necesita repetirse en cada repositorio.

Dos últimas reglas que aplican a todos los bloques: nunca pongas secretos, tokens ni datos de clientes en un archivo de instrucciones que se confirma en el repositorio, y nunca dejes que las instrucciones del repositorio y una memoria digan cosas distintas — cuando se contradicen, Copilot sigue ambos conjuntos de contexto como puede y el resultado es impredecible. Si una memoria contradice una regla que escribiste una y otra vez, elimina la memoria en lugar de debilitar la regla.