раздел 09

Шпаргалка

Все системные документы агента коротко и в одном месте.

Таблица файлов

Файл	Где лежит	Назначение	Область
`AGENTS.md`, `CLAUDE.md`	корень проекта / домашняя папка	инструкция проекта: команды, стек, стиль, ограничения	глобально или проект
`SKILL.md` (навыки)	папка навыков	переиспользуемая способность, подключается по описанию	глобально или проект
правила (`.cursor/rules/*.mdc`)	папка правил проекта	точечные условные подсказки по областям кода	проект или папка
`memory.md`, `MEMORY.md`	папка памяти агента	устойчивые факты, решения, фидбэк между сессиями	глобально или проект
слэш-команды (`.claude/commands/*.md`)	папка команд	заготовленные промпты и процедуры, вызов как `/имя`	глобально или проект
субагенты (`.claude/agents/*.md`)	папка субагентов	помощники с узкой ролью	глобально или проект
`.mcp.json`	корень проекта	подключение внешних инструментов через MCP	проект
`settings.json`	настройки агента	права, модель, переменные окружения	глобально или проект
хуки (в `settings.json`)	настройки агента	скрипты на события: автоматизация, не контекст	глобально или проект

Контекст против автоматизации

Держи в голове главное деление из первой главы.

Контекст-документы

AGENTS.md / CLAUDE.md, навыки, правила, память. Агент читает как знание и учитывает. Может следовать, может гибко отступить под задачу.

Автоматизация (хуки)

Скрипты на события. Система выполняет их всегда и одинаково. Не текст для чтения, а гарантированное действие по триггеру.

Чек-лист старта проекта

Завести AGENTS.md (или CLAUDE.md): стек, команды сборки и тестов, стиль, ограничения, критерии готовности.
Настроить права в settings.json: наименьшие привилегии, явные deny на удаление, sudo и чтение секретов.
Секреты - в .env, не в память и не в инструкции.
Вынести повторяемые процессы в слэш-команды (ревью, релиз, прогон проверок).
Точечные требования по областям кода - в правила.
Регулярную работу с граблями - в навыки с чётким описанием-триггером.
Гарантированные действия (форматтер, проверка на секреты) - в хуки, а не в текст инструкции.
Заметки, решения и фидбэк по ходу - складывать в память.

Глоссарий

AGENTS.md / CLAUDE.md - главный файл инструкций проекта, который агент читает всегда.
Навык (skill) - переиспользуемая способность под задачу; агент сам подключает её по описанию.
Правило (rule) - точечная подсказка, включается по области кода или типу файла.
Память (memory) - устойчивые факты между сессиями: решения, договорённости, фидбэк.
Слэш-команда - заготовленный промпт или процедура, вызывается тобой как /имя.
Субагент - помощник с узкой ролью, которого зовёт главный агент.
MCP - стандарт подключения внешних инструментов и данных к агенту.
settings.json - настройки поведения: права, модель, переменные окружения.
Хук (hook) - скрипт на событие; автоматизация, которая выполняется системой всегда.
Идемпотентность - свойство действия, при котором повторный запуск не портит результат.
Контекст - всё, что агент читает как знание и учитывает при работе.

Куда дальше

AGENTS.md и CLAUDE.md - главный файл инструкций.
Skills для AI-агентов - переиспользуемые навыки.
Память агента - как вести долгую память.
Стартовый набор агента - что положить в проект в начале.