AGENTS.md: инструкция для ИИ-помощника

AGENTS.md — это обычный текстовый файл в корне вашей базы знаний. В нём написано, как ИИ должен с этой базой работать. Аналогия простая: AGENTS.md — это инструкция для помощника, как пользоваться памятью.

Зачем он нужен

Без инструкции каждый сеанс работы с ИИ — импровизация: сегодня он назвал страницу так, завтра иначе; сегодня сложил файл в одну папку, завтра в другую. Через месяц структура расползается, и вы снова в хаосе.

Правила записаны один раз — и выполняются каждый раз. Этот файл превращает нейросеть из «умного собеседника» в дисциплинированного хранителя базы.

У разных инструментов файл может называться по-разному (AGENTS.md, CLAUDE.md) — суть одна.

Что в нём писать

Хороший AGENTS.md отвечает на пять вопросов:

  1. Что это за база? Одно-два предложения: чья память, о чём, для чего.
  2. Как устроена структура? Какие папки есть и что в них лежит.
  3. Как добавлять новое? Куда класть исходники, как обновлять страницы, когда трогать оглавление.
  4. Как оформлять страницы? Стиль, обязательные элементы, ссылки на источники.
  5. Чего не делать? Не редактировать исходники, не удалять без пометки, не выдумывать факты.

Пример для копирования

# AGENTS.md — память компании «Пример»

Это цифровая память компании: клиенты, проекты, решения, правила.

## Структура
- raw/ — исходники. НЕ редактировать. Только добавлять.
- wiki/ — страницы знаний. Их ведёшь ты.
- index.md — оглавление. Обновляй при добавлении страниц.
- log.md — журнал. Записывай каждое добавление и изменение.

## Правила добавления
1. Новый документ → в raw/ с датой в имени: 2026-07-02-название.md
2. Прочитай документ, обнови связанные страницы в wiki/.
3. Если темы ещё нет — создай страницу и добавь её в index.md.
4. Запиши в log.md: дата, что добавлено, какие страницы обновлены.

## Правила оформления страниц
- Один файл — одна тема (клиент, проект, правило).
- В конце страницы — раздел «Источники» со ссылками на raw/.
- Устаревшее не удаляй: помечай «УСТАРЕЛО, см. …».

## Запрещено
- Выдумывать факты, которых нет в источниках.
- Редактировать файлы в raw/.
- Удалять страницы без пометки и записи в log.md.

Частые ошибки

Куда дальше