Copilot Memory vs. instruções personalizadas: onde ficam as memórias e como excluí-las

Os 12 passos: da pasta no disco ao template de instruções versionado no repositório

Um template de instruções personalizadas que cobre as seis coisas de que o Copilot realmente precisa

A orientação do próprio GitHub é manter o arquivo curto e específico: qual é a stack, como rodar as coisas, onde o código vive, quais convenções são obrigatórias e o que evitar. Os blocos abaixo foram escritos para serem copiados e depois enxugados — exclua qualquer linha que o agente poderia descobrir lendo o repositório, porque um arquivo de instruções inchado dilui as regras que importam. Salve como .github/copilot-instructions.md na raiz do repositório.

# .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.

• 1Projeto e stack — nomeie o framework, o modo de linguagem e o gerenciador de pacotes em uma linha. É o bloco que impede o agente de ficar na dúvida entre npm, pnpm e yarn e de gerar um lockfile que você não pediu.
• 2Comandos — os comandos exatos de build, lint, teste e teste de um único arquivo, copiados da sua configuração de CI em vez de memória. Um comando de teste errado é a linha mais cara que você pode deixar de fora.
• 3Estrutura — onde ficam rotas, componentes, acesso a dados e testes. Aponte diretórios em vez de descrever a arquitetura em prosa; um caminho é verificável, um parágrafo não.
• 4Convenções — nomenclatura, tratamento de erros, ordem de imports e regras de formatação que o seu time realmente cobra. Mantenha cada regra binária: ou o código segue, ou não segue.
• 5Testes e revisão — o que precisa vir acompanhado de teste, o que uma revisão deve verificar e a sua convenção de commit ou branch. É o bloco que transforma uma memória que você precisaria em garantia.
• 6Não faça — os antipadrões. Arquivos gerados, dependências novas sem aviso, refatorações fora do escopo, segredos em logs. Regras negativas são o jeito mais barato de evitar uma classe inteira de pull requests ruins.

Reduza o escopo com um segundo arquivo

Mantenha o arquivo do repositório curto movendo regras específicas de pasta para arquivos próprios em .github/instructions/. O front matter é o que faz isso funcionar: applyTo anexa o arquivo automaticamente aos caminhos correspondentes e description permite que o agente o puxe para a tarefa certa. O VS Code documenta name, description e applyTo como os campos aceitos.

---
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.

Deixe suas preferências fora do arquivo do repositório

Tudo o que é sobre você e não sobre o projeto — tamanho da resposta, tom, o jeito como você quer que os diffs sejam explicados — pertence às instruções pessoais. O Copilot CLI e o host de agentes leem ~/.copilot/copilot-instructions.md; no github.com, abra o Copilot Chat, clique na sua foto de perfil e escolha Personal instructions, onde o GitHub também oferece templates com placeholders como [format]. As instruções pessoais têm prioridade sobre as instruções de repositório e de organização, então uma preferência definida ali não precisa ser repetida em cada repositório.

Duas últimas regras que valem para todos os blocos: nunca coloque segredos, tokens ou dados de clientes em um arquivo de instruções versionado, e nunca deixe as instruções do repositório e uma memória dizerem coisas diferentes — quando elas entram em conflito, o Copilot segue os dois conjuntos de contexto como consegue e o resultado é imprevisível. Se uma memória insiste em contradizer uma regra que você escreveu, exclua a memória em vez de enfraquecer a regra.