Урок 6 из 8 · 20 мин · обновлено

AGENTS.md: правила проекта для агента

Что такое файл AGENTS.md, как создать его командой /init в OpenCode и что в него писать: описание проекта, команды проверки, правила кода и запреты. Общие правила для всех проектов и как улучшать файл по ошибкам агента.

Память агента о проекте

Каждая новая сессия для агента начинается с чистого листа: он не помнит, что вы объясняли вчера. Если в прошлый раз вы договорились «без библиотек» и «всё в одном файле», сегодня агент об этом не знает.

Решение — файл AGENTS.md в корне проекта. OpenCode читает его в начале каждой сессии, как инструкцию для нового сотрудника. Всё, что агент должен знать всегда, пишут туда.

Название AGENTS.md понимают и другие агенты для кода, поэтому файл пригодится, даже если вы смените инструмент.

Первая версия через /init

Введите в OpenCode:

Текст
/init

Агент изучит файлы проекта и создаст AGENTS.md с описанием: что это за проект, из каких файлов состоит, как его запускать. Для трекера получится примерно так:

Markdown
# Трекер привычек

Одностраничное приложение: index.html со стилями
и скриптом внутри. Данные хранятся в localStorage.

## Как проверить
Открыть index.html в браузере, отметить привычку,
обновить страницу — отметка должна остаться.

Это хорошее начало, но правила лучше дописать самому — агент не знает ваших договорённостей.

Что писать в AGENTS.md

Четыре раздела покрывают большинство проектов:

  1. Что за проект — одна-две фразы о цели и устройстве.
  2. Как проверить — команды для тестов и сборки, если они есть, или сценарий ручной проверки.
  3. Правила кода — язык, стиль, на чём проект написан.
  4. Запреты — чего агенту делать нельзя.

Пример для трекера:

Markdown
## Правила
- Всё в одном файле index.html, без библиотек и сборки.
- Тексты интерфейса — на русском.
- Данные только в localStorage, без сервера.
- Не меняй структуру сохранённых данных без вопроса:
  у пользователей уже есть отметки.

## После правок
- Проверь, что в консоли браузера нет ошибок.
- Кратко перечисли, что изменил.

Пишите коротко и конкретно. Правило «пиши хороший код» агент не знает, как применить. Правило «без библиотек» — знает и может выполнить.

Улучшать по ошибкам

Хороший AGENTS.md пишется не за раз. Каждый раз, когда агент повторяет ошибку, — например, снова подключает библиотеку для анимации, — добавьте правило. Можно попросить самого агента:

Текст
Добавь в AGENTS.md правило: не подключать сторонние
библиотеки, даже для анимаций.

Общие правила для всех ваших проектов, например «отвечай на русском», можно записать в глобальный файл ~/.config/opencode/AGENTS.md. Его OpenCode читает в любой папке.

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

Попробуйте сами. Запустите /init в папке трекера и прочитайте созданный AGENTS.md. Допишите раздел «Правила» — три-пять своих правил. Затем начните новую сессию командой /new и попросите: «Добавь анимацию при отметке галочки». Посмотрите, учёл ли агент правила.

Чего ожидать

Если в правилах есть «без библиотек», агент сделает анимацию на чистом CSS: например, плавное изменение цвета или короткое увеличение галочки. Без этого правила некоторые модели подключили бы библиотеку анимаций ради одного эффекта.

Если агент правило проигнорировал, проверьте формулировку: она должна быть короткой и однозначной. Можно прямо спросить агента: «Какие правила из AGENTS.md ты учёл?» — ответ покажет, видит ли он файл.

Мини-тест: проверьте себя

Закрепите урок: несколько вопросов, разбор ответов — в конце.

  1. Зачем нужен файл AGENTS.md?

  2. Какое правило в AGENTS.md полезнее?

  3. Что делает команда /init?