Инструкции

Файл AGENTS.md даёт ZubrCode постоянные указания по проекту: команды сборки, заметки об архитектуре, соглашения по коду и требования к проверкам.

# Project instructions

- Run `bun typecheck` after changing TypeScript.
- Keep database queries in `src/database`.
- Do not edit generated files directly.

Коммитьте файлы инструкций, чтобы у всех в репозитории были одни правила. Команда /init создаёт AGENTS.md по содержимому репозитория.

Область действия

Кладите AGENTS.md в каталог, к которому относятся правила. ZubrCode загружает глобальный файл и затем каждый AGENTS.md от рабочей папки к домашнему каталогу; для проектов вне домашнего каталога — до корня проекта.

~/.config/zubrcode/AGENTS.md
~/code/my-project/AGENTS.md
~/code/my-project/packages/AGENTS.md
~/code/my-project/packages/web/AGENTS.md  ← текущая рабочая папка

Здесь загрузятся все четыре файла: глобальный, затем packages/web/AGENTS.md, packages/AGENTS.md и AGENTS.md корня. Общее держите в глобальном файле, правила всего репозитория — в его корне, узкие — ближе к коду. Файлы складываются вместе; конфликты между ними не разрешаются автоматически.

Если рабочая папка вне корня проекта, загружается только глобальный файл. Переменная OPENCODE_DISABLE_PROJECT_CONFIG=1 отключает поиск проектных AGENTS.md, не трогая глобальный.

Подхват вложенных файлов

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

Порядок сборки

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

1. Системный промпт агента или провайдера
2. Подсказки инструментов Code Mode (если включён)
3. Указания MCP-серверов, ссылок и навыков
4. Глобальные и проектные AGENTS.md, затем настроенные instructions
5. Встроенный контекст даты и окружения
6. Инструкции конкретной сессии, переданные через API

Источники складываются, а не перекрывают друг друга. Вложенные AGENTS.md, найденные позже, добавляются в историю сессии по мере находки.

Обновления

Правка глобального или подхваченного AGENTS.md во время сессии обновляет правила: перед следующим запросом модели ZubrCode заметит изменение и добавит уведомление об обновлении инструкций. Временная ошибка чтения сохраняет последние известные правила вместо их удаления.

Настроенные инструкции

Массив instructions добавляет файлы, glob-шаблоны и HTTP(S)-адреса рядом с найденными AGENTS.md:

{
  "instructions": [
    "CONTRIBUTING.md",
    "docs/guidelines/*.md",
    "~/rules/common.md",
    "https://example.com/instructions.md"
  ]
}

Они загружаются после AGENTS.md в указанном порядке.

Запись	Как разрешается
Относительный путь или glob	ищется в каждом каталоге от рабочей папки до корня проекта
Путь `~/`	от домашнего каталога
Абсолютный путь	как есть; имя файла может быть glob-шаблоном
`http://` или `https://`	загружается при чтении конфигурации, таймаут 5 секунд

Локальные файлы обновляются так же, как AGENTS.md. Отсутствующие файлы пропускаются; недоступный URL пропускается или сохраняет последнее загруженное содержимое.

Конфигурацию и порядок приоритета см. на странице Конфигурация.