AI-кодинг · агенты

Системные документы
агентного подхода

У любого AI-агента - Claude Code, Cursor, Codex - поведение задают не только твои сообщения, но и набор системных файлов в проекте и в домашней папке. Инструкции, навыки, правила, память, команды, настройки прав и хуки. Этот мануал разбирает каждый файл: что это, зачем агент его читает и как написать так, чтобы агент делал то, что нужно, а не что попало.

Начать с начала →Сразу к шпаргалке

для кого этот мануал

Вайб-кодишь с агентом

Пишешь код через Claude Code или агента в IDE и хочешь, чтобы агент знал твой проект и не переспрашивал одно и то же.

Настраиваешь агента под команду

Заводишь общие правила, навыки и права, чтобы вся команда работала с агентом одинаково и предсказуемо.

Путаешься в файлах

Не понимаешь, чем skills отличаются от rules, а память от хуков, и куда что писать. Нужна ясная карта.

главы мануала

Что это и зачем

Какие бывают системные документы агента и зачем он их читает. Иерархия загрузки: глобальные, проектные, вложенные. Главное разграничение - контекст-документы против автоматизации.

AGENTS.md и CLAUDE.md

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

Skills (SKILL.md)

Переиспользуемый навык агента. Ключевое - точное описание, когда его применять: по нему агент сам решает подключить навык. Узкий навык с чётким триггером против навыка-на-всё.

Rules (правила)

Точечные условные правила: Cursor rules и аналоги, привязка к типам файлов и областям кода. Чем правила отличаются от AGENTS.md / CLAUDE.md - они точечные и срабатывают по условию.

Memory (memory.md, MEMORY.md)

Долгая память агента: устойчивые факты между сессиями, решения, фидбэк и индекс к ним. Что складывать в память, а что туда никогда не должно попасть.

Слэш-команды

Переиспользуемые промпты и процедуры, которые вызываются как одна команда. Частый повторяемый процесс превращается в команду; разовую задачу в команду выносить не нужно.

Субагенты и MCP-конфиг

Определения субагентов с узкой ролью и подключение внешних инструментов через MCP. Что это такое, зачем нужно и как не превратить в свалку недоверенных серверов.

settings.json: права, модель, env

Разрешения allow, deny и ask, выбор модели и переменные окружения. Наименьшие привилегии и явные запреты на опасное против режима разрешить всё подряд.

Хуки: автоматизация, не контекст

Детерминированные скрипты на события: перед и после инструмента, на остановке. Это не документ-контекст, а автоматизация. Быстрый идемпотентный хук против тяжёлого и ломающего поток.

Шпаргалка

Все системные файлы одной таблицей: где лежит, зачем и на какую область влияет. Плюс чек-лист старта проекта и короткий глоссарий.