Copilot Memory и пользовательские инструкции: где хранится память и как её удалить

Все 12 шагов: от папки на диске до шаблона инструкций, закоммиченного в репозиторий

Шаблон пользовательских инструкций, который закрывает шесть вещей, реально нужных Copilot

GitHub рекомендует держать файл коротким и конкретным: какой стек, как всё запускать, где лежит код, какие соглашения обязательны и чего избегать. Блоки ниже написаны так, чтобы их скопировать и затем сократить: удаляйте любую строку, которую агент может вывести сам, прочитав репозиторий, потому что раздутый файл инструкций размывает правила, которые действительно важны. Сохраните его как .github/copilot-instructions.md в корне репозитория.

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

• 1Проект и стек — назовите фреймворк, режим языка и пакетный менеджер одной строкой. Именно этот блок мешает агенту гадать между npm, pnpm и yarn и генерировать lockfile, о котором вы не просили.
• 2Команды — точные команды сборки, линтера, тестов и теста одного файла, скопированные из конфигурации CI, а не по памяти. Неверная команда тестов — самая дорогая строка, которую можно не указать.
• 3Структура — где лежат маршруты, компоненты, доступ к данным и тесты. Указывайте каталоги, а не описывайте архитектуру прозой: путь можно проверить, абзац — нет.
• 4Соглашения — именование, обработка ошибок, порядок импортов и правила форматирования, которые команда действительно соблюдает. Держите каждое правило бинарным: код либо следует ему, либо нет.
• 5Тесты и ревью — что обязано выходить вместе с тестом, что должен проверить ревьюер и какие у вас соглашения о коммитах и ветках. Это блок, который превращает запись памяти, иначе необходимую, в гарантию.
• 6Чего не делать — антипаттерны. Сгенерированные файлы, новые зависимости без упоминания, посторонние рефакторинги, секреты в логах. Запреты — самый дешёвый способ предотвратить появление целого класса плохих pull request.

Сузьте область вторым файлом

Держите файл репозитория коротким, вынося правила для отдельных папок в свои файлы в .github/instructions/. Работает всё благодаря front matter: applyTo прикрепляет файл к подходящим путям автоматически, а description позволяет агенту подтянуть его под нужную задачу. VS Code документирует name, description и applyTo как поддерживаемые поля.

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

Держите личные предпочтения вне файла репозитория

Всё, что касается вас, а не проекта — длина ответов, тон, то, как вы хотите видеть объяснение диффов, — место в личных инструкциях. Copilot CLI и хост агента читают ~/.copilot/copilot-instructions.md; на github.com откройте Copilot Chat, нажмите фото профиля и выберите Personal instructions — там GitHub ещё и поставляет шаблоны с плейсхолдерами вроде [format]. Личные инструкции приоритетнее инструкций репозитория и организации, поэтому предпочтение, заданное там, не нужно повторять в каждом репозитории.

Два последних правила, которые касаются каждого блока: никогда не кладите секреты, токены или данные клиентов в закоммиченный файл инструкций и не позволяйте инструкциям репозитория и записи памяти говорить разное — при конфликте Copilot следует обоим наборам контекста, как умеет, и результат непредсказуем. Если запись памяти снова и снова противоречит написанному вами правилу, удалите запись, а не ослабляйте правило.