раздел 01

Полезные инструкции в AGENTS.md / CLAUDE.md

Файл инструкций - это первое, что читает агент. Сюда кладут то, что иначе пришлось бы повторять в каждом чате. Не пишите туда всё подряд: чем короче и конкретнее, тем лучше агент это держит в голове.

Что реально полезно положить

Команды проекта

Как запустить дев-сервер, собрать, прогнать тесты и линт. Самое ценное - агент перестаёт угадывать.

Стек и стиль

Язык, фреймворк, версии, конвенции именования и форматирования. Чтобы код вписывался в проект.

Definition of done

Что прогнать перед тем, как считать задачу готовой: линт, типы, тесты, сборка.

Ограничения

Секреты только в .env, что не трогать, какие папки и файлы генерируемые.

Язык общения

На каком языке отвечать и в каком тоне. Код и комментарии - отдельно.

Коммиты

Формат сообщений, ветки, что коммитить, а что нет.

Готовый блок-шаблон

Вставьте в AGENTS.md (или CLAUDE.md) в корне проекта и адаптируйте под себя:

# Проект

## Команды
- Запуск дев-сервера: npm run dev
- Сборка: npm run build
- Тесты: npm test
- Линт: npm run lint

## Стек и стиль
- Next.js 16 + TypeScript + Tailwind
- Именование переменных - на английском, camelCase
- Без any, строгая типизация

## Definition of done
Перед тем как считать задачу готовой - прогони:
- npm run lint
- npm run build
Без ошибок - тогда готово.

## Ограничения
- Секреты только в .env, в код не вписывать
- Не трогать папку /generated - она собирается автоматически

## Общение
- Отвечать на русском, кратко, по делу

## Коммиты
- Сообщения на английском, в формате: type: краткое описание
- Не коммитить .env и node_modules

Где искать готовое

На GitHub есть awesome-листинги с примерами AGENTS.md и CLAUDE.md - можно подсмотреть структуру под свой стек.
В Claude Code команда /init генерирует черновик CLAUDE.md, просканировав проект. Дальше его правят руками.
В других редакторах есть аналогичные команды инициализации - смотрите документацию своего инструмента.